mcc.h File Reference

Bluetooth Media Control Client (MCC) APIs. More...

#include <stdint.h>
#include <stdbool.h>
#include <zephyr/bluetooth/conn.h>
#include <zephyr/net_buf.h>
#include <zephyr/bluetooth/audio/media_proxy.h>

Go to the source code of this file.

Data Structures
struct	bt_mcc_cb
	Media control client callbacks. More...

Typedefs
typedef void(*	bt_mcc_discover_mcs_cb) (struct bt_conn *conn, int err)
	Callback function for bt_mcc_discover_mcs()
typedef void(*	bt_mcc_read_player_name_cb) (struct bt_conn *conn, int err, const char *name)
	Callback function for bt_mcc_read_player_name()
typedef void(*	bt_mcc_read_icon_obj_id_cb) (struct bt_conn *conn, int err, uint64_t icon_id)
	Callback function for bt_mcc_read_icon_obj_id()
typedef void(*	bt_mcc_read_icon_url_cb) (struct bt_conn *conn, int err, const char *icon_url)
	Callback function for bt_mcc_read_icon_url()
typedef void(*	bt_mcc_track_changed_ntf_cb) (struct bt_conn *conn, int err)
	Callback function for track changed notifications.
typedef void(*	bt_mcc_read_track_title_cb) (struct bt_conn *conn, int err, const char *title)
	Callback function for bt_mcc_read_track_title()
typedef void(*	bt_mcc_read_track_duration_cb) (struct bt_conn *conn, int err, int32_t dur)
	Callback function for bt_mcc_read_track_duration()
typedef void(*	bt_mcc_read_track_position_cb) (struct bt_conn *conn, int err, int32_t pos)
	Callback function for bt_mcc_read_track_position()
typedef void(*	bt_mcc_set_track_position_cb) (struct bt_conn *conn, int err, int32_t pos)
	Callback function for bt_mcc_set_track_position()
typedef void(*	bt_mcc_read_playback_speed_cb) (struct bt_conn *conn, int err, int8_t speed)
	Callback function for bt_mcc_read_playback_speed()
typedef void(*	bt_mcc_set_playback_speed_cb) (struct bt_conn *conn, int err, int8_t speed)
	Callback function for bt_mcc_set_playback_speed()
typedef void(*	bt_mcc_read_seeking_speed_cb) (struct bt_conn *conn, int err, int8_t speed)
	Callback function for bt_mcc_read_seeking_speed()
