AVRCP Cover Art Client API
#include "src/classic/avrcp_cover_art_client.h"
avrcp_cover_art_client_init
void avrcp_cover_art_client_init(void);
Set up AVRCP Cover Art client
avrcp_cover_art_client_connect
uint8_t avrcp_cover_art_client_connect(avrcp_cover_art_client_t *cover_art_client, btstack_packet_handler_t packet_handler,
bd_addr_t remote_addr, uint8_t *ertm_buffer, uint32_t ertm_buffer_size,
const l2cap_ertm_config_t *ertm_config, uint16_t *avrcp_cover_art_cid);
Connect to AVRCP Cover Art service on a remote device, emits AVRCP_SUBEVENT_COVER_ART_CONNECTION_ESTABLISHED with status
Parameters
- cover_art_client: non-NULL caller-provided connection storage
- packet_handler: non-NULL callback for connection and operation events
- remote_addr: non-NULL remote Bluetooth address
- ertm_buffer: non-NULL ERTM storage, retained for the connection lifetime
- ertm_buffer_size: nonzero ERTM storage size
- ertm_config: non-NULL ERTM configuration, retained for the connection lifetime
- avrcp_cover_art_cid: outgoing parameter, valid if status == ERROR_CODE_SUCCESS
Returns
- uint8_t: status
avrcp_cover_art_client_get_linked_thumbnail
uint8_t avrcp_cover_art_client_get_linked_thumbnail(uint16_t avrcp_cover_art_cid, const char * image_handle);
Request cover art thumbnail for cover with a given image handle retrieved via - avrcp_controller_get_now_playing_info or - avrcp_controller_get_element_attributes(... AVRCP_MEDIA_ATTR_DEFAULT_COVER_ART ...)
Parameters
- avrcp_cover_art_cid
- image_handle: non-NULL image-handle string of exactly 7 characters, retained until the operation completes
Returns
- uint8_t: status
avrcp_cover_art_client_get_image
uint8_t avrcp_cover_art_client_get_image(uint16_t avrcp_cover_art_cid, const char * image_handle, const char * image_descriptor);
Request cover art image for given image handle retrieved via - avrcp_controller_get_now_playing_info or - avrcp_controller_get_element_attributes(... AVRCP_MEDIA_ATTR_DEFAULT_COVER_ART ...) and given image descriptor
Parameters
- avrcp_cover_art_cid
- image_handle: non-NULL image-handle string of exactly 7 characters, retained until the operation completes
- image_descriptor: optional image-descriptor string, retained until the operation completes
Returns
- uint8_t: status
avrcp_cover_art_client_get_image_properties
uint8_t avrcp_cover_art_client_get_image_properties(uint16_t avrcp_cover_art_cid, const char * image_handle);
Request image properties for given image handle retrieved via - avrcp_controller_get_now_playing_info or - avrcp_controller_get_element_attributes(... AVRCP_MEDIA_ATTR_DEFAULT_COVER_ART ...)
Parameters
- avrcp_cover_art_cid
- image_handle: non-NULL image-handle string of exactly 7 characters, retained until the operation completes
Returns
- uint8_t: status
avrcp_cover_art_client_disconnect
uint8_t avrcp_cover_art_client_disconnect(uint16_t avrcp_cover_art_cid);
Disconnect from AVRCP Cover Art service
Parameters
- avrcp_cover_art_cid
Returns
- uint8_t: status
avrcp_cover_art_client_deinit
void avrcp_cover_art_client_deinit(void);
De-Init AVRCP Cover Art Client