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