跳转至
芯片
版本

A2DP

A2DP（Advanced Audio Distribution Profile）蓝牙音频传输规范 Source 端 API。管理音频流连接建立/断开、音频编码参数（SBC/AAC 等）配置和音频数据推送。

WS63 作为音频源（Source）向蓝牙音箱/耳机等 Sink 设备推送音频流，适用蓝牙音频发射场景。

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

接口清单

接口名称 功能简述
a2dp_src_get_device_connect_state 通过设备地址查询A2DP连接状态
a2dp_src_get_playing_state 查询对端蓝牙设备A2DP播放状态
a2dp_src_connect 与对端设备建立A2DP连接
a2dp_src_disconnect 与对端设备断开A2DP连接
a2dp_src_get_active_device 查询当前活跃的A2DP对端设备地址
a2dp_src_start_playing 设置A2DP音频流为开始播放状态
a2dp_src_suspend_playing 设置A2DP音频流为暂停播放状态
a2dp_src_stop_playing 设置A2DP音频流为停止播放状态
a2dp_src_register_callbacks 注册A2DP SRC上层应用回调函数
a2dp_src_deregister_callbacks 去注册A2DP SRC上层应用回调函数

Functions

a2dp_src_get_device_connect_state 

int a2dp_src_get_device_connect_state(const bd_addr_t *bd_addr)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 通过对端蓝牙设备地址查询该设备的A2DP SRC连接状态
  • 返回值为profile_connect_state_t枚举，包含正在连接、已连接、正在断连、已断连四种状态
  • 调用该接口不会触发连接状态变更，仅做查询操作

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参bd_addr不为NULL，且指向有效的蓝牙设备地址

入参

名称 参数类型 详细说明 约束取值范围
bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL

返回值

  • 返回类型：int
返回值 文字含义 触发场景
PROFILE_STATE_CONNECTING(0x01) 正在连接 正在建立A2DP连接
PROFILE_STATE_CONNECTED(0x02) 已连接 A2DP连接已建立
PROFILE_STATE_DISCONNECTING(0x03) 正在断连 正在断开A2DP连接
PROFILE_STATE_DISCONNECTED(0x04) 已断连 A2DP连接已断开

a2dp_src_get_playing_state 

int a2dp_src_get_playing_state(const bd_addr_t *bd_addr)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 当对端设备已处于连接状态时，通过设备地址查询对端蓝牙设备的A2DP播放状态
  • 返回值为a2dp_playing_state_t枚举，包含未播放和正在播放两种状态
  • 需在对端设备已连接后调用，否则查询结果无意义

前置条件

  • 蓝牙协议栈已初始化完成
  • 对端设备已建立A2DP连接
  • 入参bd_addr不为NULL，且指向已连接设备的蓝牙地址

入参

名称 参数类型 详细说明 约束取值范围
bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL，设备已连接

返回值

  • 返回类型：int
返回值 文字含义 触发场景
A2DP_NOT_PLAYING(0x00) 未播放 A2DP音频流未在播放
A2DP_IS_PLAYING(0x01) 正在播放 A2DP音频流正在播放

a2dp_src_connect 

int a2dp_src_connect(const bd_addr_t *bd_addr)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 与对端蓝牙设备建立A2DP SRC连接
  • 调用后异步发起连接请求，连接结果通过connectstate_changed_cb回调通知上层
  • 重复调用可能导致连接异常，需在已断连状态下发起连接

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参bd_addr不为NULL，且指向有效的对端蓝牙设备地址
  • 当前未与目标设备建立A2DP连接

入参

名称 参数类型 详细说明 约束取值范围
bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL

返回值

  • 返回类型：int
返回值 文字含义 触发场景
ERRCODE_BT_SUCCESS(0x00) 执行成功 连接请求成功发起
Other 其他错误码，参考errcode_bt_t 执行失败

a2dp_src_disconnect 

int a2dp_src_disconnect(const bd_addr_t *bd_addr)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 与对端蓝牙设备断开A2DP SRC连接
  • 调用后异步发起断连请求，断连结果通过connectstate_changed_cb回调通知上层
  • 需在已连接状态下调用，否则可能返回错误码

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参bd_addr不为NULL，且指向已连接的对端蓝牙设备地址
  • 当前与目标设备已建立A2DP连接

