1# HdiAudio (V2_0) 2 3 4## 概述 5 6Audio模块接口定义。 7 8音频接口涉及数据类型、驱动加载接口、驱动适配器接口、音频播放接口、音频录音接口等。 9 10**起始版本：** 4.1 11 12 13## 汇总 14 15 16### 文件 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [AudioTypes.idl](_audio_types_8idl_v20.md) | Audio模块接口定义中使用的数据类型。 | 21| [IAudioAdapter.idl](_i_audio_adapter_8idl_v20.md) | Audio适配器的接口定义文件。 | 22| [IAudioCallback.idl](_i_audio_callback_8idl_v20.md) | Audio播放的回调函数定义文件。 | 23| [IAudioCapture.idl](_i_audio_capture_8idl_v20.md) | Audio录音的接口定义文件。 | 24| [IAudioManager.idl](_i_audio_manager_8idl_v20.md) | Audio适配器管理及加载的接口定义文件。 | 25| [IAudioRender.idl](_i_audio_render_8idl_v20.md) | Audio播放的接口定义文件。 | 26 27 28### 类 29 30| 名称 | 描述 | 31| -------- | -------- | 32| struct [AudioDeviceStatus](_audio_device_status_v20.md) | 音频设备状态。 | 33| union [SceneDesc](union_scene_desc_v20.md) | 音频场景描述。 | 34| struct [AudioPort](_audio_port_v20.md) | 音频端口。 | 35| struct [AudioAdapterDescriptor](_audio_adapter_descriptor_v20.md) | 音频适配器描述符。 | 36| struct [AudioDeviceDescriptor](_audio_device_descriptor_v20.md) | 音频设备描述符。 | 37| struct [AudioSceneDescriptor](_audio_scene_descriptor_v20.md) | 音频场景描述符。 | 38| struct [AudioOffloadInfo](_audio_offload_info_v20.md) | 音频低功耗属性 | 39| struct [AudioSampleAttributes](_audio_sample_attributes_v20.md) | 音频采样属性。 | 40| struct [AudioTimeStamp](_audio_time_stamp_v20.md) | 音频时间戳。 | 41| struct [AudioSubPortCapability](_audio_sub_port_capability_v20.md) | 音频子端口的支持能力。 | 42| struct [AudioPortCapability](_audio_port_capability_v20.md) | 音频端口的支持能力。 | 43| struct [AudioMmapBufferDescripter](_audio_mmap_buffer_descripter_v20.md) | mmap缓冲区描述符。 | 44| struct [AudioDevExtInfo](_audio_dev_ext_info_v20.md) | 音频设备拓展信息。 | 45| struct [AudioMixExtInfo](_audio_mix_ext_info_v20.md) | 音轨拓展信息。 | 46| struct [AudioSessionExtInfo](_audio_session_ext_info_v20.md) | 会话拓展信息。 | 47| struct [AudioInfo](_audio_info_v20.md) | 音频端口特定信息。 | 48| struct [AudioRouteNode](_audio_route_node_v20.md) | 音频路由节点。 | 49| struct [AudioRoute](_audio_route_v20.md) | 音频路由信息。 | 50| struct [AudioEvent](_audio_event_v20.md) | 音频事件。 | 51| interface [IAudioAdapter](interface_i_audio_adapter_v20.md) | AudioAdapter音频适配器接口。 | 52| interface [IAudioCallback](interface_i_audio_callback_v20.md) | Audio回调接口。 | 53| interface [IAudioCapture](interface_i_audio_capture_v20.md) | 音频接口的包路径。 | 54| interface [IAudioManager](interface_i_audio_manager_v20.md) | AudioManager音频适配器管理接口。 | 55| interface [IAudioRender](interface_i_audio_render_v20.md) | AudioRender音频播放接口。 | 56 57 58### 枚举 59 60| 名称 | 描述 | 61| -------- | -------- | 62| [AudioPortDirection](#audioportdirection) { PORT_OUT = 1 , PORT_IN = 2 , PORT_OUT_IN = 3 } | 音频端口的类型。 | 63| [AudioPortPin](#audioportpin) {<br/>PIN_NONE = 0 , PIN_OUT_SPEAKER = 1 << 0 , PIN_OUT_HEADSET = 1 << 1 , PIN_OUT_LINEOUT = 1 << 2 ,<br/>PIN_OUT_HDMI = 1 << 3 , PIN_OUT_USB = 1 << 4 , PIN_OUT_USB_EXT = 1 << 5 , PIN_OUT_EARPIECE = 1 << 5 \| 1 << 4 ,<br/>PIN_OUT_BLUETOOTH_SCO = 1 << 6 , PIN_OUT_DAUDIO_DEFAULT = 1 << 7 , PIN_OUT_HEADPHONE = 1 << 8 , PIN_OUT_USB_HEADSET = 1 << 9 ,<br/>PIN_OUT_BLUETOOTH_A2DP = 1 << 10 , PIN_IN_MIC = 1 << 27 \| 1 << 0 , PIN_IN_HS_MIC = 1 << 27 \| 1 << 1 , PIN_IN_LINEIN = 1 << 27 \| 1 << 2 ,<br/>PIN_IN_USB_EXT = 1 << 27 \| 1 << 3 , PIN_IN_BLUETOOTH_SCO_HEADSET = 1 << 27 \| 1 << 4 , PIN_IN_DAUDIO_DEFAULT = 1 << 27 \| 1 << 5 , PIN_IN_USB_HEADSET = 1 << 27 \| 1 << 6<br/>} | 音频端口上的Pin脚。 | 64| [AudioCategory](#audiocategory) {<br/>AUDIO_IN_MEDIA = 0 , AUDIO_IN_COMMUNICATION = 1 , AUDIO_IN_RINGTONE = 2 , AUDIO_IN_CALL = 3 ,<br/>AUDIO_MMAP_NOIRQ = 4 , AUDIO_OFFLOAD = 5 , AUDIO_MULTI_CHANNEL = 6<br/>} | 音频类型（场景）。 | 65| [AudioFormat](#audioformat) {<br/>AUDIO_FORMAT_TYPE_PCM_8_BIT = 1 << 0 , AUDIO_FORMAT_TYPE_PCM_16_BIT = 1 << 1 , AUDIO_FORMAT_TYPE_PCM_24_BIT = 1 << 1 \| 1 << 0 , AUDIO_FORMAT_TYPE_PCM_32_BIT = 1 << 2 ,<br/>AUDIO_FORMAT_TYPE_PCM_FLOAT = 1 << 2 \| 1 << 0 , AUDIO_FORMAT_TYPE_MP3 = 1 << 24 , AUDIO_FORMAT_TYPE_AAC_MAIN = 1 << 24 \| 1 << 0 , AUDIO_FORMAT_TYPE_AAC_LC = 1 << 24 \| 1 << 1 ,<br/>AUDIO_FORMAT_TYPE_AAC_LD = 1 << 24 \| 1 << 1 \| 1 << 0 , AUDIO_FORMAT_TYPE_AAC_ELD = 1 << 24 \| 1 << 2 , AUDIO_FORMAT_TYPE_AAC_HE_V1 = 1 << 24 \| 1 << 2 \| 1 << 0 , AUDIO_FORMAT_TYPE_AAC_HE_V2 = 1 << 24 \| 1 << 2 \| 1 << 1 ,<br/>AUDIO_FORMAT_TYPE_G711A = 1 << 25 \| 1 << 0 , AUDIO_FORMAT_TYPE_G711U = 1 << 25 \| 1 << 1 , AUDIO_FORMAT_TYPE_G726 = 1 << 25 \| 1 << 1 \| 1 << 0<br/>} | 音频格式。 | 66| [AudioChannelMask](#audiochannelmask) { AUDIO_CHANNEL_FRONT_LEFT = 1 , AUDIO_CHANNEL_FRONT_RIGHT = 2 , AUDIO_CHANNEL_MONO = 1 , AUDIO_CHANNEL_STEREO = 3 } | 音频通道掩码。 | 67| [AudioSampleRatesMask](#audiosampleratesmask) {<br/>AUDIO_SAMPLE_RATE_MASK_8000 = 1 << 0 , AUDIO_SAMPLE_RATE_MASK_12000 = 1 << 1 , AUDIO_SAMPLE_RATE_MASK_11025 = 1 << 2 , AUDIO_SAMPLE_RATE_MASK_16000 = 1 << 3 ,<br/>AUDIO_SAMPLE_RATE_MASK_22050 = 1 << 4 , AUDIO_SAMPLE_RATE_MASK_24000 = 1 << 5 , AUDIO_SAMPLE_RATE_MASK_32000 = 1 << 6 , AUDIO_SAMPLE_RATE_MASK_44100 = 1 << 7 ,<br/>AUDIO_SAMPLE_RATE_MASK_48000 = 1 << 8 , AUDIO_SAMPLE_RATE_MASK_64000 = 1 << 9 , AUDIO_SAMPLE_RATE_MASK_96000 = 1 << 10 , AUDIO_SAMPLE_RATE_MASK_INVALID = 4294967295<br/>} | 音频采样频率掩码。 | 68| [AudioPortPassthroughMode](#audioportpassthroughmode) { PORT_PASSTHROUGH_LPCM = 1 << 0 , PORT_PASSTHROUGH_RAW = 1 << 1 , PORT_PASSTHROUGH_HBR2LBR = 1 << 2 , PORT_PASSTHROUGH_AUTO = 1 << 3 } | 音频端口的数据透传模式。 | 69| [AudioSampleFormat](#audiosampleformat) {<br/>AUDIO_SAMPLE_FORMAT_S8 = 0 , AUDIO_SAMPLE_FORMAT_S8P = 1 , AUDIO_SAMPLE_FORMAT_U8 = 2 , AUDIO_SAMPLE_FORMAT_U8P = 3 ,<br/>AUDIO_SAMPLE_FORMAT_S16 = 4 , AUDIO_SAMPLE_FORMAT_S16P = 5 , AUDIO_SAMPLE_FORMAT_U16 = 6 , AUDIO_SAMPLE_FORMAT_U16P = 7 ,<br/>AUDIO_SAMPLE_FORMAT_S24 = 8 , AUDIO_SAMPLE_FORMAT_S24P = 9 , AUDIO_SAMPLE_FORMAT_U24 = 10 , AUDIO_SAMPLE_FORMAT_U24P = 11 ,<br/>AUDIO_SAMPLE_FORMAT_S32 = 12 , AUDIO_SAMPLE_FORMAT_S32P = 13 , AUDIO_SAMPLE_FORMAT_U32 = 14 , AUDIO_SAMPLE_FORMAT_U32P = 15 ,<br/>AUDIO_SAMPLE_FORMAT_S64 = 16 , AUDIO_SAMPLE_FORMAT_S64P = 17 , AUDIO_SAMPLE_FORMAT_U64 = 18 , AUDIO_SAMPLE_FORMAT_U64P = 19 ,<br/>AUDIO_SAMPLE_FORMAT_F32 = 20 , AUDIO_SAMPLE_FORMAT_F32P = 21 , AUDIO_SAMPLE_FORMAT_F64 = 22 , AUDIO_SAMPLE_FORMAT_F64P = 23<br/>} | 原始音频样本格式。 | 70| [AudioChannelMode](#audiochannelmode) {<br/>AUDIO_CHANNEL_NORMAL = 0 , AUDIO_CHANNEL_BOTH_LEFT = 1 , AUDIO_CHANNEL_BOTH_RIGHT = 2 , AUDIO_CHANNEL_EXCHANGE = 3 , AUDIO_CHANNEL_MIX = 4 , AUDIO_CHANNEL_LEFT_MUTE = 5 , AUDIO_CHANNEL_RIGHT_MUTE = 6 , AUDIO_CHANNEL_BOTH_MUTE = 7<br/>} | 音频播放的通道模式。 | 71| [AudioDrainNotifyType](#audiodrainnotifytype) { AUDIO_DRAIN_NORMAL_MODE = 0 , AUDIO_DRAIN_EARLY_MODE = 1 } | 音频数据结束类型。 | 72| [AudioCallbackType](#audiocallbacktype) {<br/>AUDIO_NONBLOCK_WRITE_COMPELETED = 0 , AUDIO_DRAIN_COMPELETED = 1 , AUDIO_FLUSH_COMPLETED = 2 , AUDIO_RENDER_FULL = 3 ,<br/>AUDIO_ERROR_OCCUR = 4<br/>} | 回调函数通知事件类型。 | 73| [AudioPortRole](#audioportrole) { AUDIO_PORT_UNASSIGNED_ROLE = 0 , AUDIO_PORT_SOURCE_ROLE = 1 , AUDIO_PORT_SINK_ROLE = 2 } | 音频端口角色。 | 74| [AudioPortType](#audioporttype) { AUDIO_PORT_UNASSIGNED_TYPE = 0 , AUDIO_PORT_DEVICE_TYPE = 1 , AUDIO_PORT_MIX_TYPE = 2 , AUDIO_PORT_SESSION_TYPE = 3 } | 音频端口类型。 | 75| [AudioSessionType](#audiosessiontype) { AUDIO_OUTPUT_STAGE_SESSION = 0 , AUDIO_OUTPUT_MIX_SESSION = 1 , AUDIO_ALLOCATE_SESSION = 2 , AUDIO_INVALID_SESSION = 3 } | 端口会话类型。 | 76| [AudioDeviceType](#audiodevicetype) {<br/>AUDIO_LINEOUT = 1 << 0 , AUDIO_HEADPHONE = 1 << 1 , AUDIO_HEADSET = 1 << 2 , AUDIO_USB_HEADSET = 1 << 3 ,<br/>AUDIO_USB_HEADPHONE = 1 << 4 , AUDIO_USBA_HEADSET = 1 << 5 , AUDIO_USBA_HEADPHONE = 1 << 6 , AUDIO_PRIMARY_DEVICE = 1 << 7 , AUDIO_USB_DEVICE = 1 << 8 , AUDIO_A2DP_DEVICE = 1 << 9 , AUDIO_HDMI_DEVICE = 1 << 10 , AUDIO_ADAPTER_DEVICE = 1 << 11 , AUDIO_DEVICE_UNKOWN<br/>} | 音频设备类型。 | 77| [AudioEventType](#audioeventtype) {<br/>AUDIO_DEVICE_ADD = 1 , AUDIO_DEVICE_REMOVE = 2 , AUDIO_LOAD_SUCCESS = 3 , AUDIO_LOAD_FAILURE = 4 ,<br/>AUDIO_UNLOAD = 5 , AUDIO_SERVICE_VALID = 7 , AUDIO_SERVICE_INVALID = 8 , AUDIO_CAPTURE_THRESHOLD = 9 , AUDIO_EVENT_UNKOWN = 10<br/>} | 音频事件类型。 | 78| [AudioExtParamKey](#audioextparamkey) {<br/>AUDIO_EXT_PARAM_KEY_NONE = 0 , AUDIO_EXT_PARAM_KEY_VOLUME = 1 , AUDIO_EXT_PARAM_KEY_FOCUS = 2 , AUDIO_EXT_PARAM_KEY_BUTTON = 3 ,<br/>AUDIO_EXT_PARAM_KEY_EFFECT = 4 , AUDIO_EXT_PARAM_KEY_STATUS = 5 , AUDIO_EXT_PARAM_KEY_USB_DEVICE = 101 , AUDIO_EXT_PARAM_KEY_PERF_INFO = 201 ,<br/>AUDIO_EXT_PARAM_KEY_MMI = 301 , AUDIO_EXT_PARAM_KEY_LOWPOWER = 1000<br/>} | 音频扩展参数键类型。 | 79| [AudioInputType](#audioinputtype) {<br/>AUDIO_INPUT_DEFAULT_TYPE = 0 , AUDIO_INPUT_MIC_TYPE = 1 << 0 , AUDIO_INPUT_SPEECH_WAKEUP_TYPE = 1 << 1 , AUDIO_INPUT_VOICE_COMMUNICATION_TYPE = 1 << 2 ,<br/>AUDIO_INPUT_VOICE_RECOGNITION_TYPE = 1 << 3 , AUDIO_INPUT_VOICE_UPLINK_TYPE = 1 << 4 , AUDIO_INPUT_VOICE_DOWNLINK_TYPE = 1 << 5 , AUDIO_INPUT_VOICE_CALL_TYPE = 1 << 6 ,<br/>AUDIO_INPUT_CAMCORDER_TYPE = 1 << 7<br/>} | 音频输入类型. | 80 81 82## 枚举类型说明 83 84 85### AudioCallbackType 86 87``` 88enum AudioCallbackType 89``` 90 91**描述** 92 93回调函数通知事件类型。 94 95**起始版本：** 4.1 96 97| 枚举值 | 描述 | 98| -------- | -------- | 99| AUDIO_NONBLOCK_WRITE_COMPELETED | 非阻塞式写完成。 | 100| AUDIO_DRAIN_COMPELETED | DrainBuffer完成，详情参考[DrainBuffer](interface_i_audio_render_v20.md#drainbuffer)。 | 101| AUDIO_FLUSH_COMPLETED | Flush完成，详情参考[Flush](interface_i_audio_render_v20.md#flush)。 | 102| AUDIO_RENDER_FULL | 录音缓冲区已满。 | 103| AUDIO_ERROR_OCCUR | 发生了错误。 | 104 105 106### AudioCategory 107 108``` 109enum AudioCategory 110``` 111 112**描述** 113 114音频类型（场景）。 115 116**起始版本：** 4.1 117 118| 枚举值 | 描述 | 119| -------- | -------- | 120| AUDIO_IN_MEDIA | 媒体。 | 121| AUDIO_IN_COMMUNICATION | 通信。 | 122| AUDIO_IN_RINGTONE | 电话铃声。 | 123| AUDIO_IN_CALL | 呼叫。 | 124| AUDIO_MMAP_NOIRQ | Mmap模式 | 125| AUDIO_OFFLOAD | 低功耗 | 126| AUDIO_MULTI_CHANNEL | 多声道 | 127 128 129### AudioChannelMask 130 131``` 132enum AudioChannelMask 133``` 134 135**描述** 136 137音频通道掩码。 138 139定义音频声道的位置掩码。 140 141**起始版本：** 4.1 142 143| 枚举值 | 描述 | 144| -------- | -------- | 145| AUDIO_CHANNEL_FRONT_LEFT | 声道布局前左。 | 146| AUDIO_CHANNEL_FRONT_RIGHT | 声道布局前右。 | 147| AUDIO_CHANNEL_MONO | 单声道。 | 148| AUDIO_CHANNEL_STEREO | 立体声，由左右声道组成。 | 149 150 151### AudioChannelMode 152 153``` 154enum AudioChannelMode 155``` 156 157**描述** 158 159音频播放的通道模式。 160 161**起始版本：** 4.1 162 163**注意：** 164 165下面的模式是针对双通道立体声的音频播放而设置，其他不支持。 166 167| 枚举值 | 描述 | 168| -------- | -------- | 169| AUDIO_CHANNEL_NORMAL | 正常模式，不做处理。 | 170| AUDIO_CHANNEL_BOTH_LEFT | 两个声道全部为左声道声音。 | 171| AUDIO_CHANNEL_BOTH_RIGHT | 两个声道全部为右声道声音。 | 172| AUDIO_CHANNEL_EXCHANGE | 左右声道数据互换，左声道为右声道声音，右声道为左声道声音。 | 173| AUDIO_CHANNEL_MIX | 左右两个声道输出为左右声道相加（混音）。 | 174| AUDIO_CHANNEL_LEFT_MUTE | 左声道静音，右声道播放原右声道声音。 | 175| AUDIO_CHANNEL_RIGHT_MUTE | 右声道静音，左声道播放原左声道声音。 | 176| AUDIO_CHANNEL_BOTH_MUTE | 左右声道均静音。 | 177 178 179### AudioDeviceType 180 181``` 182enum AudioDeviceType 183``` 184 185**描述** 186 187音频设备类型。 188 189**起始版本：** 4.1 190 191| 枚举值 | 描述 | 192| -------- | -------- | 193| AUDIO_LINEOUT | LINEOUT设备。 | 194| AUDIO_HEADPHONE | 耳机。 | 195| AUDIO_HEADSET | 头戴式耳机。 | 196| AUDIO_USB_HEADSET | USB头戴式耳机。 | 197| AUDIO_USB_HEADPHONE | USB耳机。 | 198| AUDIO_USBA_HEADSET | USB模拟头戴式耳机。 | 199| AUDIO_USBA_HEADPHONE | USB模拟耳机。 | 200| AUDIO_PRIMARY_DEVICE | 主音频设备。 | 201| AUDIO_USB_DEVICE | USB音频设备。 | 202| AUDIO_A2DP_DEVICE | 蓝牙音频设备。 | 203| AUDIO_HDMI_DEVICE | HDMI音频设备 | 204| AUDIO_ADAPTER_DEVICE | 声卡设备 | 205| AUDIO_DEVICE_UNKNOWN | 未知设备。 | 206 207 208### AudioDrainNotifyType 209 210``` 211enum AudioDrainNotifyType 212``` 213 214**描述** 215 216音频数据结束类型。 217 218**起始版本：** 4.1 219 220| 枚举值 | 描述 | 221| -------- | -------- | 222| AUDIO_DRAIN_NORMAL_MODE | 曲目的所有数据播放完就结束。 | 223| AUDIO_DRAIN_EARLY_MODE | 曲目的所有数据未播放完就结束，以便给音频服务做连续性曲目切换留出时间。 | 224 225 226### AudioEventType 227 228``` 229enum AudioEventType 230``` 231 232**描述** 233 234音频事件类型。 235 236**起始版本：** 4.1 237 238| 枚举值 | 描述 | 239| -------- | -------- | 240| AUDIO_DEVICE_ADD | 音频设备添加。 | 241| AUDIO_DEVICE_REMOVE | 音频设备移除。 | 242| AUDIO_LOAD_SUCCESS | 声卡加载成功。 | 243| AUDIO_LOAD_FAILURE | 声卡加载失败。 | 244| AUDIO_UNLOAD | 声卡卸载。 | 245| AUDIO_SERVICE_VALID | 音频服务可用。 | 246| AUDIO_SERVICE_INVALID | 音频服务不可用。 | 247| AUDIO_CAPTURE_THRESHOLD | 录音阈值上报。 | 248| AUDIO_EVENT_UNKNOWN | 未知事件。 | 249 250 251### AudioExtParamKey 252 253``` 254enum AudioExtParamKey 255``` 256 257**描述** 258 259音频扩展参数键类型。 260 261**起始版本：** 4.1 262 263| 枚举值 | 描述 | 264| -------- | -------- | 265| AUDIO_EXT_PARAM_KEY_NONE | 分布式音频-无效事件。 | 266| AUDIO_EXT_PARAM_KEY_VOLUME | 分布式音频-音量事件。 | 267| AUDIO_EXT_PARAM_KEY_FOCUS | 分布式音频-焦点事件。 | 268| AUDIO_EXT_PARAM_KEY_BUTTON | 分布式音频-媒体按钮事件。 | 269| AUDIO_EXT_PARAM_KEY_EFFECT | 分布式音频-音频效果事件。 | 270| AUDIO_EXT_PARAM_KEY_STATUS | 分布式音频-设备状态事件。 | 271| AUDIO_EXT_PARAM_KEY_USB_DEVICE | USB设备类型（ ARM 或 HIFI） | 272| AUDIO_EXT_PARAM_KEY_PERF_INFO | 分布式音频-dsp加载事件。 | 273| AUDIO_EXT_PARAM_KEY_MMI | 分布式音频-主机接口测试。 | 274| AUDIO_EXT_PARAM_KEY_LOWPOWER | 低电量事件。 | 275 276 277### AudioFormat 278 279``` 280enum AudioFormat 281``` 282 283**描述** 284 285音频格式。 286 287**起始版本：** 4.1 288 289| 枚举值 | 描述 | 290| -------- | -------- | 291| AUDIO_FORMAT_TYPE_PCM_8_BIT | 8bit位宽PCM（Pulse Code Modulation）格式。 | 292| AUDIO_FORMAT_TYPE_PCM_16_BIT | 16bit位宽PCM格式。 | 293| AUDIO_FORMAT_TYPE_PCM_24_BIT | 24bit位宽PCM格式。 | 294| AUDIO_FORMAT_TYPE_PCM_32_BIT | 32bit位宽PCM格式。 | 295| AUDIO_FORMAT_TYPE_PCM_FLOAT | PCM浮点格式 | 296| AUDIO_FORMAT_TYPE_MP3 | MP3格式 | 297| AUDIO_FORMAT_TYPE_AAC_MAIN | AAC main格式 | 298| AUDIO_FORMAT_TYPE_AAC_LC | AAC LC格式 | 299| AUDIO_FORMAT_TYPE_AAC_LD | AAC LD格式 | 300| AUDIO_FORMAT_TYPE_AAC_ELD | AAC ELD格式 | 301| AUDIO_FORMAT_TYPE_AAC_HE_V1 | AAC HE_V1格式 | 302| AUDIO_FORMAT_TYPE_AAC_HE_V2 | AAC HE_V2格式 | 303| AUDIO_FORMAT_TYPE_G711A | PCM G711A格式 | 304| AUDIO_FORMAT_TYPE_G711U | PCM G711u格式 | 305| AUDIO_FORMAT_TYPE_G726 | PCM G726格式 | 306 307 308### AudioInputType 309 310``` 311enum AudioInputType 312``` 313 314**描述** 315 316音频输入类型. 317 318| 枚举值 | 描述 | 319| -------- | -------- | 320| AUDIO_INPUT_DEFAULT_TYPE | 默认输入 | 321| AUDIO_INPUT_MIC_TYPE | 麦克风输入 | 322| AUDIO_INPUT_SPEECH_WAKEUP_TYPE | 语音唤醒输入 | 323| AUDIO_INPUT_VOICE_COMMUNICATION_TYPE | 通话 | 324| AUDIO_INPUT_VOICE_RECOGNITION_TYPE | 声音识别 | 325| AUDIO_INPUT_VOICE_UPLINK_TYPE | 上行输入 | 326| AUDIO_INPUT_VOICE_DOWNLINK_TYPE | 下行输入 | 327| AUDIO_INPUT_VOICE_CALL_TYPE | 电话 | 328| AUDIO_INPUT_CAMCORDER_TYPE | 摄像机输入 | 329 330 331### AudioPortDirection 332 333``` 334enum AudioPortDirection 335``` 336 337**描述** 338 339音频端口的类型。 340 341package ohos.hdi.audio.v2_0; 342 343**起始版本：** 4.1 344 345| 枚举值 | 描述 | 346| -------- | -------- | 347| PORT_OUT | 音频输出端口。 | 348| PORT_IN | 音频输入端口。 | 349| PORT_OUT_IN | 音频输出输入端口。 | 350 351 352### AudioPortPassthroughMode 353 354``` 355enum AudioPortPassthroughMode 356``` 357 358**描述** 359 360音频端口的数据透传模式。 361 362**起始版本：** 4.1 363 364| 枚举值 | 描述 | 365| -------- | -------- | 366| PORT_PASSTHROUGH_LPCM | 立体声PCM。 | 367| PORT_PASSTHROUGH_RAW | HDMI透传。 | 368| PORT_PASSTHROUGH_HBR2LBR | 蓝光次世代音频降规格输出。 | 369| PORT_PASSTHROUGH_AUTO | 根据HDMI EDID能力自动匹配。 | 370 371 372### AudioPortPin 373 374``` 375enum AudioPortPin 376``` 377 378**描述** 379 380音频端口上的Pin脚。 381 382**起始版本：** 4.1 383 384| 枚举值 | 描述 | 385| -------- | -------- | 386| PIN_NONE | 无效端口。 | 387| PIN_OUT_SPEAKER | 喇叭输出。 | 388| PIN_OUT_HEADSET | 有线耳机输出。 | 389| PIN_OUT_LINEOUT | Lineout输出。 | 390| PIN_OUT_HDMI | HDMI输出。 | 391| PIN_OUT_USB | USB输出。 | 392| PIN_OUT_USB_EXT | USB外部声卡输出。 | 393| PIN_OUT_EARPIECE | 有线耳机输出。 | 394| PIN_OUT_BLUETOOTH_SCO | 蓝牙SCO输出 | 395| PIN_OUT_DAUDIO_DEFAULT | 音频默认输出 | 396| PIN_OUT_HEADPHONE | 有线耳机输出。 | 397| PIN_OUT_USB_HEADSET | ARM USB输出 | 398| PIN_OUT_BLUETOOTH_A2DP | 蓝牙A2DP输出 | 399| PIN_IN_MIC | 麦克风输入 | 400| PIN_IN_HS_MIC | 耳机麦克风输入 | 401| PIN_IN_LINEIN | Linein输入。 | 402| PIN_IN_USB_EXT | USB外部声卡输入。 | 403| PIN_IN_BLUETOOTH_SCO_HEADSET | 蓝牙SCO耳机输入 | 404| PIN_IN_DAUDIO_DEFAULT | 音频默认输入 | 405| PIN_IN_USB_HEADSET | ARM USB输入 | 406 407 408### AudioPortRole 409 410``` 411enum AudioPortRole 412``` 413 414**描述** 415 416音频端口角色。 417 418**起始版本：** 4.1 419 420| 枚举值 | 描述 | 421| -------- | -------- | 422| AUDIO_PORT_UNASSIGNED_ROLE | 未指定端口角色。 | 423| AUDIO_PORT_SOURCE_ROLE | 指定端口为发送端角色。 | 424| AUDIO_PORT_SINK_ROLE | 指定端口为接受端角色。 | 425 426 427### AudioPortType 428 429``` 430enum AudioPortType 431``` 432 433**描述** 434 435音频端口类型。 436 437**起始版本：** 4.1 438 439| 枚举值 | 描述 | 440| -------- | -------- | 441| AUDIO_PORT_UNASSIGNED_TYPE | 未指定端口类型。 | 442| AUDIO_PORT_DEVICE_TYPE | 指定端口为设备类型。 | 443| AUDIO_PORT_MIX_TYPE | 指定端口为复合类型。 | 444| AUDIO_PORT_SESSION_TYPE | 指定端口为会话类型。 | 445 446 447### AudioSampleFormat 448 449``` 450enum AudioSampleFormat 451``` 452 453**描述** 454 455原始音频样本格式。 456 457**起始版本：** 4.1 458 459| 枚举值 | 描述 | 460| -------- | -------- | 461| AUDIO_SAMPLE_FORMAT_S8 | 8bit位宽有符号交织样本。 | 462| AUDIO_SAMPLE_FORMAT_S8P | 8bit位宽有符号非交织样本。 | 463| AUDIO_SAMPLE_FORMAT_U8 | 8bit位宽无符号交织样本。 | 464| AUDIO_SAMPLE_FORMAT_U8P | 8bit位宽无符号非交织样本。 | 465| AUDIO_SAMPLE_FORMAT_S16 | 16bit位宽有符号交织样本。 | 466| AUDIO_SAMPLE_FORMAT_S16P | 16bit位宽有符号非交织样本。 | 467| AUDIO_SAMPLE_FORMAT_U16 | 16bit位宽无符号符号交织样本。 | 468| AUDIO_SAMPLE_FORMAT_U16P | 16bit位宽无符号符号非交织样本。 | 469| AUDIO_SAMPLE_FORMAT_S24 | 24bit位宽有符号交织样本。 | 470| AUDIO_SAMPLE_FORMAT_S24P | 24bit位宽有符号非交织样本。 | 471| AUDIO_SAMPLE_FORMAT_U24 | 24bit位宽无符号符号交织样本。 | 472| AUDIO_SAMPLE_FORMAT_U24P | 24bit位宽无符号非交织样本。 | 473| AUDIO_SAMPLE_FORMAT_S32 | 32bit位宽有符号交织样本。 | 474| AUDIO_SAMPLE_FORMAT_S32P | 32bit位宽有符号非交织样本。 | 475| AUDIO_SAMPLE_FORMAT_U32 | 32bit位宽无符号交织样本。 | 476| AUDIO_SAMPLE_FORMAT_U32P | 32bit位宽无符号非交织样本。 | 477| AUDIO_SAMPLE_FORMAT_S64 | 64bit位宽有符号交织样本。 | 478| AUDIO_SAMPLE_FORMAT_S64P | 64bit位宽有符号非交织样本。 | 479| AUDIO_SAMPLE_FORMAT_U64 | 64bit位宽无符号交织样本。 | 480| AUDIO_SAMPLE_FORMAT_U64P | 64bit位宽无符号非交织样本。 | 481| AUDIO_SAMPLE_FORMAT_F32 | 32bit位宽浮点型交织样本。 | 482| AUDIO_SAMPLE_FORMAT_F32P | 32bit位宽浮点型非交织样本。 | 483| AUDIO_SAMPLE_FORMAT_F64 | 64bit位宽双精度浮点型交织样本。 | 484| AUDIO_SAMPLE_FORMAT_F64P | 64bit位宽双精度浮点型非交织样本。 | 485 486 487### AudioSampleRatesMask 488 489``` 490enum AudioSampleRatesMask 491``` 492 493**描述** 494 495音频采样频率掩码。 496 497**起始版本：** 4.1 498 499| 枚举值 | 描述 | 500| -------- | -------- | 501| AUDIO_SAMPLE_RATE_MASK_8000 | 8K 采样频率。 | 502| AUDIO_SAMPLE_RATE_MASK_12000 | 12K 采样频率。 | 503| AUDIO_SAMPLE_RATE_MASK_11025 | 11.025K 采样频率。 | 504| AUDIO_SAMPLE_RATE_MASK_16000 | 16K 采样频率。 | 505| AUDIO_SAMPLE_RATE_MASK_22050 | 22.050K 采样频率。 | 506| AUDIO_SAMPLE_RATE_MASK_24000 | 24K 采样频率。 | 507| AUDIO_SAMPLE_RATE_MASK_32000 | 32K 采样频率。 | 508| AUDIO_SAMPLE_RATE_MASK_44100 | 44.1K 采样频率。 | 509| AUDIO_SAMPLE_RATE_MASK_48000 | 48K 采样频率。 | 510| AUDIO_SAMPLE_RATE_MASK_64000 | 64K 采样频率。 | 511| AUDIO_SAMPLE_RATE_MASK_96000 | 96K 采样频率。 | 512| AUDIO_SAMPLE_RATE_MASK_INVALID | 无效的采样频率。 | 513 514 515### AudioSessionType 516 517``` 518enum AudioSessionType 519``` 520 521**描述** 522 523端口会话类型。 524 525**起始版本：** 4.1 526 527| 枚举值 | 描述 | 528| -------- | -------- | 529| AUDIO_OUTPUT_STAGE_SESSION | 会话绑定到指定输出流。 | 530| AUDIO_OUTPUT_MIX_SESSION | 会话绑定到特定音轨。 | 531| AUDIO_ALLOCATE_SESSION | 会话ID需重新申请。 | 532| AUDIO_INVALID_SESSION | 无效会话类型。 | 533