update

Signed-off-by: NQin Peng <qinpeng8@huawei.com>

zh-cn/application-dev/media/Readme-CN.md

@@ -11,8 +11,8 @@
     - [使用OpenSL ES开发音频播放功能](using-opensl-es-for-playback.md)
     - [使用TonePlayer开发音频播放功能（仅对系统应用开放）](using-toneplayer-for-playback.md)
     - [多音频播放的并发策略](audio-playback-concurrency.md)
-    - [播放音效管理](audio-effect-management.md)
     - [播放音量管理](volume-management.md)
+    - [音效管理](audio-effect-management.md)
     - [音频播放流管理](audio-playback-stream-management.md)
     - [音频输出设备管理](audio-output-device-management.md)
     - [分布式音频播放（仅对系统应用开放）](distributed-audio-playback.md)

zh-cn/application-dev/media/audio-effect-management.md

-# 播放音效管理
-
-播放音效的管理主要包括查询和设置当前音频播放流的音效模式，音效模式包括EFFECT_NONE关闭音效模式和EFFECT_DEFAULT默认音效模式。默认音效模式会根据创建音频流的ContentType和UsageType自动加载对应场景的音效。
-
-## 获取音效管理接口
-
-管理播放音效的接口是getAudioEffectMode()查询当前音频播放流的音效模式和setAudioEffectMode(mode: AudioEffectMode)设置当前音频播放流的音效模式，在使用之前，需要使用createAudioRenderer(options: AudioRendererOptions)先创建音频播放流AudioRenderer实例。
-
-```ts
-import audio from '@ohos.multimedia.audio';
-```
-
-1. 配置音频渲染参数并创建AudioRenderer实例，音频渲染参数的详细信息可以查看[AudioRendererOptions](../reference/apis/js-apis-audio.md#audiorendereroptions8)，创建AudioRenderer实例时会默认挂在EFFECT_DEFAULT模式音效。
-
-```ts
-let audioStreamInfo = {
-  samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
-  channels: audio.AudioChannel.CHANNEL_1,
-  sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
-  encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
-};
-
-let audioRendererInfo = {
-  content: audio.ContentType.CONTENT_TYPE_SPEECH,
-  usage: audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION,
-  rendererFlags: 0
-};
-
-let audioRendererOptions = {
-  streamInfo: audioStreamInfo,
-  rendererInfo: audioRendererInfo
-};
-
-audio.createAudioRenderer(audioRendererOptions, (err, data) => {
-  if (err) {
-    console.error(`Invoke createAudioRenderer failed, code is ${err.code}, message is ${err.message}`);
-    return;
-  } else {
-    console.info('Invoke createAudioRenderer succeeded.');
-    let audioRenderer = data;
-  }
-});
-```
+# 音效管理
+
+音效管理主要包括播放实例音效管理和静态音效管理，播放实例音效管理主要包括查询和设置当前音频播放流的音效模式，静态音效管理支持查询StreamUsage对应场景支持的音效模式。
+
+## 播放实例音效管理
+
+主要包括查询和设置当前音频播放流的音效模式，音效模式包括EFFECT_NONE关闭音效模式和EFFECT_DEFAULT默认音效模式。默认音效模式会根据创建音频流的StreamUsage自动加载对应场景的音效。
+
+### 获取播放实例
+
+管理播放实例音效的接口是getAudioEffectMode()查询当前音频播放流的音效模式和setAudioEffectMode(mode: AudioEffectMode)设置当前音频播放流的音效模式，在使用之前，需要使用createAudioRenderer(options: AudioRendererOptions)先创建音频播放流AudioRenderer实例。
+
+1. 步骤一：导入音频接口。
+
+  ```ts
+  import audio from '@ohos.multimedia.audio';
+  ```
+
+2. 步骤二：配置音频渲染参数并创建AudioRenderer实例，音频渲染参数的详细信息可以查看[AudioRendererOptions](../reference/apis/js-apis-audio.md#audiorendereroptions8)，创建AudioRenderer实例时会默认挂载EFFECT_DEFAULT模式音效。
+
+  ```ts
+  let audioStreamInfo = {
+    samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
+    channels: audio.AudioChannel.CHANNEL_1,
+    sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
+    encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
+  };
+
+  let audioRendererInfo = {
+    content: audio.ContentType.CONTENT_TYPE_SPEECH,
+    usage: audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION,
+    rendererFlags: 0
+  };
+
+  let audioRendererOptions = {
+    streamInfo: audioStreamInfo,
+    rendererInfo: audioRendererInfo
+  };
+
+  audio.createAudioRenderer(audioRendererOptions, (err, data) => {
+    if (err) {
+      console.error(`Invoke createAudioRenderer failed, code is ${err.code}, message is ${err.message}`);
+      return;
+    } else {
+      console.info('Invoke createAudioRenderer succeeded.');
+      let audioRenderer = data;
+    }
+  });
+  ```
 
 ### 查询当前播放实例的音效模式
 
-```ts
-audioRenderer.getAudioEffectMode((err, effectmode) => {
-  if (err) {
-    console.error(`Failed to get params, code is ${err.code}, message is ${err.message}`);
-    return;    
-  } else {
-    console.info(`getAudioEffectMode: ${effectmode}`);
-  }
-});
-```
+  ```ts
+  audioRenderer.getAudioEffectMode((err, effectmode) => {
+    if (err) {
+      console.error(`Failed to get params, code is ${err.code}, message is ${err.message}`);
+      return;    
+    } else {
+      console.info(`getAudioEffectMode: ${effectmode}`);
+    }
+  });
+  ```
 
 ### 设置当前播放实例的音效模式
 
 关闭系统音效：
 
-```ts
-audioRenderer.setAudioEffectMode(audio.AudioEffectMode.EFFECT_NONE, (err) => {
-  if (err) {
-    console.error(`Failed to set params, code is ${err.code}, message is ${err.message}`);
-    return;
-  } else {
-    console.info('Callback invoked to indicate a successful audio effect mode setting.');
-  }
-});
-```
+  ```ts
+  audioRenderer.setAudioEffectMode(audio.AudioEffectMode.EFFECT_NONE, (err) => {
+    if (err) {
+      console.error(`Failed to set params, code is ${err.code}, message is ${err.message}`);
+      return;
+    } else {
+      console.info('Callback invoked to indicate a successful audio effect mode setting.');
+    }
+  });
+  ```
 
 开启系统音效默认模式：
 
-```ts
-audioRenderer.setAudioEffectMode(audio.AudioEffectMode.EFFECT_DEFAULT, (err) => {
-  if (err) {
-    console.error(`Failed to set params, code is ${err.code}, message is ${err.message}`);
-    return;
-  } else {
-    console.info('Callback invoked to indicate a successful audio effect mode setting.');
-  }
-});
-```
+  ```ts
+  audioRenderer.setAudioEffectMode(audio.AudioEffectMode.EFFECT_DEFAULT, (err) => {
+    if (err) {
+      console.error(`Failed to set params, code is ${err.code}, message is ${err.message}`);
+      return;
+    } else {
+      console.info('Callback invoked to indicate a successful audio effect mode setting.');
+    }
+  });
+  ```
+
+## 静态音效管理
+
+主要包括XXX。
+
+### 获取XXX接口
+
+管理播放实例音效的接口XXX。
+
+### 查询当前XXX音效模式

zh-cn/application-dev/reference/apis/js-apis-audio.md

@@ -550,16 +550,6 @@ async function createTonePlayerBefore(){
 | STREAM_USAGE_NOTIFICATION_RINGTONE        | 6      | 通知铃声。 |
 | STREAM_USAGE_ACCESSIBILITY<sup>10+</sup>  | 8     | 无障碍。   |
 | STREAM_USAGE_SYSTEM<sup>10+</sup>         | 9     | 系统音(如屏幕锁定或按键音)。<br/>此接口为系统接口。 |
-## AudioEffectMode
-
-枚举，音效模式。
-
-**系统能力：** SystemCapability.Multimedia.Audio.Renderer
-
-| 名称                                      |  值    | 说明        |
-| ------------------------------------------| ------ | ---------- |
-| EFFECT_NONE                               | 0      | 直通音效。  |
-| EFFECT_DEFAULT                            | 1      | 默认音效。  |
 
 ## InterruptRequestType<sup>9+</sup>