入参

名称 参数类型 详细说明 约束取值范围
bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL，设备已连接

返回值

  • 返回类型：int
返回值 文字含义 触发场景
ERRCODE_BT_SUCCESS(0x00) 执行成功 断连请求成功发起
Other 其他错误码，参考errcode_bt_t 执行失败

a2dp_src_get_active_device 

bd_addr_t a2dp_src_get_active_device(void)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 查询当前A2DP SRC活跃的对端蓝牙设备地址
  • 返回值为bd_addr_t结构体，包含设备地址和地址类型
  • 当无活跃设备时返回全零地址

前置条件

  • 蓝牙协议栈已初始化完成

返回值

返回值 文字含义 触发场景
NOT NULL 成功，返回活跃设备地址 存在活跃的A2DP连接设备
NULL 失败，无活跃设备 无活跃的A2DP连接设备

a2dp_src_start_playing 

int a2dp_src_start_playing(const bd_addr_t *bd_addr)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 设置A2DP音频流为开始播放（start streaming）状态
  • 调用后向对端设备发送音频流开始指令，播放状态变更通过playing_state_changed_cb回调通知上层
  • 需在已连接且未播放状态下调用

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参bd_addr不为NULL，且指向已连接的对端蓝牙设备地址
  • 当前A2DP音频流未处于播放状态

入参

名称 参数类型 详细说明 约束取值范围
bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL，设备已连接

返回值

  • 返回类型：int
返回值 文字含义 触发场景
ERRCODE_BT_SUCCESS(0x00) 执行成功 播放请求成功发起
Other 其他错误码，参考errcode_bt_t 执行失败

a2dp_src_suspend_playing 

int a2dp_src_suspend_playing(const bd_addr_t *bd_addr)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 设置A2DP音频流为暂停播放（suspend streaming）状态
  • 调用后向对端设备发送音频流暂停指令，播放状态变更通过playing_state_changed_cb回调通知上层
  • 暂停后可通过a2dp_src_start_playing恢复播放

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参bd_addr不为NULL，且指向已连接的对端蓝牙设备地址
  • 当前A2DP音频流处于播放状态

入参

名称 参数类型 详细说明 约束取值范围
bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL，设备已连接

返回值

  • 返回类型：int
返回值 文字含义 触发场景
ERRCODE_BT_SUCCESS(0x00) 执行成功 暂停请求成功发起
Other 其他错误码，参考errcode_bt_t 执行失败

a2dp_src_stop_playing 

int a2dp_src_stop_playing(const bd_addr_t *bd_addr)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 设置A2DP音频流为停止播放（stop streaming）状态
  • 调用后向对端设备发送音频流停止指令，播放状态变更通过playing_state_changed_cb回调通知上层
  • 停止后需通过a2dp_src_start_playing重新开始播放

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参bd_addr不为NULL，且指向已连接的对端蓝牙设备地址
  • 当前A2DP音频流处于播放或暂停状态

入参

名称 参数类型 详细说明 约束取值范围
bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL，设备已连接

返回值

  • 返回类型：int
返回值 文字含义 触发场景
ERRCODE_BT_SUCCESS(0x00) 执行成功 停止请求成功发起
Other 其他错误码，参考errcode_bt_t 执行失败

a2dp_src_register_callbacks 

int a2dp_src_register_callbacks(a2dp_src_callbacks_t *func)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 注册A2DP SRC上层应用回调函数，用于接收连接状态变更、播放状态变更、编码格式变更等事件通知
  • 回调函数运行于BTS线程上下文，回调中不应阻塞或长时间等待
  • 回调中bd_addr相关内存由BTS申请和释放，回调中不应释放该内存

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参func不为NULL，且指向有效的a2dp_src_callbacks_t回调结构体

入参

名称 参数类型 详细说明 约束取值范围
func a2dp_src_callbacks_t * 回调函数结构体指针 不为NULL

返回值

  • 返回类型：int
