Skip to content

D
Docs

Coping0606 / Docs
与 Fork 源项目一致

Fork自 OpenHarmony / Docs

通知 1
Star 1
Fork 0
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

未验证 提交 6d15cb35 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!5984 master修改同步到release分支 

Merge pull request !5984 from 一杯丞丞汁儿/OpenHarmony-3.1-Release
上级 a4b4c216 0ec7e0a7
隐藏空白更改
内联 并排
Showing with 37 addition and 11 deletion
zh-cn/application-dev/reference/apis/js-apis-audio.md
浏览文件 @ 6d15cb35
# 音频管理 # 音频管理
> **说明：** 音频管理提供管理音频的一些基础能力，包括对音频音量、音频设备的管理，以及对音频数据的采集和渲染等。
> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
>
> API Version 9当前为Canary版本，仅供试用，不保证接口可稳定调用。
该模块提供以下音频相关的常用功能： 该模块提供以下音频相关的常用功能：
...@@ -11,6 +8,11 @@ ...@@ -11,6 +8,11 @@
- [AudioRenderer](#audiorenderer8)：音频渲染，用于播放PCM（Pulse Code Modulation）音频数据。 - [AudioRenderer](#audiorenderer8)：音频渲染，用于播放PCM（Pulse Code Modulation）音频数据。
- [AudioCapturer](#audiocapturer8)：音频采集，用于录制PCM音频数据。 - [AudioCapturer](#audiocapturer8)：音频采集，用于录制PCM音频数据。
> **说明：**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
>
> API Version 9当前为Canary版本，仅供试用，不保证接口可稳定调用。
## 导入模块 ## 导入模块
``` ```
...@@ -551,7 +553,7 @@ audio.createAudioCapturer(audioCapturerOptions).then((data) => { ...@@ -551,7 +553,7 @@ audio.createAudioCapturer(audioCapturerOptions).then((data) => {
音量改变时，应用接收的事件。 音量改变时，应用接收的事件。
此接口为系统接口，三方应用不支持。 此接口为系统接口，三方应用不支持调用。
**系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Audio.Volume **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.Audio.Volume
...@@ -626,8 +628,8 @@ audio.createAudioCapturer(audioCapturerOptions).then((data) => { ...@@ -626,8 +628,8 @@ audio.createAudioCapturer(audioCapturerOptions).then((data) => {
| 名称 | 默认值 | 描述 | | 名称 | 默认值 | 描述 |
| :--------------------- | :----- | :-------------------------------------------- | | :--------------------- | :----- | :-------------------------------------------- |
| AUDIO_SCENE_DEFAULT | 0 | 默认音频场景。 | | AUDIO_SCENE_DEFAULT | 0 | 默认音频场景。 |
| AUDIO_SCENE_RINGING | 1 | 响铃模式。<br/>系统接口，三方应用不支持调用。 | | AUDIO_SCENE_RINGING | 1 | 响铃模式。<br/>此接口为系统接口，三方应用不支持调用。 |
| AUDIO_SCENE_PHONE_CALL | 2 | 电话模式。<br/>系统接口，三方应用不支持调用。 | | AUDIO_SCENE_PHONE_CALL | 2 | 电话模式。<br/>此接口为系统接口，三方应用不支持调用。 |
| AUDIO_SCENE_VOICE_CHAT | 3 | 语音聊天模式。 | | AUDIO_SCENE_VOICE_CHAT | 3 | 语音聊天模式。 |
## AudioManager ## AudioManager
...@@ -640,6 +642,8 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l ...@@ -640,6 +642,8 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l
设置指定流的音量，使用callback方式异步返回结果。 设置指定流的音量，使用callback方式异步返回结果。
**需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力：** SystemCapability.Multimedia.Audio.Volume **系统能力：** SystemCapability.Multimedia.Audio.Volume
**参数：** **参数：**
...@@ -668,6 +672,8 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise&lt;void&gt; ...@@ -668,6 +672,8 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise&lt;void&gt;
设置指定流的音量，使用Promise方式异步返回结果。 设置指定流的音量，使用Promise方式异步返回结果。
**需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力：** SystemCapability.Multimedia.Audio.Volume **系统能力：** SystemCapability.Multimedia.Audio.Volume
**参数：** **参数：**
...@@ -1032,6 +1038,8 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback&lt;void&gt;): void ...@@ -1032,6 +1038,8 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback&lt;void&gt;): void
设置铃声模式，使用callback方式异步返回结果。 设置铃声模式，使用callback方式异步返回结果。
**需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力：** SystemCapability.Multimedia.Audio.Communication **系统能力：** SystemCapability.Multimedia.Audio.Communication
**参数：** **参数：**
...@@ -1059,6 +1067,8 @@ setRingerMode(mode: AudioRingMode): Promise&lt;void&gt; ...@@ -1059,6 +1067,8 @@ setRingerMode(mode: AudioRingMode): Promise&lt;void&gt;
设置铃声模式，使用Promise方式异步返回结果。 设置铃声模式，使用Promise方式异步返回结果。
**需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力：** SystemCapability.Multimedia.Audio.Communication **系统能力：** SystemCapability.Multimedia.Audio.Communication
**参数：** **参数：**
...@@ -1139,6 +1149,8 @@ setAudioParameter(key: string, value: string, callback: AsyncCallback&lt;void&gt ...@@ -1139,6 +1149,8 @@ setAudioParameter(key: string, value: string, callback: AsyncCallback&lt;void&gt
本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上，所支持的音频参数会存在差异。示例代码内使用样例参数，实际支持的音频配置参数见具体设备平台的资料描述。 本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上，所支持的音频参数会存在差异。示例代码内使用样例参数，实际支持的音频配置参数见具体设备平台的资料描述。
**需要权限：** ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力：** SystemCapability.Multimedia.Audio.Core **系统能力：** SystemCapability.Multimedia.Audio.Core
**参数：** **参数：**
...@@ -1169,6 +1181,8 @@ setAudioParameter(key: string, value: string): Promise&lt;void&gt; ...@@ -1169,6 +1181,8 @@ setAudioParameter(key: string, value: string): Promise&lt;void&gt;
本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上，所支持的音频参数会存在差异。示例代码内使用样例参数，实际支持的音频配置参数见具体设备平台的资料描述。 本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上，所支持的音频参数会存在差异。示例代码内使用样例参数，实际支持的音频配置参数见具体设备平台的资料描述。
**需要权限：** ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力：** SystemCapability.Multimedia.Audio.Core **系统能力：** SystemCapability.Multimedia.Audio.Core
**参数：** **参数：**
...@@ -1425,6 +1439,8 @@ setMicrophoneMute(mute: boolean, callback: AsyncCallback&lt;void&gt;): void ...@@ -1425,6 +1439,8 @@ setMicrophoneMute(mute: boolean, callback: AsyncCallback&lt;void&gt;): void
设置麦克风静音状态，使用callback方式异步返回结果。 设置麦克风静音状态，使用callback方式异步返回结果。
**需要权限：** ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力：** SystemCapability.Multimedia.Audio.Device **系统能力：** SystemCapability.Multimedia.Audio.Device
**参数：** **参数：**
...@@ -1452,6 +1468,8 @@ setMicrophoneMute(mute: boolean): Promise&lt;void&gt; ...@@ -1452,6 +1468,8 @@ setMicrophoneMute(mute: boolean): Promise&lt;void&gt;
设置麦克风静音状态，使用Promise方式异步返回结果。 设置麦克风静音状态，使用Promise方式异步返回结果。
**需要权限：** ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力：** SystemCapability.Multimedia.Audio.Device **系统能力：** SystemCapability.Multimedia.Audio.Device
**参数：** **参数：**
...@@ -1480,6 +1498,8 @@ isMicrophoneMute(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -1480,6 +1498,8 @@ isMicrophoneMute(callback: AsyncCallback&lt;boolean&gt;): void
获取麦克风静音状态，使用callback方式异步返回结果。 获取麦克风静音状态，使用callback方式异步返回结果。
**需要权限：** ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力：** SystemCapability.Multimedia.Audio.Device **系统能力：** SystemCapability.Multimedia.Audio.Device
**参数：** **参数：**
...@@ -1506,6 +1526,8 @@ isMicrophoneMute(): Promise&lt;boolean&gt; ...@@ -1506,6 +1526,8 @@ isMicrophoneMute(): Promise&lt;boolean&gt;
获取麦克风静音状态，使用Promise方式异步返回结果。 获取麦克风静音状态，使用Promise方式异步返回结果。
**需要权限：** ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力：** SystemCapability.Multimedia.Audio.Device **系统能力：** SystemCapability.Multimedia.Audio.Device
**返回值：** **返回值：**
...@@ -1529,7 +1551,7 @@ on(type: 'volumeChange', callback: Callback\<VolumeEvent>): void ...@@ -1529,7 +1551,7 @@ on(type: 'volumeChange', callback: Callback\<VolumeEvent>): void
监听系统音量变化事件。 监听系统音量变化事件。
此接口为系统接口，三方应用不支持。 此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.Multimedia.Audio.Volume **系统能力：** SystemCapability.Multimedia.Audio.Volume
...@@ -1556,7 +1578,7 @@ on(type: 'ringerModeChange', callback: Callback\<AudioRingMode>): void ...@@ -1556,7 +1578,7 @@ on(type: 'ringerModeChange', callback: Callback\<AudioRingMode>): void
监听铃声模式变化事件。 监听铃声模式变化事件。
此接口为系统接口，三方应用不支持。 此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.Multimedia.Audio.Communication **系统能力：** SystemCapability.Multimedia.Audio.Communication
...@@ -1581,6 +1603,8 @@ on(type: 'deviceChange', callback: Callback<DeviceChangeAction\>): void ...@@ -1581,6 +1603,8 @@ on(type: 'deviceChange', callback: Callback<DeviceChangeAction\>): void
设备更改。音频设备连接状态变化。 设备更改。音频设备连接状态变化。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.Multimedia.Audio.Device **系统能力：** SystemCapability.Multimedia.Audio.Device
**参数：** **参数：**
...@@ -1630,6 +1654,8 @@ on(type: 'interrupt', interrupt: AudioInterrupt, callback: Callback\<InterruptAc ...@@ -1630,6 +1654,8 @@ on(type: 'interrupt', interrupt: AudioInterrupt, callback: Callback\<InterruptAc
请求焦点并开始监听音频打断事件（当应用程序的音频被另一个播放事件中断，回调通知此应用程序） 请求焦点并开始监听音频打断事件（当应用程序的音频被另一个播放事件中断，回调通知此应用程序）
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.Multimedia.Audio.Renderer **系统能力：** SystemCapability.Multimedia.Audio.Renderer
**参数：** **参数：**
...@@ -1698,7 +1724,7 @@ setAudioScene\(scene: AudioScene, callback: AsyncCallback<void\>\): void ...@@ -1698,7 +1724,7 @@ setAudioScene\(scene: AudioScene, callback: AsyncCallback<void\>\): void
设置音频场景模式，使用callback方式异步返回结果。 设置音频场景模式，使用callback方式异步返回结果。
此接口为系统接口，三方应用不支持。 此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.Multimedia.Audio.Communication **系统能力：** SystemCapability.Multimedia.Audio.Communication
...@@ -1727,7 +1753,7 @@ setAudioScene\(scene: AudioScene\): Promise<void\> ...@@ -1727,7 +1753,7 @@ setAudioScene\(scene: AudioScene\): Promise<void\>
设置音频场景模式，使用Promise方式返回异步结果。 设置音频场景模式，使用Promise方式返回异步结果。
此接口为系统接口，三方应用不支持。 此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.Multimedia.Audio.Communication **系统能力：** SystemCapability.Multimedia.Audio.Communication
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或