• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Audio
2
3
4## 概述
5
6Audio模块接口定义。
7
8音频接口涉及数据类型、驱动加载接口、驱动适配器接口、音频播放接口、音频录音接口等。
9
10**Since:**
11
123.2
13
14**Version:**
15
161.0
17
18
19## 汇总
20
21
22### 文件
23
24  | 名称 | 描述 |
25| -------- | -------- |
26| [AudioTypes.idl](_audio_types_8idl.md) | Audio模块接口定义中使用的数据类型。 |
27| [IAudioAdapter.idl](_i_audio_adapter_8idl.md) | Audio适配器的接口定义文件。 |
28| [IAudioCallback.idl](_i_audio_callback_8idl.md) | Audio播放的回调函数定义文件。 |
29| [IAudioCapture.idl](_i_audio_capture_8idl.md) | Audio录音的接口定义文件。 |
30| [IAudioManager.idl](_i_audio_manager_8idl.md) | Audio适配器管理及加载的接口定义文件。 |
31| [IAudioRender.idl](_i_audio_render_8idl.md) | Audio播放的接口定义文件。 |
32
33
34### 类
35
36  | 名称 | 描述 |
37| -------- | -------- |
38| [AudioDeviceStatus](_audio_device_status.md) | struct<br/>音频设备状态。 |
39| [SceneDesc](union_scene_desc.md) | union<br/>音频场景描述。 |
40| [AudioPort](_audio_port.md) | struct<br/>音频端口。 |
41| [AudioAdapterDescriptor](_audio_adapter_descriptor.md) | struct<br/>音频适配器描述符。 |
42| [AudioDeviceDescriptor](_audio_device_descriptor.md) | struct<br/>音频设备描述符。 |
43| [AudioSceneDescriptor](_audio_scene_descriptor.md) | struct<br/>音频场景描述符。 |
44| [AudioSampleAttributes](_audio_sample_attributes.md) | struct<br/>音频采样属性。 |
45| [AudioTimeStamp](_audio_time_stamp.md) | struct<br/>音频时间戳。 |
46| [AudioSubPortCapability](_audio_sub_port_capability.md) | struct<br/>音频子端口的支持能力。 |
47| [AudioPortCapability](_audio_port_capability.md) | struct<br/>音频端口的支持能力。 |
48| [AudioMmapBufferDescripter](_audio_mmap_buffer_descripter.md) | struct<br/>mmap缓冲区描述符。 |
49| [AudioDevExtInfo](_audio_dev_ext_info.md) | struct<br/>音频设备拓展信息。 |
50| [AudioMixExtInfo](_audio_mix_ext_info.md) | struct<br/>音轨拓展信息。 |
51| [AudioSessionExtInfo](_audio_session_ext_info.md) | struct<br/>会话拓展信息。 |
52| [AudioInfo](_audio_info.md) | struct<br/>音频端口特定信息。 |
53| [AudioRouteNode](_audio_route_node.md) | struct<br/>音频路由节点。 |
54| [AudioRoute](_audio_route.md) | struct<br/>音频路由信息。 |
55| [AudioEvent](_audio_event.md) | struct<br/>音频事件。 |
56| [IAudioAdapter](interface_i_audio_adapter.md) | interface<br/>AudioAdapter音频适配器接口。 |
57| [IAudioCallback](interface_i_audio_callback.md) | interface<br/>Audio回调接口。 |
58| [IAudioCapture](interface_i_audio_capture.md) | interface<br/>AudioCapture音频录音接口。 |
59| [IAudioManager](interface_i_audio_manager.md) | interface<br/>AudioManager音频适配器管理接口。 |
60| [IAudioRender](interface_i_audio_render.md) | interface<br/>AudioRender音频播放接口。 |
61
62
63### 枚举
64
65  | 名称 | 描述 |
66| -------- | -------- |
67| [AudioPortDirection](#audioportdirection)&nbsp;{&nbsp;PORT_OUT&nbsp;=&nbsp;1&nbsp;,&nbsp;PORT_IN&nbsp;=&nbsp;2&nbsp;,&nbsp;PORT_OUT_IN&nbsp;=&nbsp;3&nbsp;} | 音频端口的类型。 |
68| [AudioPortPin](#audioportpin)&nbsp;{<br/>PIN_NONE&nbsp;=&nbsp;0&nbsp;,&nbsp;PIN_OUT_SPEAKER&nbsp;=&nbsp;1&nbsp;,&nbsp;PIN_OUT_HEADSET&nbsp;=&nbsp;2&nbsp;,&nbsp;PIN_OUT_LINEOUT&nbsp;=&nbsp;4&nbsp;,<br/>PIN_OUT_HDMI&nbsp;=&nbsp;8&nbsp;,&nbsp;PIN_IN_MIC&nbsp;=&nbsp;134217729&nbsp;,&nbsp;PIN_IN_HS_MIC&nbsp;=&nbsp;134217730&nbsp;,&nbsp;PIN_IN_LINEIN&nbsp;=&nbsp;134217732&nbsp;,<br/>PIN_IN_USB_EXT&nbsp;=&nbsp;134217736<br/>} | 音频端口上的Pin脚。 |
69| [AudioCategory](#audiocategory)&nbsp;{&nbsp;AUDIO_IN_MEDIA&nbsp;=&nbsp;0&nbsp;,&nbsp;AUDIO_IN_COMMUNICATION&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_IN_RINGTONE&nbsp;=&nbsp;2&nbsp;,&nbsp;AUDIO_IN_CALL&nbsp;=&nbsp;3&nbsp;} | 音频类型(场景)。 |
70| [AudioFormat](#audioformat)&nbsp;{<br/>AUDIO_FORMAT_PCM_8_BIT&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_FORMAT_PCM_16_BIT&nbsp;=&nbsp;2&nbsp;,&nbsp;AUDIO_FORMAT_PCM_24_BIT&nbsp;=&nbsp;3&nbsp;,&nbsp;AUDIO_FORMAT_PCM_32_BIT&nbsp;=&nbsp;4&nbsp;,<br/>AUDIO_FORMAT_AAC_MAIN&nbsp;=&nbsp;16777217&nbsp;,&nbsp;AUDIO_FORMAT_AAC_LC&nbsp;=&nbsp;16777218&nbsp;,&nbsp;AUDIO_FORMAT_AAC_LD&nbsp;=&nbsp;16777219&nbsp;,&nbsp;AUDIO_FORMAT_AAC_ELD&nbsp;=&nbsp;16777220&nbsp;,<br/>AUDIO_FORMAT_AAC_HE_V1&nbsp;=&nbsp;16777221&nbsp;,&nbsp;AUDIO_FORMAT_AAC_HE_V2&nbsp;=&nbsp;16777222&nbsp;,&nbsp;AUDIO_FORMAT_G711A&nbsp;=&nbsp;33554433&nbsp;,&nbsp;AUDIO_FORMAT_G711U&nbsp;=&nbsp;33554434&nbsp;,<br/>AUDIO_FORMAT_G726&nbsp;=&nbsp;33554435<br/>} | 音频格式。 |
71| [AudioChannelMask](#audiochannelmask)&nbsp;{&nbsp;AUDIO_CHANNEL_FRONT_LEFT&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_CHANNEL_FRONT_RIGHT&nbsp;=&nbsp;2&nbsp;,&nbsp;AUDIO_CHANNEL_MONO&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_CHANNEL_STEREO&nbsp;=&nbsp;3&nbsp;} | 音频通道掩码。 |
72| [AudioSampleRatesMask](#audiosampleratesmask)&nbsp;{<br/>AUDIO_SAMPLE_RATE_MASK_8000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;0&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_12000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;1&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_11025&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;2&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_16000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;3&nbsp;,<br/>AUDIO_SAMPLE_RATE_MASK_22050&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;4&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_24000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;5&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_32000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;6&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_44100&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;7&nbsp;,<br/>AUDIO_SAMPLE_RATE_MASK_48000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;8&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_64000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;9&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_96000&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;10&nbsp;,&nbsp;AUDIO_SAMPLE_RATE_MASK_INVALID&nbsp;=&nbsp;4294967295<br/>} | 音频采样频率掩码。 |
73| [AudioPortPassthroughMode](#audioportpassthroughmode)&nbsp;{&nbsp;PORT_PASSTHROUGH_LPCM&nbsp;=&nbsp;1&nbsp;,&nbsp;PORT_PASSTHROUGH_RAW&nbsp;=&nbsp;2&nbsp;,&nbsp;PORT_PASSTHROUGH_HBR2LBR&nbsp;=&nbsp;4&nbsp;,&nbsp;PORT_PASSTHROUGH_AUTO&nbsp;=&nbsp;8&nbsp;} | 音频端口的数据透传模式。 |
74| [AudioDeviceType](#audiodevicetype)&nbsp;{<br/>AUDIO_LINEOUT&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;0&nbsp;,&nbsp;AUDIO_HEADPHONE&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;1&nbsp;,&nbsp;AUDIO_HEADSET&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;2&nbsp;,&nbsp;AUDIO_USB_HEADSET&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;3&nbsp;,<br/>AUDIO_USB_HEADPHONE&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;4&nbsp;,&nbsp;AUDIO_USBA_HEADSET&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;5&nbsp;,&nbsp;AUDIO_USBA_HEADPHONE&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;6&nbsp;,&nbsp;AUDIO_PRIMARY_DEVICE&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;7&nbsp;,<br/>AUDIO_USB_DEVICE&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;8&nbsp;,&nbsp;AUDIO_A2DP_DEVICE&nbsp;=&nbsp;1&nbsp;&lt;&lt;&nbsp;9&nbsp;,&nbsp;AUDIO_DEVICE_UNKOWN<br/>} | 音频设备类型。 |
75| [AudioEventType](#audioeventtype)&nbsp;{<br/>AUDIO_DEVICE_ADD&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_DEVICE_REMOVE&nbsp;=&nbsp;2&nbsp;,&nbsp;AUDIO_LOAD_SUCCESS&nbsp;=&nbsp;3&nbsp;,&nbsp;AUDIO_LOAD_FAILURE&nbsp;=&nbsp;4&nbsp;,<br/>AUDIO_UNLOAD&nbsp;=&nbsp;5&nbsp;,&nbsp;AUDIO_SERVICE_VALID&nbsp;=&nbsp;7&nbsp;,&nbsp;AUDIO_SERVICE_INVALID&nbsp;=&nbsp;8&nbsp;,&nbsp;AUDIO_CAPTURE_THRESHOLD&nbsp;=&nbsp;9&nbsp;,<br/>AUDIO_EVENT_UNKOWN&nbsp;=&nbsp;10<br/>} | 音频事件类型。 |
76| [AudioExtParamKey](#audioextparamkey)&nbsp;{<br/>AUDIO_EXT_PARAM_KEY_NONE&nbsp;=&nbsp;0&nbsp;,&nbsp;AUDIO_EXT_PARAM_KEY_VOLUME&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_EXT_PARAM_KEY_FOCUS&nbsp;=&nbsp;2&nbsp;,&nbsp;AUDIO_EXT_PARAM_KEY_BUTTON&nbsp;=&nbsp;3&nbsp;,<br/>AUDIO_EXT_PARAM_KEY_EFFECT&nbsp;=&nbsp;4&nbsp;,&nbsp;AUDIO_EXT_PARAM_KEY_STATUS&nbsp;=&nbsp;5&nbsp;,&nbsp;AUDIO_EXT_PARAM_KEY_LOWPOWER&nbsp;=&nbsp;1000<br/>} | 音频扩展参数键类型。 |
77| [AudioSampleFormat](#audiosampleformat)&nbsp;{<br/>AUDIO_SAMPLE_FORMAT_S8&nbsp;=&nbsp;0&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_S8P&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U8&nbsp;=&nbsp;2&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U8P&nbsp;=&nbsp;3&nbsp;,<br/>AUDIO_SAMPLE_FORMAT_S16&nbsp;=&nbsp;4&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_S16P&nbsp;=&nbsp;5&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U16&nbsp;=&nbsp;6&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U16P&nbsp;=&nbsp;7&nbsp;,<br/>AUDIO_SAMPLE_FORMAT_S24&nbsp;=&nbsp;8&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_S24P&nbsp;=&nbsp;9&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U24&nbsp;=&nbsp;10&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U24P&nbsp;=&nbsp;11&nbsp;,<br/>AUDIO_SAMPLE_FORMAT_S32&nbsp;=&nbsp;12&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_S32P&nbsp;=&nbsp;13&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U32&nbsp;=&nbsp;14&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U32P&nbsp;=&nbsp;15&nbsp;,<br/>AUDIO_SAMPLE_FORMAT_S64&nbsp;=&nbsp;16&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_S64P&nbsp;=&nbsp;17&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U64&nbsp;=&nbsp;18&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_U64P&nbsp;=&nbsp;19&nbsp;,<br/>AUDIO_SAMPLE_FORMAT_F32&nbsp;=&nbsp;20&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_F32P&nbsp;=&nbsp;21&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_F64&nbsp;=&nbsp;22&nbsp;,&nbsp;AUDIO_SAMPLE_FORMAT_F64P&nbsp;=&nbsp;23<br/>} | 原始音频样本格式。 |
78| [AudioChannelMode](#audiochannelmode)&nbsp;{<br/>AUDIO_CHANNEL_NORMAL&nbsp;=&nbsp;0&nbsp;,&nbsp;AUDIO_CHANNEL_BOTH_LEFT&nbsp;,&nbsp;AUDIO_CHANNEL_BOTH_RIGHT&nbsp;,&nbsp;AUDIO_CHANNEL_EXCHANGE&nbsp;,<br/>AUDIO_CHANNEL_MIX&nbsp;,&nbsp;AUDIO_CHANNEL_LEFT_MUTE&nbsp;,&nbsp;AUDIO_CHANNEL_RIGHT_MUTE&nbsp;,&nbsp;AUDIO_CHANNEL_BOTH_MUTE<br/>} | 音频播放的通道模式。 |
79| [AudioDrainNotifyType](#audiodrainnotifytype)&nbsp;{&nbsp;AUDIO_DRAIN_NORMAL_MODE&nbsp;,&nbsp;AUDIO_DRAIN_EARLY_MODE&nbsp;} | 音频数据结束类型。 |
80| [AudioCallbackType](#audiocallbacktype)&nbsp;{<br/>AUDIO_NONBLOCK_WRITE_COMPELETED&nbsp;,&nbsp;AUDIO_DRAIN_COMPELETED&nbsp;,&nbsp;AUDIO_FLUSH_COMPLETED&nbsp;,&nbsp;AUDIO_RENDER_FULL&nbsp;,<br/>AUDIO_ERROR_OCCUR<br/>} | 回调函数通知事件类型。 |
81| [AudioPortRole](#audioportrole)&nbsp;{&nbsp;AUDIO_PORT_UNASSIGNED_ROLE&nbsp;=&nbsp;0&nbsp;,&nbsp;AUDIO_PORT_SOURCE_ROLE&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_PORT_SINK_ROLE&nbsp;=&nbsp;2&nbsp;} | 音频端口角色。 |
82| [AudioPortType](#audioporttype)&nbsp;{&nbsp;AUDIO_PORT_UNASSIGNED_TYPE&nbsp;=&nbsp;0&nbsp;,&nbsp;AUDIO_PORT_DEVICE_TYPE&nbsp;=&nbsp;1&nbsp;,&nbsp;AUDIO_PORT_MIX_TYPE&nbsp;=&nbsp;2&nbsp;,&nbsp;AUDIO_PORT_SESSION_TYPE&nbsp;=&nbsp;3&nbsp;} | 音频端口类型。 |
83| [AudioSessionType](#audiosessiontype)&nbsp;{&nbsp;AUDIO_OUTPUT_STAGE_SESSION&nbsp;=&nbsp;0&nbsp;,&nbsp;AUDIO_OUTPUT_MIX_SESSION&nbsp;,&nbsp;AUDIO_ALLOCATE_SESSION&nbsp;,&nbsp;AUDIO_INVALID_SESSION&nbsp;} | 端口会话类型。 |
84
85
86### 关键字
87
88  | 名称 | 描述 |
89| -------- | -------- |
90| package&nbsp;ohos.hdi.audio.v1_0 | 音频接口的包路径。 |
91
92
93## 枚举类型说明
94
95
96### AudioCallbackType
97
98
99```
100enum AudioCallbackType
101```
102
103**描述:**
104
105回调函数通知事件类型。
106
107  | 枚举值 | 描述 |
108| -------- | -------- |
109| AUDIO_NONBLOCK_WRITE_COMPELETED | 非阻塞式写完成。 |
110| AUDIO_DRAIN_COMPELETED | DrainBuffer完成,详情参考[DrainBuffer()](interface_i_audio_render.md#drainbuffer)。 |
111| AUDIO_FLUSH_COMPLETED | Flush完成,详情参考[Flush()](interface_i_audio_capture.md#flush)。 |
112| AUDIO_RENDER_FULL | 录音缓冲区已满。 |
113| AUDIO_ERROR_OCCUR | 发生了错误。 |
114
115
116### AudioCategory
117
118
119```
120enum AudioCategory
121```
122
123**描述:**
124
125音频类型(场景)。
126
127  | 枚举值 | 描述 |
128| -------- | -------- |
129| AUDIO_IN_MEDIA | 媒体。 |
130| AUDIO_IN_COMMUNICATION | 通信。 |
131| AUDIO_IN_RINGTONE | 电话铃声。 |
132| AUDIO_IN_CALL | 呼叫。 |
133
134
135### AudioChannelMask
136
137
138```
139enum AudioChannelMask
140```
141
142**描述:**
143
144音频通道掩码。
145
146定义音频声道的位置掩码。
147
148  | 枚举值 | 描述 |
149| -------- | -------- |
150| AUDIO_CHANNEL_FRONT_LEFT | 声道布局前左。 |
151| AUDIO_CHANNEL_FRONT_RIGHT | 声道布局前右。 |
152| AUDIO_CHANNEL_MONO | 单声道。 |
153| AUDIO_CHANNEL_STEREO | 立体声,由左右声道组成。 |
154
155
156### AudioChannelMode
157
158
159```
160enum AudioChannelMode
161```
162
163**描述:**
164
165音频播放的通道模式。
166
167**注意:**
168
169下面的模式是针对双通道立体声的音频播放而设置,其他不支持。
170
171  | 枚举值 | 描述 |
172| -------- | -------- |
173| AUDIO_CHANNEL_NORMAL | 正常模式,不做处理。 |
174| AUDIO_CHANNEL_BOTH_LEFT | 两个声道全部为左声道声音。 |
175| AUDIO_CHANNEL_BOTH_RIGHT | 两个声道全部为右声道声音。 |
176| AUDIO_CHANNEL_EXCHANGE | 左右声道数据互换,左声道为右声道声音,右声道为左声道声音。 |
177| AUDIO_CHANNEL_MIX | 左右两个声道输出为左右声道相加(混音)。 |
178| AUDIO_CHANNEL_LEFT_MUTE | 左声道静音,右声道播放原右声道声音。 |
179| AUDIO_CHANNEL_RIGHT_MUTE | 右声道静音,左声道播放原左声道声音。 |
180| AUDIO_CHANNEL_BOTH_MUTE | 左右声道均静音。 |
181
182
183### AudioDeviceType
184
185
186```
187enum AudioDeviceType
188```
189
190**描述:**
191
192音频设备类型。
193
194  | 枚举值 | 描述 |
195| -------- | -------- |
196| AUDIO_LINEOUT | LINEOUT设备。 |
197| AUDIO_HEADPHONE | 耳机。 |
198| AUDIO_HEADSET | 头戴式耳机。 |
199| AUDIO_USB_HEADSET | USB头戴式耳机。 |
200| AUDIO_USB_HEADPHONE | USB耳机。 |
201| AUDIO_USBA_HEADSET | USB模拟头戴式耳机。 |
202| AUDIO_USBA_HEADPHONE | USB模拟耳机。 |
203| AUDIO_PRIMARY_DEVICE | 主音频设备。 |
204| AUDIO_USB_DEVICE | USB音频设备。 |
205| AUDIO_A2DP_DEVICE | 蓝牙音频设备。 |
206| AUDIO_DEVICE_UNKOWN | 未知设备。 |
207
208
209### AudioDrainNotifyType
210
211
212```
213enum AudioDrainNotifyType
214```
215
216**描述:**
217
218音频数据结束类型。
219
220  | 枚举值 | 描述 |
221| -------- | -------- |
222| AUDIO_DRAIN_NORMAL_MODE | 曲目的所有数据播放完就结束。 |
223| AUDIO_DRAIN_EARLY_MODE | 曲目的所有数据未播放完就结束,以便给音频服务做连续性曲目切换留出时间。 |
224
225
226### AudioEventType
227
228
229```
230enum AudioEventType
231```
232
233**描述:**
234
235音频事件类型。
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_UNKOWN | 未知事件。 |
248
249
250### AudioExtParamKey
251
252
253```
254enum AudioExtParamKey
255```
256
257**描述:**
258
259音频扩展参数键类型。
260
261  | 枚举值 | 描述 |
262| -------- | -------- |
263| AUDIO_EXT_PARAM_KEY_NONE | 分布式音频-无效事件。 |
264| AUDIO_EXT_PARAM_KEY_VOLUME | 分布式音频-音量事件。 |
265| AUDIO_EXT_PARAM_KEY_FOCUS | 分布式音频-焦点事件。 |
266| AUDIO_EXT_PARAM_KEY_BUTTON | 分布式音频-媒体按钮事件。 |
267| AUDIO_EXT_PARAM_KEY_EFFECT | 分布式音频-音频效果事件。 |
268| AUDIO_EXT_PARAM_KEY_STATUS | 分布式音频-设备状态事件。 |
269| AUDIO_EXT_PARAM_KEY_LOWPOWER | 低电量事件。 |
270
271
272### AudioFormat
273
274
275```
276enum AudioFormat
277```
278
279**描述:**
280
281音频格式。
282
283  | 枚举值 | 描述 |
284| -------- | -------- |
285| AUDIO_FORMAT_PCM_8_BIT | 8bit位宽PCM(Pulse&nbsp;Code&nbsp;Modulation)格式。 |
286| AUDIO_FORMAT_PCM_16_BIT | 16bit位宽PCM格式。 |
287| AUDIO_FORMAT_PCM_24_BIT | 24bit位宽PCM格式。 |
288| AUDIO_FORMAT_PCM_32_BIT | 32bit位宽PCM格式。 |
289| AUDIO_FORMAT_AAC_MAIN | AAC(Advanced&nbsp;Audio&nbsp;Coding)&nbsp;MAIN格式。 |
290| AUDIO_FORMAT_AAC_LC | AAC&nbsp;LC格式。 |
291| AUDIO_FORMAT_AAC_LD | AAC&nbsp;LD格式。 |
292| AUDIO_FORMAT_AAC_ELD | AAC&nbsp;ELD格式。 |
293| AUDIO_FORMAT_AAC_HE_V1 | AAC&nbsp;HE_V1格式。 |
294| AUDIO_FORMAT_AAC_HE_V2 | AAC&nbsp;HE_V2格式。 |
295| AUDIO_FORMAT_G711A | PCM&nbsp;G711A格式。 |
296| AUDIO_FORMAT_G711U | PCM&nbsp;G711u格式。 |
297| AUDIO_FORMAT_G726 | PCM&nbsp;G726格式。 |
298
299
300### AudioPortDirection
301
302
303```
304enum AudioPortDirection
305```
306
307**描述:**
308
309音频端口的类型。
310
311  | 枚举值 | 描述 |
312| -------- | -------- |
313| PORT_OUT | 音频输出端口。 |
314| PORT_IN | 音频输入端口。 |
315| PORT_OUT_IN | 音频输出输入端口。 |
316
317
318### AudioPortPassthroughMode
319
320
321```
322enum AudioPortPassthroughMode
323```
324
325**描述:**
326
327音频端口的数据透传模式。
328
329  | 枚举值 | 描述 |
330| -------- | -------- |
331| PORT_PASSTHROUGH_LPCM | 立体声PCM。 |
332| PORT_PASSTHROUGH_RAW | HDMI透传。 |
333| PORT_PASSTHROUGH_HBR2LBR | 蓝光次世代音频降规格输出。 |
334| PORT_PASSTHROUGH_AUTO | 根据HDMI&nbsp;EDID能力自动匹配。 |
335
336
337### AudioPortPin
338
339
340```
341enum AudioPortPin
342```
343
344**描述:**
345
346音频端口上的Pin脚。
347
348  | 枚举值 | 描述 |
349| -------- | -------- |
350| PIN_NONE | 无效端口。 |
351| PIN_OUT_SPEAKER | 喇叭输出。 |
352| PIN_OUT_HEADSET | 有线耳机输出。 |
353| PIN_OUT_LINEOUT | Lineout输出。 |
354| PIN_OUT_HDMI | HDMI输出。 |
355| PIN_IN_MIC | 麦克风输入。 |
356| PIN_IN_HS_MIC | 有线耳机麦克风输入。 |
357| PIN_IN_LINEIN | Linein输入。 |
358| PIN_IN_USB_EXT | USB外部声卡输出。 |
359
360
361### AudioPortRole
362
363
364```
365enum AudioPortRole
366```
367
368**描述:**
369
370音频端口角色。
371
372  | 枚举值 | 描述 |
373| -------- | -------- |
374| AUDIO_PORT_UNASSIGNED_ROLE | 未指定端口角色。 |
375| AUDIO_PORT_SOURCE_ROLE | 指定端口为发送端角色。 |
376| AUDIO_PORT_SINK_ROLE | 指定端口为接受端角色。 |
377
378
379### AudioPortType
380
381
382```
383enum AudioPortType
384```
385
386**描述:**
387
388音频端口类型。
389
390  | 枚举值 | 描述 |
391| -------- | -------- |
392| AUDIO_PORT_UNASSIGNED_TYPE | 未指定端口类型。 |
393| AUDIO_PORT_DEVICE_TYPE | 指定端口为设备类型。 |
394| AUDIO_PORT_MIX_TYPE | 指定端口为复合类型。 |
395| AUDIO_PORT_SESSION_TYPE | 指定端口为会话类型。 |
396
397
398### AudioSampleFormat
399
400
401```
402enum AudioSampleFormat
403```
404
405**描述:**
406
407原始音频样本格式。
408
409| 枚举值 | 描述 |
410| -------- | -------- |
411| AUDIO_SAMPLE_FORMAT_S8 | 8bit位宽有符号交织样本。 |
412| AUDIO_SAMPLE_FORMAT_S8P | 8bit位宽有符号非交织样本。 |
413| AUDIO_SAMPLE_FORMAT_U8 | 8bit位宽无符号交织样本。 |
414| AUDIO_SAMPLE_FORMAT_U8P | 8bit位宽无符号非交织样本。 |
415| AUDIO_SAMPLE_FORMAT_S16 | 16bit位宽有符号交织样本。 |
416| AUDIO_SAMPLE_FORMAT_S16P | 16bit位宽有符号非交织样本。 |
417| AUDIO_SAMPLE_FORMAT_U16 | 16bit位宽无符号交织样本。 |
418| AUDIO_SAMPLE_FORMAT_U16P | 16bit位宽无符号非交织样本。 |
419| AUDIO_SAMPLE_FORMAT_S24 | 24bit位宽有符号交织样本。 |
420| AUDIO_SAMPLE_FORMAT_S24P | 24bit位宽有符号非交织样本。 |
421| AUDIO_SAMPLE_FORMAT_U24 | 24bit位宽无符号交织样本。 |
422| AUDIO_SAMPLE_FORMAT_U24P | 24bit位宽无符号非交织样本。 |
423| AUDIO_SAMPLE_FORMAT_S32 | 32bit位宽有符号交织样本。 |
424| AUDIO_SAMPLE_FORMAT_S32P | 32bit位宽有符号非交织样本。 |
425| AUDIO_SAMPLE_FORMAT_U32 | 32bit位宽无符号交织样本。 |
426| AUDIO_SAMPLE_FORMAT_U32P | 32bit位宽无符号非交织样本。 |
427| AUDIO_SAMPLE_FORMAT_S64 | 64bit位宽有符号交织样本。 |
428| AUDIO_SAMPLE_FORMAT_S64P | 64bit位宽有符号非交织样本。 |
429| AUDIO_SAMPLE_FORMAT_U64 | 64bit位宽无符号交织样本。 |
430| AUDIO_SAMPLE_FORMAT_U64P | 64bit位宽无符号非交织样本。 |
431| AUDIO_SAMPLE_FORMAT_F32 | 32bit位宽浮点型交织样本。 |
432| AUDIO_SAMPLE_FORMAT_F32P | 64bit位宽浮点型非交织样本。 |
433| AUDIO_SAMPLE_FORMAT_F64 | 64bit位宽双精度浮点型交织样本。 |
434| AUDIO_SAMPLE_FORMAT_F64P | 64bit位宽双精度浮点型非交织样本。 |
435
436
437### AudioSampleRatesMask
438
439
440```
441enum AudioSampleRatesMask
442```
443
444**描述:**
445
446音频采样频率掩码。
447
448  | 枚举值 | 描述 |
449| -------- | -------- |
450| AUDIO_SAMPLE_RATE_MASK_8000 | 8K&nbsp;采样频率。 |
451| AUDIO_SAMPLE_RATE_MASK_12000 | 12K&nbsp;采样频率。 |
452| AUDIO_SAMPLE_RATE_MASK_11025 | 11.025K&nbsp;采样频率。 |
453| AUDIO_SAMPLE_RATE_MASK_16000 | 16K&nbsp;采样频率。 |
454| AUDIO_SAMPLE_RATE_MASK_22050 | 22.050K&nbsp;采样频率。 |
455| AUDIO_SAMPLE_RATE_MASK_24000 | 24K&nbsp;采样频率。 |
456| AUDIO_SAMPLE_RATE_MASK_32000 | 32K&nbsp;采样频率。 |
457| AUDIO_SAMPLE_RATE_MASK_44100 | 44.1K&nbsp;采样频率。 |
458| AUDIO_SAMPLE_RATE_MASK_48000 | 48K&nbsp;采样频率。 |
459| AUDIO_SAMPLE_RATE_MASK_64000 | 64K&nbsp;采样频率。 |
460| AUDIO_SAMPLE_RATE_MASK_96000 | 96K&nbsp;采样频率。 |
461| AUDIO_SAMPLE_RATE_MASK_INVALID | 无效的采样频率。 |
462
463
464### AudioSessionType
465
466
467```
468enum AudioSessionType
469```
470
471**描述:**
472
473端口会话类型。
474
475  | 枚举值 | 描述 |
476| -------- | -------- |
477| AUDIO_OUTPUT_STAGE_SESSION | 会话绑定到指定输出流。 |
478| AUDIO_OUTPUT_MIX_SESSION | 会话绑定到特定音轨。 |
479| AUDIO_ALLOCATE_SESSION | 会话ID需重新申请。 |
480| AUDIO_INVALID_SESSION | 无效会话类型。 |
481