typedef void(*	bt_mcc_read_segments_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_read_segments_obj_id()
typedef void(*	bt_mcc_read_current_track_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_read_current_track_obj_id()
typedef void(*	bt_mcc_set_current_track_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_set_current_track_obj_id()
typedef void(*	bt_mcc_read_next_track_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_read_next_track_obj_id_obj()
typedef void(*	bt_mcc_set_next_track_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_set_next_track_obj_id()
typedef void(*	bt_mcc_read_parent_group_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_read_parent_group_obj_id()
typedef void(*	bt_mcc_read_current_group_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_read_current_group_obj_id()
typedef void(*	bt_mcc_set_current_group_obj_id_cb) (struct bt_conn *conn, int err, uint64_t obj_id)
	Callback function for bt_mcc_set_current_group_obj_id()
typedef void(*	bt_mcc_read_playing_order_cb) (struct bt_conn *conn, int err, uint8_t order)
	Callback function for bt_mcc_read_playing_order()
typedef void(*	bt_mcc_set_playing_order_cb) (struct bt_conn *conn, int err, uint8_t order)
	Callback function for bt_mcc_set_playing_order()
typedef void(*	bt_mcc_read_playing_orders_supported_cb) (struct bt_conn *conn, int err, uint16_t orders)
	Callback function for bt_mcc_read_playing_orders_supported()
typedef void(*	bt_mcc_read_media_state_cb) (struct bt_conn *conn, int err, uint8_t state)
	Callback function for bt_mcc_read_media_state()
typedef void(*	bt_mcc_send_cmd_cb) (struct bt_conn *conn, int err, const struct mpl_cmd *cmd)
	Callback function for bt_mcc_send_cmd()
typedef void(*	bt_mcc_cmd_ntf_cb) (struct bt_conn *conn, int err, const struct mpl_cmd_ntf *ntf)
	Callback function for command notifications.
typedef void(*	bt_mcc_read_opcodes_supported_cb) (struct bt_conn *conn, int err, uint32_t opcodes)
	Callback function for bt_mcc_read_opcodes_supported()
typedef void(*	bt_mcc_send_search_cb) (struct bt_conn *conn, int err, const struct mpl_search *search)
	Callback function for bt_mcc_send_search()
typedef void(*	bt_mcc_search_ntf_cb) (struct bt_conn *conn, int err, uint8_t result_code)
	Callback function for search notifications.
typedef void(*	bt_mcc_read_search_results_obj_id_cb) (struct bt_conn *conn, int err, uint64_t id)
	Callback function for bt_mcc_read_search_results_obj_id()
typedef void(*	bt_mcc_read_content_control_id_cb) (struct bt_conn *conn, int err, uint8_t ccid)
	Callback function for bt_mcc_read_content_control_id()
typedef void(*	bt_mcc_otc_obj_selected_cb) (struct bt_conn *conn, int err)
	Callback function for object selected.
typedef void(*	bt_mcc_otc_obj_metadata_cb) (struct bt_conn *conn, int err)
	Callback function for bt_mcc_otc_read_object_metadata()
typedef void(*	bt_mcc_otc_read_icon_object_cb) (struct bt_conn *conn, int err, struct net_buf_simple *buf)
	Callback function for bt_mcc_otc_read_icon_object()
typedef void(*	bt_mcc_otc_read_track_segments_object_cb) (struct bt_conn *conn, int err, struct net_buf_simple *buf)
	Callback function for bt_mcc_otc_read_track_segments_object()
typedef void(*	bt_mcc_otc_read_current_track_object_cb) (struct bt_conn *conn, int err, struct net_buf_simple *buf)
	Callback function for bt_mcc_otc_read_current_track_object()
typedef void(*	bt_mcc_otc_read_next_track_object_cb) (struct bt_conn *conn, int err, struct net_buf_simple *buf)
	Callback function for bt_mcc_otc_read_next_track_object()
typedef void(*	bt_mcc_otc_read_parent_group_object_cb) (struct bt_conn *conn, int err, struct net_buf_simple *buf)
	Callback function for bt_mcc_otc_read_parent_group_object()
typedef void(*	bt_mcc_otc_read_current_group_object_cb) (struct bt_conn *conn, int err, struct net_buf_simple *buf)
	Callback function for bt_mcc_otc_read_current_group_object()

Functions
int	bt_mcc_init (struct bt_mcc_cb *cb)
	Initialize Media Control Client.
int	bt_mcc_discover_mcs (struct bt_conn *conn, bool subscribe)
	Discover Media Control Service.
int	bt_mcc_read_player_name (struct bt_conn *conn)
	Read Media Player Name.
int	bt_mcc_read_icon_obj_id (struct bt_conn *conn)
	Read Icon Object ID.
int	bt_mcc_read_icon_url (struct bt_conn *conn)
	Read Icon Object URL.
int	bt_mcc_read_track_title (struct bt_conn *conn)
	Read Track Title.
int	bt_mcc_read_track_duration (struct bt_conn *conn)
	Read Track Duration.
int	bt_mcc_read_track_position (struct bt_conn *conn)
	Read Track Position.
int	bt_mcc_set_track_position (struct bt_conn *conn, int32_t pos)
	Set Track position.
int	bt_mcc_read_playback_speed (struct bt_conn *conn)
	Read Playback speed.
int	bt_mcc_set_playback_speed (struct bt_conn *conn, int8_t speed)
	Set Playback Speed.
int	bt_mcc_read_seeking_speed (struct bt_conn *conn)
	Read Seeking speed.
int	bt_mcc_read_segments_obj_id (struct bt_conn *conn)
	Read Track Segments Object ID.
int	bt_mcc_read_current_track_obj_id (struct bt_conn *conn)
	Read Current Track Object ID.
int	bt_mcc_set_current_track_obj_id (struct bt_conn *conn, uint64_t id)
	Set Current Track Object ID.
int	bt_mcc_read_next_track_obj_id (struct bt_conn *conn)
	Read Next Track Object ID.
int	bt_mcc_set_next_track_obj_id (struct bt_conn *conn, uint64_t id)
	Set Next Track Object ID.
int	bt_mcc_read_current_group_obj_id (struct bt_conn *conn)
	Read Current Group Object ID.
int	bt_mcc_set_current_group_obj_id (struct bt_conn *conn, uint64_t id)
	Set Current Group Object ID.
int	bt_mcc_read_parent_group_obj_id (struct bt_conn *conn)
	Read Parent Group Object ID.
int	bt_mcc_read_playing_order (struct bt_conn *conn)
	Read Playing Order.
int	bt_mcc_set_playing_order (struct bt_conn *conn, uint8_t order)
	Set Playing Order.
int	bt_mcc_read_playing_orders_supported (struct bt_conn *conn)
	Read Playing Orders Supported.
int	bt_mcc_read_media_state (struct bt_conn *conn)
	Read Media State.
int	bt_mcc_send_cmd (struct bt_conn *conn, const struct mpl_cmd *cmd)
	Send a command.
int	bt_mcc_read_opcodes_supported (struct bt_conn *conn)
	Read Opcodes Supported.
int	bt_mcc_send_search (struct bt_conn *conn, const struct mpl_search *search)
	Send a Search command.
int	bt_mcc_read_search_results_obj_id (struct bt_conn *conn)
	Search Results Group Object ID.
int	bt_mcc_read_content_control_id (struct bt_conn *conn)
	Read Content Control ID.
int	bt_mcc_otc_read_object_metadata (struct bt_conn *conn)
	Read the current object metadata.
int	bt_mcc_otc_read_icon_object (struct bt_conn *conn)
	Read the Icon Object.
int	bt_mcc_otc_read_track_segments_object (struct bt_conn *conn)
	Read the Track Segments Object.
int	bt_mcc_otc_read_current_track_object (struct bt_conn *conn)
	Read the Current Track Object.
int	bt_mcc_otc_read_next_track_object (struct bt_conn *conn)
	Read the Next Track Object.
int	bt_mcc_otc_read_current_group_object (struct bt_conn *conn)
	Read the Current Group Object.
int	bt_mcc_otc_read_parent_group_object (struct bt_conn *conn)
	Read the Parent Group Object.
struct bt_ots_client *	bt_mcc_otc_inst (struct bt_conn *conn)
	Look up MCC OTC instance.

Detailed Description

Bluetooth Media Control Client (MCC) APIs.