智能客服
你问我答，随时在线为你解决问题
本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
@ohos.bluetooth.a2dp (蓝牙a2dp模块)
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
本文导读
本模块提供基于增强音频分发协议（Advanced Audio Distribution Profile，A2DP）的蓝牙媒体音频能力，支持获取媒体播放状态和连接状态等方法。
说明
导入模块
收起
自动换行
深色代码主题
复制
- import { a2dp } from '@kit.ConnectivityKit';
BaseProfile
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
type BaseProfile = baseProfile.BaseProfile
基础Profile接口定义，提供监听和获取连接状态等公共能力。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 类型 | 说明 |
|---|---|
| baseProfile.BaseProfile | 基础Profile接口定义。 |
a2dp.createA2dpSrcProfile
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
createA2dpSrcProfile(): A2dpSourceProfile
创建蓝牙媒体A2DP Source实例。通过该实例，可以使用本端作为A2DP Source设备时提供的各项方法，如：获取和其他设备间的蓝牙媒体音频播放状态。
系统能力：SystemCapability.Communication.Bluetooth.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| A2dpSourceProfile | 返回蓝牙媒体音频源实例。 |
错误码：
以下错误码的详细介绍请参见通用错误码说明文档。
展开
| 错误码ID | 错误信息 |
|---|---|
| 401 | Invalid parameter. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed. |
| 801 | Capability not supported. |
示例：
收起
自动换行
深色代码主题
复制
- import { BusinessError } from '@kit.BasicServicesKit';
- try {
- let a2dpProfile = a2dp.createA2dpSrcProfile();
- console.info('a2dp success');
- } catch (err) {
- console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
- }
A2dpSourceProfile
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
该实例表示蓝牙媒体音频中的A2DP Source角色。
- 该类继承于BaseProfile，因此可以使用其父类中的方法。
- 使用该类的方法前，需通过createA2dpSrcProfile方法构造该类的实例。
- 和该实例角色相对应的是A2DP Sink。
getPlayingState
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getPlayingState(deviceId: string): PlayingState
获取本端和对端设备间的媒体音频播放状态。例如，在音乐播放器应用中可用于检查蓝牙音频是否正在播放，从而同步更新界面的播放/暂停按钮状态。
- 从API version 21开始，此接口支持使用对端设备的实际MAC地址获取媒体音频播放状态。
需要权限：ohos.permission.ACCESS_BLUETOOTH
系统能力：SystemCapability.Communication.Bluetooth.Core
参数：
展开
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| deviceId | string | 是 | 对端设备地址，例如："XX:XX:XX:XX:XX:XX"。 |
返回值：
展开
| 类型 | 说明 |
|---|---|
| PlayingState | 蓝牙媒体音频播放状态。 |
错误码：
以下错误码的详细介绍请参见通用错误码说明文档和蓝牙服务子系统错误码。
展开
| 错误码ID | 错误信息 |
|---|---|
| 201 | Permission denied. |
| 401 | Invalid parameter. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed. |
| 801 | Capability not supported. |
| 2900001 | Service stopped. |
| 2900003 | Bluetooth disabled. |
| 2900004 | Profile not supported. |
| 2900099 | Operation failed. |
示例：
收起
自动换行
深色代码主题
复制
- import { BusinessError } from '@kit.BasicServicesKit';
- try {
- let a2dpSrc = a2dp.createA2dpSrcProfile();
- let state = a2dpSrc.getPlayingState('XX:XX:XX:XX:XX:XX');
- } catch (err) {
- console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
- }
PlayingState
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
枚举，蓝牙媒体音频播放状态。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| STATE_NOT_PLAYING | 0 | 未播放媒体音频。 |
| STATE_PLAYING | 1 | 正在播放媒体音频。 |
CodecInfo11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
蓝牙媒体音频使用的编解码器。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| codecType | CodecType | 否 | 否 | 编解码器类型，默认值为CODEC_TYPE_SBC。 |
| codecBitsPerSample | CodecBitsPerSample | 否 | 否 | 每个采样点的位深，默认值为CODEC_BITS_PER_SAMPLE_NONE。 |
| codecChannelMode | CodecChannelMode | 否 | 否 | 编解码器的声道模式，默认值为CODEC_CHANNEL_MODE_NONE。 |
| codecSampleRate | CodecSampleRate | 否 | 否 | 编解码器的采样率，默认值为CODEC_SAMPLE_RATE_NONE。 |
| codecBitRate19+ | CodecBitRate | 否 | 是 | 编解码器的码率，默认值为CODEC_BIT_RATE_ABR。 |
| codecFrameLength19+ | CodecFrameLength | 否 | 是 | 编解码器的帧长，默认值为CODEC_FRAME_LENGTH_10MS。 |
CodecInfoList19+
Phone19+PC/2in119+Tablet19+TV19+Wearable19+
蓝牙媒体音频编解码器支持的能力集合。不同编解码器支持的位深、声道模式、采样率、码率和帧长类型与音频接收器设备端能力有关。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| codecType | CodecType | 否 | 否 | 编解码器类型。 |
| codecBitsPerSampleArray | CodecBitsPerSample[] | 否 | 否 | 编解码器支持的位深能力集合。 |
| codecChannelModeArray | CodecChannelMode[] | 否 | 否 | 编解码器支持的声道模式能力集合。 |
| codecSampleRateArray | CodecSampleRate[] | 否 | 否 | 编解码器支持的采样率能力集合。 |
| codecBitRateArray | CodecBitRate[] | 否 | 否 | 编解码器支持的码率能力集合。 |
| codecFrameLengthArray | CodecFrameLength[] | 否 | 否 | 编解码器支持的帧长能力集合。 |
CodecType11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
枚举，蓝牙媒体音频编解码器类型。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| CODEC_TYPE_INVALID | -1 | 编解码器类型未知。 |
| CODEC_TYPE_SBC | 0 | SBC |
| CODEC_TYPE_AAC | 1 | AAC |
| CODEC_TYPE_L2HC | 2 | L2HC |
| CODEC_TYPE_L2HCST13+ | 3 | L2HCST |
| CODEC_TYPE_LDAC13+ | 4 | LDAC |
CodecChannelMode11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
枚举，蓝牙媒体音频编解码器的声道模式，表示音频播放时独立的空间信号路径数量。声道模式影响声音的立体感和空间定位。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| CODEC_CHANNEL_MODE_NONE | 0 | 声道未知。 |
| CODEC_CHANNEL_MODE_MONO | 1 | 单声道。 |
| CODEC_CHANNEL_MODE_STEREO | 2 | 双声道。 |
CodecBitsPerSample11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
枚举，蓝牙媒体音频编解码器的位深，表示蓝牙音频信号在数字表示中使用的位数，单位为bit。位深决定每个采样点可以表示的动态范围和精度。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| CODEC_BITS_PER_SAMPLE_NONE | 0 | 位深未知。 |
| CODEC_BITS_PER_SAMPLE_16 | 1 | 16bit |
| CODEC_BITS_PER_SAMPLE_24 | 2 | 24bit |
| CODEC_BITS_PER_SAMPLE_32 | 3 | 32bit |
CodecSampleRate11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
枚举，蓝牙媒体音频编解码器的采样率，表示每秒对蓝牙音频采样的次数，单位为Hz。采样率的选择会影响音质和传输效率。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| CODEC_SAMPLE_RATE_NONE | 0 | 采样率未知。 |
| CODEC_SAMPLE_RATE_44100 | 1 | 44.1kHz |
| CODEC_SAMPLE_RATE_48000 | 2 | 48kHz |
| CODEC_SAMPLE_RATE_88200 | 3 | 88.2kHz |
| CODEC_SAMPLE_RATE_96000 | 4 | 96kHz |
| CODEC_SAMPLE_RATE_176400 | 5 | 176.4kHz |
| CODEC_SAMPLE_RATE_192000 | 6 | 192kHz |
CodecBitRate19+
Phone19+PC/2in119+Tablet19+TV19+Wearable19+
枚举，蓝牙媒体音频编解码器的码率，表示单位时间内音频数据的传输量，单位为kbps。码率影响音频音质和传输带宽。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| CODEC_BIT_RATE_96000 | 0 | 96kbps |
| CODEC_BIT_RATE_128000 | 1 | 128kbps |
| CODEC_BIT_RATE_192000 | 2 | 192kbps |
| CODEC_BIT_RATE_256000 | 3 | 256kbps |
| CODEC_BIT_RATE_320000 | 4 | 320kbps |
| CODEC_BIT_RATE_480000 | 5 | 480kbps |
| CODEC_BIT_RATE_640000 | 6 | 640kbps |
| CODEC_BIT_RATE_960000 | 7 | 960kbps |
| CODEC_BIT_RATE_ABR | 8 | 自适应码率（根据蓝牙链路质量自动调整）。 |
| CODEC_BIT_RATE_150000021+ | 9 | 1500kbps |
| CODEC_BIT_RATE_230000021+ | 10 | 2300kbps |
CodecFrameLength19+
Phone19+PC/2in119+Tablet19+TV19+Wearable19+
枚举，蓝牙媒体音频编解码器的帧长，表示一帧音频数据播放的时长，单位为ms。帧长影响音频传输的延迟和效率。
系统能力：SystemCapability.Communication.Bluetooth.Core
展开
| 名称 | 值 | 说明 |
|---|---|---|
| CODEC_FRAME_LENGTH_5MS | 0 | 5ms帧长。 |
| CODEC_FRAME_LENGTH_10MS | 1 | 10ms帧长。 |
相关推荐
文档蓝牙术语
华为开发者联盟 版权所有 ©2026
在 API参考 中进行搜索
请输入您想要搜索的关键词