仓颉 OpenHarmony 蓝牙 A2DP 开发指南:ohos.bluetooth.a2dp 模块 API 全解析
仓颉 OpenHarmony 蓝牙 A2DP 开发指南:ohos.bluetooth.a2dp 模块 API 全解析
本篇技术指南围绕 OpenHarmony(HarmonyOS)仓颉(Cangjie)应用开发中的 ohos.bluetooth.a2dp(蓝牙 A2DP 模块)展开,系统讲解如何使用仓颉语言通过 A2DP Source Profile 管理蓝牙音频源设备:从创建 Profile 实例、查询已连接设备、获取连接与播放状态,到订阅连接状态变化事件。阅读本文后,你将掌握在仓颉模板工程中接入蓝牙音频能力所需的权限配置、核心 API 调用范式、异常错误码处理以及 A2DP 编码器参数模型,可直接用于蓝牙耳机/音箱类音频应用或车机互联场景的音频状态管理开发。
A2DP 模块在仓颉蓝牙体系中的定位
A2DP(Advanced Audio Distribution Profile,高级音频分发配置文件)是传统蓝牙(BR/EDR)体系中的一项核心音频协议,允许在设备间无线传输高品质音频流,典型场景如通过蓝牙耳机、音箱、汽车音响收听音乐。该协议定义了两种角色:A2DP Source(音频源设备端,负责编码并发送音频数据,典型设备如手机、平板)和 A2DP Sink(音频接收设备,负责解码并播放音频,典型设备如蓝牙耳机、音箱),详见 Connectivity Kit 术语 中关于 A2DP 的条目。
在仓颉侧的蓝牙能力体系中,ohos.bluetooth.a2dp 模块归属于 Connectivity Kit(短距通信服务),与 BLE、HFP、WLAN、NFC 等能力并列。Connectivity Kit 概述中明确说明,A2DP 模块允许无线传输高品质音频流,支持双向通信,可用于耳机、扬声器、汽车音响等设备,相关能力总览见 Connectivity Kit 简介,蓝牙整体技术背景见 蓝牙服务开发概述。
本模块的 API 设计遵循"Profile 模式":以 A2dpSourceProfile 类为核心入口,该类继承自蓝牙 baseProfile 模块定义的通用 BaseProfile 接口,因此 A2DP 场景下的设备列表查询、连接状态查询与事件订阅,与 HFP 等其他蓝牙 Profile 共用同一套基础 API 范式。可对照 ohos.bluetooth.base_profile 模块文档 理解其继承关系。
环境准备:导入模块与权限配置
导入模块
A2DP 模块通过仓颉 Kit 统一导入语法引入,在仓颉工程源文件中使用:
import kit.ConnectivityKit.*
权限列表
调用 A2DP 相关接口必须声明蓝牙访问权限:
- ohos.permission.ACCESS_BLUETOOTH
该权限属于系统授权类型(system_grant),需要在应用的配置文件(如 module.json5)中声明,并在应用安装时由系统完成授权。缺少该权限时,接口会抛出错误码 201(Permission denied.)的 BusinessException。
API 示例代码使用说明
本模块文档中的示例代码遵循仓颉示例工程的统一约定:
- 若示例代码首行有
// index.cj注释,表示该示例可在仓颉模板工程的index.cj文件中直接编译运行; - 若示例需获取 Context 应用上下文,需在仓颉模板工程的
main_ability.cj文件中进行配置。
示例工程及配置模板的完整说明参见 仓颉示例代码说明。
创建 A2DP Profile 实例
A2DP 模块通过顶层函数 createA2dpSrcProfile() 创建 A2DP Source Profile 实例,这是使用所有 A2DP 方法的前置步骤。
函数签名
public func createA2dpSrcProfile(): A2dpSourceProfile
- 功能: 创建 a2dp profile 实例。
- 系统能力: SystemCapability.Communication.Bluetooth.Core
- 起始版本: 22
返回值
| 类型 | 说明 |
|---|---|
| A2dpSourceProfile | 返回该 profile 的实例。 |
示例代码
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.*
try {
let a2dpProfile = createA2dpSrcProfile()
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
示例中引入了 kit.PerformanceAnalysisKit.Hilog(用于日志输出)与 ohos.business_exception.*(用于捕获 BusinessException),所有蓝牙接口调用都建议放入 try/catch 块中,将 BusinessException 携带的错误码与错误信息通过 Hilog.info 打印,便于问题定位。可执行示例工程参照 仓颉示例代码说明。
A2dpSourceProfile:蓝牙 A2DP 音频源核心类
类定义与继承关系
public class A2dpSourceProfile <: BaseProfile {}
- 功能: 使用 A2dpSourceProfile 方法之前需要创建该类的实例进行操作,通过 createA2dpSrcProfile() 方法构造此实例。
- 系统能力: SystemCapability.Communication.Bluetooth.Core
- 起始版本: 22
- 父类型: BaseProfile
从父类型 BaseProfile 的接口定义(见 base_profile 模块)可以看出,A2DP 实例天然具备以下基础能力:获取已连接设备列表 getConnectedDevices()、获取连接状态 getConnectionState(deviceId)、订阅事件 on(...)、取消订阅 off(...)。A2DP 模块在此基础上额外扩展了播放状态查询 getPlayingState(deviceId)。
获取已连接设备列表:getConnectedDevices()
public func getConnectedDevices(): Array<String>
- 功能: 获取已连接设备列表。
- 需要权限: ohos.permission.ACCESS_BLUETOOTH
- 系统能力: SystemCapability.Communication.Bluetooth.Core
- 起始版本: 22
返回值:
| 类型 | 说明 |
|---|---|
| Array<String> | 返回当前已连接设备的地址。基于信息安全考虑,此处获取的设备地址为随机 MAC 地址。配对成功后,该地址不会变更;已配对设备取消配对后重新扫描或蓝牙服务下电时,该随机地址会变更。 |
示例:
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.*
try {
let a2dpSrc = createA2dpSrcProfile()
let retArray = a2dpSrc.getConnectedDevices()
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
需要注意返回值是随机 MAC 地址而非设备真实物理地址,这是出于信息安全考虑的系统设计:同一台已配对设备的随机地址在配对期间保持稳定,可用于缓存与识别;但设备取消配对后重新扫描、或蓝牙服务下电重启时,该随机地址会发生变化,应用不应将其作为持久化的设备唯一标识长期依赖。
获取 Profile 连接状态:getConnectionState(String)
public func getConnectionState(deviceId: String): ProfileConnectionState
- 功能: 获取设备 profile 的连接状态。
- 需要权限: ohos.permission.ACCESS_BLUETOOTH
- 系统能力: SystemCapability.Communication.Bluetooth.Core
- 起始版本: 22
参数:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| deviceId | String | 是 | - | 远端设备地址。 |
返回值:
| 类型 | 说明 |
|---|---|
| ProfileConnectionState | 返回 profile 的连接状态。 |
示例:
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.*
try {
let a2dpSrc = createA2dpSrcProfile()
let retArray = a2dpSrc.getConnectionState("XX:XX:XX:XX:XX:XX")
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
返回的 ProfileConnectionState 枚举定义在 蓝牙 constant 模块 中,包含以下取值:
| 枚举值 | 含义 |
|---|---|
| StateDisconnected | 表示 profile 已断连。 |
| StateConnecting | 表示 profile 正在连接。 |
| StateConnected | 表示 profile 已连接。 |
| StateDisconnecting | 表示 profile 正在断开连接。 |
这些枚举均实现了 Equatable<ProfileConnectionState> 与 ToString,因此既可以通过 == / != 运算符做状态判断,也可以调用 toString() 输出字符串形式的状态描述。
获取播放状态:getPlayingState(String)
public func getPlayingState(deviceId: String): PlayingState
- 功能: 获取设备的播放状态。
- 需要权限: ohos.permission.ACCESS_BLUETOOTH
- 系统能力: SystemCapability.Communication.Bluetooth.Core
- 起始版本: 22
参数:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| deviceId | String | 是 | - | 远端设备地址。 |
返回值:
| 类型 | 说明 |
|---|---|
| PlayingState | 远端设备的播放状态。 |
示例:
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.business_exception.*
try {
let a2dpSrc = createA2dpSrcProfile()
let state = a2dpSrc.getPlayingState("XX:XX:XX:XX:XX:XX")
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
PlayingState 是 A2DP 模块特有的播放状态枚举(详见下文 enum PlayingState),取值包括 StatePlaying(正在播放)与 StateNotPlaying(未播放),适用于音乐播放类应用展示耳机/音箱的实时播放状态。
订阅与取消连接状态变化事件
A2DP 模块支持通过回调机制订阅蓝牙设备的 Profile 连接状态变化事件,事件类型与参数定义在 base_profile 模块 中。
订阅事件:on(ProfileCallbackType, Callback1Argument<StateChangeParam>)
public func on(eventType: ProfileCallbackType, callback: Callback1Argument<StateChangeParam>): Unit
- 功能: 订阅连接状态变化事件。使用 Callback 异步回调。
- 需要权限: ohos.permission.ACCESS_BLUETOOTH
- 系统能力: SystemCapability.Communication.Bluetooth.Core
- 起始版本: 22
参数:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| eventType | ProfileCallbackType | 是 | - | 传入 ConnectionStateChange,表示连接状态变化事件类型。 |
| callback | Callback1Argument<StateChangeParam> | 是 | - | 表示回调函数的入参。 |
示例:
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.callback_invoke.*
import ohos.business_exception.*
// 此处定义所需要的依赖项等
class StateChangeCallback2 <: Callback1Argument<StateChangeParam> {
public func invoke(err: ?BusinessException, arg: StateChangeParam): Unit {
let connectionState = arg.state.toString()
Hilog.info(0, "Bluetooth", "profile connection state has change to ${connectionState}")
}
}
let a2dp = createA2dpSrcProfile()
let changeCallBack = StateChangeCallback2()
try {
a2dp.on(ProfileCallbackType.ConnectionStateChange, changeCallBack)
a2dp.off(ProfileCallbackType.ConnectionStateChange)
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
实现回调类时需要继承 Callback1Argument<StateChangeParam> 并重写 invoke(err: ?BusinessException, arg: StateChangeParam) 方法。invoke 的第一个参数 err 是可空类型(?BusinessException),用于上报回调过程中的异常;第二个参数 arg 为 StateChangeParam 状态变化参数,其中 state 字段即为变化后的 ProfileConnectionState 连接状态,示例中通过 toString() 转为字符串后经 Hilog 输出。
Callback1Argument 与 CallbackObject 属于 ArkTS/OpenHarmony 回调调用机制(callback_invoke)在仓颉侧的接口映射,其定义参见 callback_invoke 模块文档。
取消订阅:off() 的两种重载
取消订阅提供两个重载版本,均用于"取消所有订阅连接状态变化事件":
版本一:off(ProfileCallbackType, CallbackObject)
public func off(eventType: ProfileCallbackType, callback: CallbackObject): Unit
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| eventType | ProfileCallbackType | 是 | - | 回调事件类型。 |
| callback | CallbackObject | 是 | - | 回调事件。 |
版本二:off(ProfileCallbackType)
public func off(eventType: ProfileCallbackType): Unit
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| eventType | ProfileCallbackType | 是 | - | 回调事件类型。 |
off 版本一示例:
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.callback_invoke.*
import ohos.business_exception.*
// 此处定义所需要的依赖项等
class StateChangeCallback <: Callback1Argument<StateChangeParam> {
public func invoke(err: ?BusinessException, arg: StateChangeParam): Unit {
let connectionState = arg.state.toString()
Hilog.info(0, "Bluetooth", "profile connection state has change to ${connectionState}")
}
}
let a2dp = createA2dpSrcProfile()
let changeCallBack = StateChangeCallback()
try {
a2dp.on(ProfileCallbackType.ConnectionStateChange, changeCallBack)
a2dp.off(ProfileCallbackType.ConnectionStateChange)
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
off 版本二示例:
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.callback_invoke.*
import ohos.business_exception.*
// 此处定义所需要的依赖项等
class StateChangeCallback1 <: Callback1Argument<StateChangeParam> {
public func invoke(err: ?BusinessException, arg: StateChangeParam): Unit {
let connectionState = arg.state.toString()
Hilog.info(0, "Bluetooth", "profile connection state has change to ${connectionState}")
}
}
let a2dp = createA2dpSrcProfile()
let changeCallBack = StateChangeCallback1()
try {
a2dp.on(ProfileCallbackType.ConnectionStateChange, changeCallBack)
a2dp.off(ProfileCallbackType.ConnectionStateChange)
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
建议在页面/组件生命周期结束时调用 off() 取消订阅,避免回调泄漏与资源占用。事件类型 ProfileCallbackType 目前支持 ConnectionStateChange(连接状态变化事件),其枚举定义与 toString() 方法见 base_profile 模块的 ProfileCallbackType。回调入参 StateChangeParam 携带三个字段:deviceId(蓝牙设备地址)、state(profile 连接状态)、cause(连接失败原因,如用户主动断开、连接数超限等,详见 base_profile 模块的 DisconnectCause)。
A2DP 编码器参数模型:CodecInfo 与相关枚举
为支撑高质量音频传输,A2DP 模块提供了编码器信息描述类 CodecInfo,用于描述蓝牙音频编码器的关键参数(采样位数、声道模式、采样率、编码类型)。在仓颉侧这些参数统一使用枚举类型约束,便于编译期类型检查。
类 CodecInfo
public class CodecInfo {
public var codecType: CodecType
public var codecBitsPerSample: CodecBitsPerSample
public var codecChannelMode: CodecChannelMode
public var codecSampleRate: CodecSampleRate
}
- 功能: 编码器信息。
- 系统能力: SystemCapability.Communication.Bluetooth.Core
- 起始版本: 22
四个公开成员变量均可读写,含义如下:
| 成员变量 | 类型 | 功能 | 初始值 |
|---|---|---|---|
| codecType | CodecType | 表示编码器类型 | CODEC_TYPE_SBC(即 CodecTypeSbc) |
| codecBitsPerSample | CodecBitsPerSample | 表示每个采样点的位数 | CODEC_BITS_PER_SAMPLE_NONE |
| codecChannelMode | CodecChannelMode | 表示编码器的声道模式 | CODEC_CHANNEL_MODE_NONE |
| codecSampleRate | CodecSampleRate | 表示编码器的采样率 | CODEC_BITS_PER_SAMPLE_NONE(即 CodecSampleRateNone) |
说明:文档中
codecSampleRate的初始值表述为 "CODEC_BITS_PER_SAMPLE_NONE",结合其类型为CodecSampleRate可以推断该描述实为文档笔误,其语义应指CodecSampleRateNone(未知采样率),即以"未知/未设置"作为采样率的默认初始值。
enum CodecBitsPerSample:采样点位数
public enum CodecBitsPerSample <: Equatable<CodecBitsPerSample> & ToString {
| CodecBitsPerSampleNone
| CodecBitsPerSample16
| CodecBitsPerSample24
| CodecBitsPerSample32
| ...
}
- 功能: 蓝牙编码器每个采样点的位数。
- 父类型:
Equatable<CodecBitsPerSample>、ToString
| 枚举值 | 功能 |
|---|---|
| CodecBitsPerSample16 | 16 位采样点的位数。 |
| CodecBitsPerSample24 | 24 位采样点的位数。 |
| CodecBitsPerSample32 | 32 位采样点的位数。 |
| CodecBitsPerSampleNone | 未知采样点的位数。 |
enum CodecChannelMode:声道模式
public enum CodecChannelMode <: Equatable<CodecChannelMode> & ToString {
| CodecChannelModeNone
| CodecChannelModeMono
| CodecChannelModeStereo
| ...
}
- 功能: 蓝牙编码器的声道模式。
- 父类型:
Equatable<CodecChannelMode>、ToString
| 枚举值 | 功能 |
|---|---|
| CodecChannelModeMono | 单声道。 |
| CodecChannelModeStereo | 双声道。 |
| CodecChannelModeNone | 未知声道。 |
enum CodecSampleRate:采样率
public enum CodecSampleRate <: Equatable<CodecSampleRate> & ToString {
| CodecSampleRateNone
| CodecSampleRate44100
| CodecSampleRate48000
| CodecSampleRate88200
| CodecSampleRate96000
| CodecSampleRate176400
| CodecSampleRate192000
| ...
}
- 功能: 蓝牙编码器的采样率。
- 父类型:
Equatable<CodecSampleRate>、ToString
| 枚举值 | 功能 |
|---|---|
| CodecSampleRate44100 | 44.1k 采样率。 |
| CodecSampleRate48000 | 48k 采样率。 |
| CodecSampleRate88200 | 88.2k 采样率。 |
| CodecSampleRate96000 | 96k 位采样率。 |
| CodecSampleRate176400 | 176.4k 位采样率。 |
| CodecSampleRate192000 | 192k 位采样率。 |
| CodecSampleRateNone | 未知采样率。 |
enum CodecType:编码器类型
public enum CodecType <: Equatable<CodecType> & ToString {
| CodecTypeInvalid
| CodecTypeSbc
| CodecTypeAac
| CodecTypeL2hc
| ...
}
- 功能: 蓝牙编码器类型。
- 父类型:
Equatable<CodecType>、ToString
| 枚举值 | 功能 |
|---|---|
| CodecTypeSbc | SBC(蓝牙音频默认的低复杂度子带编码)。 |
| CodecTypeAac | AAC(高级音频编码)。 |
| CodecTypeL2hc | L2HC(高性能无损/高保真蓝牙音频编码)。 |
| CodecTypeInvalid | 未知编码类型。 |
枚举的运算符与字符串化方法
上述四个编码器相关枚举(CodecBitsPerSample、CodecChannelMode、CodecSampleRate、CodecType)都声明继承 Equatable 与 ToString,因而各自提供三个成对出现的方法,便于在业务代码中直接进行状态比较与日志输出:
| 方法 | 功能 |
|---|---|
operator func ==(other): Bool |
对该枚举值进行判等;相同返回 true,否则返回 false。 |
operator func !=(other): Bool |
对该枚举值进行判不等;不同返回 true,否则返回 false。 |
func toString(): String |
返回该枚举值的字符串表示。 |
例如,判断当前编码器类型是否为 AAC 可以写作:
let info = CodecInfo()
if (info.codecType == CodecTypeAac) {
// 处理 AAC 编码
}
enum PlayingState:蓝牙 A2DP 播放状态
getPlayingState() 返回的 PlayingState 枚举定义如下:
public enum PlayingState <: Equatable<PlayingState> & ToString {
| StateNotPlaying
| StatePlaying
| ...
}
- 功能: 蓝牙 A2DP 播放状态。
- 父类型:
Equatable<PlayingState>、ToString
| 枚举值 | 功能 |
|---|---|
| StatePlaying | 表示正在播放。 |
| StateNotPlaying | 表示未播放。 |
与编码器相关枚举一致,PlayingState 同样提供 ==(判等)、!=(判不等)与 toString()(字符串表示)三个方法。典型应用是:在轮询或回调中读取设备播放状态,当状态切换为 StatePlaying 时更新 UI 播放指示,切换为 StateNotPlaying 时暂停播放动画。
异常与错误码处理
A2DP 模块的所有接口在失败时统一抛出 BusinessException,需通过 try/catch 捕获。各接口的错误码分为两类来源:
- 通用错误码:见 通用错误码说明文档;
- 蓝牙服务子系统特有错误码:见 蓝牙服务子系统错误码。
A2DP 接口可能抛出的错误码汇总如下:
| 错误码 ID | 错误信息 | 错误描述 | 处理建议 |
|---|---|---|---|
| 201 | Permission denied. | 无权限(未声明 ohos.permission.ACCESS_BLUETOOTH)。 |
检查应用权限配置。 |
| 801 | Capability not supported. | 系统能力不支持(未具备 SystemCapability.Communication.Bluetooth.Core)。 | 检查设备系统能力。 |
| 2900001 | Service stopped. | 蓝牙服务已停止,蓝牙服务相关的接口无法调用。 | 重新执行打开或关闭蓝牙。 |
| 2900003 | Bluetooth disabled. | 蓝牙开关已关闭。 | 重新执行打开蓝牙开关。 |
| 2900004 | Profile not supported. | 配置文件(A2DP Profile)在当前设备环境不支持。 | 检查设备是否支持该配置文件功能,若不支持则停止调用。 |
| 2900099 | Operation failed. | 操作失败。 | 请重试该操作。 |
其中错误码 2900001、2900003、2900004、2900099 的完整错误描述、可能原因与处理步骤,均可从 蓝牙服务子系统错误码文档 中查到详细说明(该文档还包含 2900005 设备未连接、2900006 超过最大连接数量、2900008 proxy 为空、2900100 IPC 失败等本模块可能涉及的邻近错误码)。此外,订阅/取消订阅接口(on/off)的异常表只包含通用错误码 201 与 801,不包含蓝牙服务子系统的 290xxxx 系列错误码。
实战:整合一个蓝牙耳机连接状态监控示例
结合上述 API,可以构造一个完整的 A2DP 连接状态监控流程:创建 Profile 实例 → 查询已连接设备 → 查询连接/播放状态 → 订阅状态变化 → 页面退出时取消订阅。以下为整合示例:
// index.cj
import kit.ConnectivityKit.*
import kit.PerformanceAnalysisKit.Hilog
import ohos.callback_invoke.*
import ohos.business_exception.*
// 连接状态变化回调
class A2dpStateChangeCallback <: Callback1Argument<StateChangeParam> {
public func invoke(err: ?BusinessException, arg: StateChangeParam): Unit {
let connectionState = arg.state.toString()
Hilog.info(0, "Bluetooth", "device ${arg.deviceId} connection state: ${connectionState}")
}
}
let a2dp = createA2dpSrcProfile()
let callback = A2dpStateChangeCallback()
try {
// 1. 查询当前已连接的 A2DP 设备
let devices = a2dp.getConnectedDevices()
Hilog.info(0, "Bluetooth", "connected devices count: ${devices.size}")
// 2. 查询每个设备的连接状态与播放状态
for (device in devices) {
let connState = a2dp.getConnectionState(device).toString()
let playState = a2dp.getPlayingState(device).toString()
Hilog.info(0, "Bluetooth", "device ${device}, conn=${connState}, play=${playState}")
}
// 3. 订阅连接状态变化事件
a2dp.on(ProfileCallbackType.ConnectionStateChange, callback)
} catch (e: BusinessException) {
Hilog.info(0, "Bluetooth", "errCode: ${e.code}, errMessage: ${e.message}")
}
// 页面/组件退出时取消订阅(示意)
// a2dp.off(ProfileCallbackType.ConnectionStateChange)
该示例覆盖了本模块文档中的全部核心调用路径,可作为蓝牙耳机连接管理、音频设备列表刷新等功能的开发起点。注意 getConnectedDevices() 返回的地址为随机 MAC 地址,若要在会话间保持设备身份识别,建议配合系统配对信息做映射管理。
总结
ohos.bluetooth.a2dp 模块以 A2dpSourceProfile 为核心,在继承 BaseProfile 通用能力(设备列表、连接状态、事件订阅)的基础上,扩展了 A2DP 特有的播放状态查询与编码器参数模型(CodecInfo 及 CodecType、CodecBitsPerSample、CodecChannelMode、CodecSampleRate 四个枚举),并通过统一的 BusinessException 错误码体系反馈权限、系统能力与蓝牙服务状态问题。实际开发时只需三步:声明 ohos.permission.ACCESS_BLUETOOTH 权限 → 调用 createA2dpSrcProfile() 创建实例 → 在 try/catch 中调用查询与订阅接口即可完成蓝牙音频源设备的接入与状态监控。相关文档可进一步查阅 Connectivity Kit 简介、蓝牙服务开发概述 以及 base_profile 模块 以构建完整的蓝牙开发知识体系。