返回值 文字含义 触发场景
ERRCODE_BT_SUCCESS(0x00) 执行成功 回调注册成功
Other 其他错误码，参考errcode_bt_t 执行失败

a2dp_src_deregister_callbacks 

int a2dp_src_deregister_callbacks(a2dp_src_callbacks_t *func)

头文件清单

#include "include/middleware/services/bts/br/bts_a2dp_source.h"

功能说明

  • 去注册A2DP SRC上层应用回调函数，取消连接状态变更、播放状态变更、编码格式变更等事件通知
  • 去注册后BTS不再调用该回调结构体中的回调函数
  • 入参func应与注册时传入的指针一致

前置条件

  • 蓝牙协议栈已初始化完成
  • 入参func不为NULL，且指向已注册的a2dp_src_callbacks_t回调结构体
  • 该回调结构体已通过a2dp_src_register_callbacks注册成功

入参

名称 参数类型 详细说明 约束取值范围
func a2dp_src_callbacks_t * 回调函数结构体指针 不为NULL，已注册

返回值

  • 返回类型：int
返回值 文字含义 触发场景
ERRCODE_BT_SUCCESS(0x00) 执行成功 回调去注册成功
Other 其他错误码，参考errcode_bt_t 执行失败

Type definitions

a2dp_src_connect_state_changed_callback 

typedef void (*a2dp_src_connect_state_changed_callback)(bd_addr_t *bd_addr, int conn_state);

使用说明：作为a2dp_src_callbacks_t结构体中connectstate_changed_cb成员的类型，在A2DP SRC连接状态变更时由BTS调用

a2dp_src_playing_state_changed_callback 

typedef void (*a2dp_src_playing_state_changed_callback)(bd_addr_t *bd_addr, int playing_state);

使用说明：作为a2dp_src_callbacks_t结构体中playing_state_changed_cb成员的类型，在A2DP SRC播放状态变更时由BTS调用

a2dp_src_configuration_changed_callback 

typedef void (*a2dp_src_configuration_changed_callback)(bd_addr_t *bd_addr, a2dp_codec_info_t *info);

使用说明：作为a2dp_src_callbacks_t结构体中configuration_changed_cb成员的类型，在A2DP SRC编码格式变更时由BTS调用

Enumerations

a2dp_codec_type_t 

typedef enum {
    A2DP_CODEC_TYPE_SBC = 0x00,        /*!< 编码格式类型为SBC。 */
    A2DP_CODEC_TYPE_AAC,               /*!< 编码格式类型为AAC。 */
    A2DP_CODEC_TYPE_APTX,              /*!< 编码格式类型为APTX。 */
    A2DP_CODEC_TYPE_APTX_HD,           /*!< 编码格式类型为APTX_HD。 */
    A2DP_CODEC_TYPE_LDAC,              /*!< 编码格式类型为LDAC。 */
    A2DP_CODEC_TYPE_LHDC,              /*!< 编码格式类型为LHDC。 */
    A2DP_CODEC_TYPE_LC3,               /*!< 编码格式类型为LC3。 */
    A2DP_CODEC_TYPE_L2HC,              /*!< 编码格式类型为L2HC。 */
    A2DP_CODEC_TYPE_INVALID = 0xF4240, /*!< 无效编码格式类型。 */
} a2dp_codec_type_t;
枚举成员 取值 描述
A2DP_CODEC_TYPE_SBC 0x00 SBC编码格式
A2DP_CODEC_TYPE_AAC 0x01 AAC编码格式
A2DP_CODEC_TYPE_APTX 0x02 APTX编码格式
A2DP_CODEC_TYPE_APTX_HD 0x03 APTX_HD编码格式
A2DP_CODEC_TYPE_LDAC 0x04 LDAC编码格式
A2DP_CODEC_TYPE_LHDC 0x05 LHDC编码格式
A2DP_CODEC_TYPE_LC3 0x06 LC3编码格式
A2DP_CODEC_TYPE_L2HC 0x07 L2HC编码格式
A2DP_CODEC_TYPE_INVALID 0xF4240 无效编码格式

a2dp_optional_codec_support_state_t 

