diff --git a/zh-cn/application-dev/reference/apis/js-apis-audio.md b/zh-cn/application-dev/reference/apis/js-apis-audio.md index eee92c87d2eab4d8029ea29a476e73a0ce59698a..289eb02790c7f55497975fb432074f6e77ade327 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-audio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-audio.md @@ -1,7 +1,6 @@ # 音频管理 -> **说明:** -> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 +音频管理提供管理音频的一些基础能力,包括对音频音量、音频设备的管理,以及对音频数据的采集和渲染等。 该模块提供以下音频相关的常用功能: @@ -9,6 +8,9 @@ - [AudioRenderer](#audiorenderer8):音频渲染,用于播放PCM(Pulse Code Modulation)音频数据。 - [AudioCapturer](#audiocapturer8):音频采集,用于录制PCM音频数据。 +> **说明:** +> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 + ## 导入模块 ``` @@ -549,7 +551,7 @@ audio.createAudioRenderer(audioCapturerOptions).then((data) => { 音量改变时,应用接收的事件。 -此接口为系统接口,三方应用不支持。 +此接口为系统接口,三方应用不支持调用。 **系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Audio.Volume @@ -624,8 +626,8 @@ audio.createAudioRenderer(audioCapturerOptions).then((data) => { | 名称 | 默认值 | 描述 | | :--------------------- | :----- | :-------------------------------------------- | | AUDIO_SCENE_DEFAULT | 0 | 默认音频场景。 | -| AUDIO_SCENE_RINGING | 1 | 响铃模式。
系统接口,三方应用不支持调用。 | -| AUDIO_SCENE_PHONE_CALL | 2 | 电话模式。
系统接口,三方应用不支持调用。 | +| AUDIO_SCENE_RINGING | 1 | 响铃模式。
此接口为系统接口,三方应用不支持调用。 | +| AUDIO_SCENE_PHONE_CALL | 2 | 电话模式。
此接口为系统接口,三方应用不支持调用。 | | AUDIO_SCENE_VOICE_CHAT | 3 | 语音聊天模式。 | ## AudioManager @@ -638,6 +640,8 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l 设置指定流的音量,使用callback方式异步返回结果。 +**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY + **系统能力:** SystemCapability.Multimedia.Audio.Volume **参数:** @@ -666,6 +670,8 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise<void> 设置指定流的音量,使用Promise方式异步返回结果。 +**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY + **系统能力:** SystemCapability.Multimedia.Audio.Volume **参数:** @@ -1030,6 +1036,8 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback<void>): void 设置铃声模式,使用callback方式异步返回结果。 +**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY + **系统能力:** SystemCapability.Multimedia.Audio.Communication **参数:** @@ -1057,6 +1065,8 @@ setRingerMode(mode: AudioRingMode): Promise<void> 设置铃声模式,使用Promise方式异步返回结果。 +**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY + **系统能力:** SystemCapability.Multimedia.Audio.Communication **参数:** @@ -1137,6 +1147,8 @@ setAudioParameter(key: string, value: string, callback: AsyncCallback<void> 本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上,所支持的音频参数会存在差异。示例代码内使用样例参数,实际支持的音频配置参数见具体设备平台的资料描述。 +**需要权限:** ohos.permission.MODIFY_AUDIO_SETTINGS + **系统能力:** SystemCapability.Multimedia.Audio.Core **参数:** @@ -1167,6 +1179,8 @@ setAudioParameter(key: string, value: string): Promise<void> 本接口的使用场景为根据硬件设备支持能力扩展音频配置。在不同的设备平台上,所支持的音频参数会存在差异。示例代码内使用样例参数,实际支持的音频配置参数见具体设备平台的资料描述。 +**需要权限:** ohos.permission.MODIFY_AUDIO_SETTINGS + **系统能力:** SystemCapability.Multimedia.Audio.Core **参数:** @@ -1423,6 +1437,8 @@ setMicrophoneMute(mute: boolean, callback: AsyncCallback<void>): void 设置麦克风静音状态,使用callback方式异步返回结果。 +**需要权限:** ohos.permission.MICROPHONE + **系统能力:** SystemCapability.Multimedia.Audio.Device **参数:** @@ -1450,6 +1466,8 @@ setMicrophoneMute(mute: boolean): Promise<void> 设置麦克风静音状态,使用Promise方式异步返回结果。 +**需要权限:** ohos.permission.MICROPHONE + **系统能力:** SystemCapability.Multimedia.Audio.Device **参数:** @@ -1478,6 +1496,8 @@ isMicrophoneMute(callback: AsyncCallback<boolean>): void 获取麦克风静音状态,使用callback方式异步返回结果。 +**需要权限:** ohos.permission.MICROPHONE + **系统能力:** SystemCapability.Multimedia.Audio.Device **参数:** @@ -1504,6 +1524,8 @@ isMicrophoneMute(): Promise<boolean> 获取麦克风静音状态,使用Promise方式异步返回结果。 +**需要权限:** ohos.permission.MICROPHONE + **系统能力:** SystemCapability.Multimedia.Audio.Device **返回值:** @@ -1527,7 +1549,7 @@ on(type: 'volumeChange', callback: Callback\): void 监听系统音量变化事件。 -此接口为系统接口,三方应用不支持。 +此接口为系统接口,三方应用不支持调用。 **系统能力:** SystemCapability.Multimedia.Audio.Volume @@ -1554,7 +1576,7 @@ on(type: 'ringerModeChange', callback: Callback\): void 监听铃声模式变化事件。 -此接口为系统接口,三方应用不支持。 +此接口为系统接口,三方应用不支持调用。 **系统能力:** SystemCapability.Multimedia.Audio.Communication @@ -1579,6 +1601,8 @@ on(type: 'deviceChange', callback: Callback): void 设备更改。音频设备连接状态变化。 +此接口为系统接口,三方应用不支持调用。 + **系统能力:** SystemCapability.Multimedia.Audio.Device **参数:** @@ -1628,6 +1652,8 @@ on(type: 'interrupt', interrupt: AudioInterrupt, callback: Callback\\): void 设置音频场景模式,使用callback方式异步返回结果。 -此接口为系统接口,三方应用不支持。 +此接口为系统接口,三方应用不支持调用。 **系统能力:** SystemCapability.Multimedia.Audio.Communication @@ -1725,7 +1751,7 @@ setAudioScene\(scene: AudioScene\): Promise 设置音频场景模式,使用Promise方式返回异步结果。 -此接口为系统接口,三方应用不支持。 +此接口为系统接口,三方应用不支持调用。 **系统能力:** SystemCapability.Multimedia.Audio.Communication