Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
f22debef
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
f22debef
编写于
6月 25, 2022
作者:
J
jiao_yanlin
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Audio management module description modification
Signed-off-by:
N
jiao_yanlin
<
jiaoyanlin@huawei.com
>
上级
c16715fd
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
35 addition
and
9 deletion
+35
-9
zh-cn/application-dev/reference/apis/js-apis-audio.md
zh-cn/application-dev/reference/apis/js-apis-audio.md
+35
-9
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-audio.md
浏览文件 @
f22debef
# 音频管理
# 音频管理
> **说明:**
音频管理提供管理音频的一些基础能力,包括对音频音量、音频设备的管理,以及对音频数据的采集和渲染等。
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
该模块提供以下音频相关的常用功能:
该模块提供以下音频相关的常用功能:
...
@@ -9,6 +8,9 @@
...
@@ -9,6 +8,9 @@
-
[
AudioRenderer
](
#audiorenderer8
)
:音频渲染,用于播放PCM(Pulse Code Modulation)音频数据。
-
[
AudioRenderer
](
#audiorenderer8
)
:音频渲染,用于播放PCM(Pulse Code Modulation)音频数据。
-
[
AudioCapturer
](
#audiocapturer8
)
:音频采集,用于录制PCM音频数据。
-
[
AudioCapturer
](
#audiocapturer8
)
:音频采集,用于录制PCM音频数据。
> **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
## 导入模块
```
```
...
@@ -560,7 +562,7 @@ audio.createAudioCapturer(audioCapturerOptions).then((data) => {
...
@@ -560,7 +562,7 @@ audio.createAudioCapturer(audioCapturerOptions).then((data) => {
音量改变时,应用接收的事件。
音量改变时,应用接收的事件。
此接口为系统接口,三方应用不支持。
此接口为系统接口,三方应用不支持
调用
。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.Multimedia.Audio.Volume
**系统能力:**
以下各项对应的系统能力均为SystemCapability.Multimedia.Audio.Volume
...
@@ -635,8 +637,8 @@ audio.createAudioCapturer(audioCapturerOptions).then((data) => {
...
@@ -635,8 +637,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
...
@@ -649,6 +651,8 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l
...
@@ -649,6 +651,8 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l
设置指定流的音量,使用callback方式异步返回结果。
设置指定流的音量,使用callback方式异步返回结果。
**需要权限:**
ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力:**
SystemCapability.Multimedia.Audio.Volume
**系统能力:**
SystemCapability.Multimedia.Audio.Volume
**参数:**
**参数:**
...
@@ -677,6 +681,8 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise<void>
...
@@ -677,6 +681,8 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise<void>
设置指定流的音量,使用Promise方式异步返回结果。
设置指定流的音量,使用Promise方式异步返回结果。
**需要权限:**
ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力:**
SystemCapability.Multimedia.Audio.Volume
**系统能力:**
SystemCapability.Multimedia.Audio.Volume
**参数:**
**参数:**
...
@@ -1041,6 +1047,8 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback<void>): void
...
@@ -1041,6 +1047,8 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback<void>): void
设置铃声模式,使用callback方式异步返回结果。
设置铃声模式,使用callback方式异步返回结果。
**需要权限:**
ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
**参数:**
**参数:**
...
@@ -1068,6 +1076,8 @@ setRingerMode(mode: AudioRingMode): Promise<void>
...
@@ -1068,6 +1076,8 @@ setRingerMode(mode: AudioRingMode): Promise<void>
设置铃声模式,使用Promise方式异步返回结果。
设置铃声模式,使用Promise方式异步返回结果。
**需要权限:**
ohos.permission.ACCESS_NOTIFICATION_POLICY
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
**参数:**
**参数:**
...
@@ -1148,6 +1158,8 @@ setAudioParameter(key: string, value: string, callback: AsyncCallback<void>
...
@@ -1148,6 +1158,8 @@ setAudioParameter(key: string, value: string, callback: AsyncCallback<void>
本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上,所支持的音频参数会存在差异。示例代码内使用样例参数,实际支持的音频配置参数见具体设备平台的资料描述。
本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上,所支持的音频参数会存在差异。示例代码内使用样例参数,实际支持的音频配置参数见具体设备平台的资料描述。
**需要权限:**
ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力:**
SystemCapability.Multimedia.Audio.Core
**系统能力:**
SystemCapability.Multimedia.Audio.Core
**参数:**
**参数:**
...
@@ -1178,6 +1190,8 @@ setAudioParameter(key: string, value: string): Promise<void>
...
@@ -1178,6 +1190,8 @@ setAudioParameter(key: string, value: string): Promise<void>
本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上,所支持的音频参数会存在差异。示例代码内使用样例参数,实际支持的音频配置参数见具体设备平台的资料描述。
本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上,所支持的音频参数会存在差异。示例代码内使用样例参数,实际支持的音频配置参数见具体设备平台的资料描述。
**需要权限:**
ohos.permission.MODIFY_AUDIO_SETTINGS
**系统能力:**
SystemCapability.Multimedia.Audio.Core
**系统能力:**
SystemCapability.Multimedia.Audio.Core
**参数:**
**参数:**
...
@@ -1434,6 +1448,8 @@ setMicrophoneMute(mute: boolean, callback: AsyncCallback<void>): void
...
@@ -1434,6 +1448,8 @@ setMicrophoneMute(mute: boolean, callback: AsyncCallback<void>): void
设置麦克风静音状态,使用callback方式异步返回结果。
设置麦克风静音状态,使用callback方式异步返回结果。
**需要权限:**
ohos.permission.MICROPHONE
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**参数:**
**参数:**
...
@@ -1461,6 +1477,8 @@ setMicrophoneMute(mute: boolean): Promise<void>
...
@@ -1461,6 +1477,8 @@ setMicrophoneMute(mute: boolean): Promise<void>
设置麦克风静音状态,使用Promise方式异步返回结果。
设置麦克风静音状态,使用Promise方式异步返回结果。
**需要权限:**
ohos.permission.MICROPHONE
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**参数:**
**参数:**
...
@@ -1489,6 +1507,8 @@ isMicrophoneMute(callback: AsyncCallback<boolean>): void
...
@@ -1489,6 +1507,8 @@ isMicrophoneMute(callback: AsyncCallback<boolean>): void
获取麦克风静音状态,使用callback方式异步返回结果。
获取麦克风静音状态,使用callback方式异步返回结果。
**需要权限:**
ohos.permission.MICROPHONE
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**参数:**
**参数:**
...
@@ -1515,6 +1535,8 @@ isMicrophoneMute(): Promise<boolean>
...
@@ -1515,6 +1535,8 @@ isMicrophoneMute(): Promise<boolean>
获取麦克风静音状态,使用Promise方式异步返回结果。
获取麦克风静音状态,使用Promise方式异步返回结果。
**需要权限:**
ohos.permission.MICROPHONE
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**返回值:**
**返回值:**
...
@@ -1538,7 +1560,7 @@ on(type: 'volumeChange', callback: Callback\<VolumeEvent>): void
...
@@ -1538,7 +1560,7 @@ on(type: 'volumeChange', callback: Callback\<VolumeEvent>): void
监听系统音量变化事件。
监听系统音量变化事件。
此接口为系统接口,三方应用不支持。
此接口为系统接口,三方应用不支持
调用
。
**系统能力:**
SystemCapability.Multimedia.Audio.Volume
**系统能力:**
SystemCapability.Multimedia.Audio.Volume
...
@@ -1565,7 +1587,7 @@ on(type: 'ringerModeChange', callback: Callback\<AudioRingMode>): void
...
@@ -1565,7 +1587,7 @@ on(type: 'ringerModeChange', callback: Callback\<AudioRingMode>): void
监听铃声模式变化事件。
监听铃声模式变化事件。
此接口为系统接口,三方应用不支持。
此接口为系统接口,三方应用不支持
调用
。
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
...
@@ -1590,6 +1612,8 @@ on(type: 'deviceChange', callback: Callback<DeviceChangeAction\>): void
...
@@ -1590,6 +1612,8 @@ on(type: 'deviceChange', callback: Callback<DeviceChangeAction\>): void
设备更改。音频设备连接状态变化。
设备更改。音频设备连接状态变化。
此接口为系统接口,三方应用不支持调用。
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**系统能力:**
SystemCapability.Multimedia.Audio.Device
**参数:**
**参数:**
...
@@ -1639,6 +1663,8 @@ on(type: 'interrupt', interrupt: AudioInterrupt, callback: Callback\<InterruptAc
...
@@ -1639,6 +1663,8 @@ on(type: 'interrupt', interrupt: AudioInterrupt, callback: Callback\<InterruptAc
请求焦点并开始监听音频打断事件(当应用程序的音频被另一个播放事件中断,回调通知此应用程序)
请求焦点并开始监听音频打断事件(当应用程序的音频被另一个播放事件中断,回调通知此应用程序)
此接口为系统接口,三方应用不支持调用。
**系统能力:**
SystemCapability.Multimedia.Audio.Renderer
**系统能力:**
SystemCapability.Multimedia.Audio.Renderer
**参数:**
**参数:**
...
@@ -1707,7 +1733,7 @@ setAudioScene\(scene: AudioScene, callback: AsyncCallback<void\>\): void
...
@@ -1707,7 +1733,7 @@ setAudioScene\(scene: AudioScene, callback: AsyncCallback<void\>\): void
设置音频场景模式,使用callback方式异步返回结果。
设置音频场景模式,使用callback方式异步返回结果。
此接口为系统接口,三方应用不支持。
此接口为系统接口,三方应用不支持
调用
。
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
**系统能力:**
SystemCapability.Multimedia.Audio.Communication
...
@@ -1736,7 +1762,7 @@ setAudioScene\(scene: AudioScene\): Promise<void\>
...
@@ -1736,7 +1762,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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录