typedef enum {
    A2DP_OPTIONAL_CODEC_NOT_SUPPORT = 0x00, /*!< 不支持设置编码格式类型。 */
    A2DP_OPTIONAL_CODEC_SUPPORT,            /*!< 支持设置编码格式类型。 */
    A2DP_OPTIONAL_CODEC_SUPPORT_UNKNOWN,    /*!< 支持用户定义编码格式类型。 */
} a2dp_optional_codec_support_state_t;
枚举成员 取值 描述
A2DP_OPTIONAL_CODEC_NOT_SUPPORT 0x00 不支持可选编码格式
A2DP_OPTIONAL_CODEC_SUPPORT 0x01 支持可选编码格式
A2DP_OPTIONAL_CODEC_SUPPORT_UNKNOWN 0x02 支持用户定义编码格式

profile_connect_state_t 

typedef enum {
    PROFILE_STATE_CONNECTING = 0x01,    /*!< 正在连接。 */
    PROFILE_STATE_CONNECTED = 0x02,     /*!< 已连接。 */
    PROFILE_STATE_DISCONNECTING = 0x03, /*!< 正在断连。 */
    PROFILE_STATE_DISCONNECTED = 0x04   /*!< 已断连。 */
} profile_connect_state_t;
枚举成员 取值 描述
PROFILE_STATE_CONNECTING 0x01 正在连接
PROFILE_STATE_CONNECTED 0x02 已连接
PROFILE_STATE_DISCONNECTING 0x03 正在断连
PROFILE_STATE_DISCONNECTED 0x04 已断连

a2dp_playing_state_t 

typedef enum {
    A2DP_NOT_PLAYING = 0x00, /*!< a2dp未播放。 */
    A2DP_IS_PLAYING          /*!< a2dp正在播放。 */
} a2dp_playing_state_t;
枚举成员 取值 描述
A2DP_NOT_PLAYING 0x00 未播放
A2DP_IS_PLAYING 0x01 正在播放

bt_addr_type 

typedef enum {
    BT_ADDRESS_TYPE_PUBLIC_DEVICE_ADDRESS          =  0x00, /*!< 蓝牙公有地址。 */
    BT_ADDRESS_TYPE_RANDOM_DEVICE_ADDRESS          =  0x01, /*!< 蓝牙随机地址。 */
} bt_addr_type;
枚举成员 取值 描述
BT_ADDRESS_TYPE_PUBLIC_DEVICE_ADDRESS 0x00 蓝牙公有地址
BT_ADDRESS_TYPE_RANDOM_DEVICE_ADDRESS 0x01 蓝牙随机地址

errcode_bt_t 

#define ERRCODE_BT_COMMON_BASE 0x80006000
#define ERRCODE_BT_COMMON_END  0x800067FF
typedef enum {
    ERRCODE_BT_SUCCESS = 0x00,                /*!< 执行成功错误码 */
    ERRCODE_BT_FAIL = ERRCODE_BT_COMMON_BASE, /*!< 执行失败错误码 */
    ERRCODE_BT_NOT_READY,                     /*!< 执行状态未就绪错误码 */
    ERRCODE_BT_MALLOC_FAIL,                   /*!< 内存不足错误码 */
    ERRCODE_BT_MEMCPY_FAIL,                   /*!< 内存拷贝错误码 */
    ERRCODE_BT_BUSY,                          /*!< 繁忙无法响应错误码 */
    ERRCODE_BT_DONE,                          /*!< 执行完成错误码 */
    ERRCODE_BT_UNSUPPORTED,                   /*!< 不支持错误码 */
    ERRCODE_BT_PARAM_ERR,                     /*!< 无效参数错误码 */
    ERRCODE_BT_STATE_ERR,                     /*!< 状态错误 */
    ERRCODE_BT_UNHANDLED,                     /*!< 未处理错误码 */
    ERRCODE_BT_AUTH_FAIL,                     /*!< 鉴权失败错误码 */
    ERRCODE_BT_RMT_DEV_DOWN,                  /*!< 远端设备关闭错误码 */
    ERRCODE_BT_AUTH_REJECTED,                 /*!< 鉴权被拒错误码 */
    ERRCODE_BT_MAX = ERRCODE_BT_COMMON_END    /*!< 蓝牙错误码最大值 */
} errcode_bt_t;
枚举成员 取值 描述
ERRCODE_BT_SUCCESS 0x00 执行成功
ERRCODE_BT_FAIL 0x80006000 执行失败
ERRCODE_BT_NOT_READY 0x80006001 状态未就绪
ERRCODE_BT_MALLOC_FAIL 0x80006002 内存不足
ERRCODE_BT_MEMCPY_FAIL 0x80006003 内存拷贝失败
ERRCODE_BT_BUSY 0x80006004 繁忙无法响应
ERRCODE_BT_DONE 0x80006005 执行完成
ERRCODE_BT_UNSUPPORTED 0x80006006 不支持
ERRCODE_BT_PARAM_ERR 0x80006007 无效参数
ERRCODE_BT_STATE_ERR 0x80006008 状态错误
ERRCODE_BT_UNHANDLED 0x80006009 未处理
ERRCODE_BT_AUTH_FAIL 0x8000600A 鉴权失败
ERRCODE_BT_RMT_DEV_DOWN 0x8000600B 远端设备关闭
ERRCODE_BT_AUTH_REJECTED 0x8000600C 鉴权被拒
ERRCODE_BT_MAX 0x800067FF 错误码最大值

Structures

a2dp_codec_info_t 

typedef struct {
    int codec_priority;            /*!< 编码格式优先级。 */
    unsigned int codec_type;       /*!< 编码格式类型。 */
    unsigned char sample_rate;     /*!< 编码器采样率。 */
    unsigned char bits_per_sample; /*!< 采样比特位。 */
    unsigned char channel_mode;    /*!< 声道模式。 */
    unsigned long codec_specific1; /*!< 自定义参数1。 */
    unsigned long codec_specific2; /*!< 自定义参数2。 */
    unsigned long codec_specific3; /*!< 自定义参数3。 */
    unsigned long codec_specific4; /*!< 自定义参数4。 */
} a2dp_codec_info_t;

成员说明：

成员名称 数据类型 描述
codec_priority int 编码格式优先级，取值参考A2DP_CODEC_PRIORITY_DISABLED(-1)、A2DP_CODEC_PRIORITY_DEFAULT(0)、A2DP_CODEC_PRIORITY_HIGHEST(1000000)
codec_type unsigned int 编码格式类型，取值参考a2dp_codec_type_t
sample_rate unsigned char 编码器采样率，取值参考A2DP_CODEC_SAMPLE_RATE_*系列宏
bits_per_sample unsigned char 采样比特位，取值参考A2DP_CODEC_BITS_PER_SAMPLE_*系列宏
channel_mode unsigned char 声道模式，取值参考A2DP_CODEC_CHANNEL_MODE_*系列宏
codec_specific1 unsigned long 自定义参数1
codec_specific2 unsigned long 自定义参数2
codec_specific3 unsigned long 自定义参数3
codec_specific4 unsigned long 自定义参数4

a2dp_src_callbacks_t 

typedef struct {
    a2dp_src_connect_state_changed_callback connectstate_changed_cb;
    a2dp_src_playing_state_changed_callback playing_state_changed_cb;
    a2dp_src_configuration_changed_callback configuration_changed_cb;
} a2dp_src_callbacks_t;

成员说明：

成员名称 数据类型 描述
connectstate_changed_cb a2dp_src_connect_state_changed_callback A2DP SRC连接状态变更回调函数指针
playing_state_changed_cb a2dp_src_playing_state_changed_callback A2DP SRC播放状态变更回调函数指针
configuration_changed_cb a2dp_src_configuration_changed_callback A2DP SRC编码格式变更回调函数指针

bd_addr_t 

#define BD_ADDR_LEN 6
typedef struct {
    uint8_t addr[BD_ADDR_LEN];     /*!< 蓝牙地址。 */
    uint8_t type;                  /*!< 蓝牙地址类型，参考 bt_addr_type。 */
} bd_addr_t;

成员说明：

成员名称 数据类型 描述
addr uint8_t[6] 蓝牙设备地址，长度为6字节
type uint8_t 蓝牙地址类型，取值参考bt_addr_type