提交 a25e4682 编写于 作者: Q Qin Peng

update

Signed-off-by: NQin Peng <qinpeng8@huawei.com>
上级 8ef906ab
# 音效管理 # 音效管理
音效管理主要包括播放实例音效管理和全局音效查询两部分,播放实例音效管理主要包括查询和设置当前音频播放流的音效模式,全局音效查询支持查询StreamUsage对应场景支持的音效模式。 音效管理主要包括播放实例音效管理和全局音效查询两部分,播放实例音效管理主要包括查询和设置当前音频播放流的音效模式,全局音效查询支持查询ContentType和StreamUsage对应场景支持的音效模式。
## 播放实例音效管理 ## 播放实例音效管理
...@@ -91,8 +91,8 @@ ...@@ -91,8 +91,8 @@
## 全局查询音效模式 ## 全局查询音效模式
主要包括查询StreamUsage对应场景支持的音效模式。 主要包括全局音效查询相应ContentType和StreamUsage对应场景的音效模式。
对于播放音频类的应用,开发者需要关注该应用的音频流使用什么音效模式并做出相应的操作,比如音乐App播放时,应选择音乐场景下的模式。在使用查询接口前,开发者需要使用getStreamManager()创建一个AudioStreamManager实例。 对于播放音频类的应用,开发者需要关注该应用的音频流使用什么音效模式并做出相应的操作,比如音乐App播放时,应选择音乐场景下的模式。在使用查询接口前,开发者需要使用getStreamManager()创建一个AudioStreamManager音频流管理实例。
### 获取音频流管理接口 ### 获取音频流管理接口
...@@ -107,12 +107,12 @@ ...@@ -107,12 +107,12 @@
### 查询对应场景的音效模式 ### 查询对应场景的音效模式
```ts ```ts
audioStreamManager.getAudioEffectInfoArray(audio.StreamUsage.STREAM_USAGE_UNKNOWN, async (err, AudioEffectInfoArray) => { audioStreamManager.getAudioEffectInfoArray(audio.ContentType.CONTENT_TYPE_MUSIC, audio.StreamUsage.STREAM_USAGE_MEDIA, async (err, audioEffectInfoArray) => {
if (err) { if (err) {
console.error(`Failed to get effect info array`); console.error(`Failed to get effect info array`);
return; return;
} else { } else {
console.info(`getAudioEffectInfoArray: ${getAudioEffectInfoArray}`); console.info(`getAudioEffectInfoArray: ${audioEffectInfoArray}`);
} }
}); });
``` ```
...@@ -3394,13 +3394,13 @@ getAudioEffectInfoArray(content: ContentType, usage: StreamUsage, callback: Asyn ...@@ -3394,13 +3394,13 @@ getAudioEffectInfoArray(content: ContentType, usage: StreamUsage, callback: Asyn
**示例:** **示例:**
```js ```js
audioStreamManager.getAudioEffectInfoArray(audio.ContentType.CONTENT_TYPE_MUSIC, audio.StreamUsage.STREAM_USAGE_MEDIA, async (err, AudioEffectInfoArray) => { audioStreamManager.getAudioEffectInfoArray(audio.ContentType.CONTENT_TYPE_MUSIC, audio.StreamUsage.STREAM_USAGE_MEDIA, async (err, audioEffectInfoArray) => {
console.info('getAudioEffectInfoArray **** Get Callback Called ****'); console.info('getAudioEffectInfoArray **** Get Callback Called ****');
if (err) { if (err) {
console.error(`getAudioEffectInfoArray :ERROR: ${err}`); console.error(`getAudioEffectInfoArray :ERROR: ${err}`);
return; return;
} else { } else {
console.info(`The contentType of ${CONTENT_TYPE_MUSIC} and the streamUsage of ${STREAM_USAGE_MEDIA} 's effect mode are: ${AudioEffectInfoArray}`); console.info(`The contentType of ${CONTENT_TYPE_MUSIC} and the streamUsage of ${STREAM_USAGE_MEDIA} 's effect mode are: ${audioEffectInfoArray}`);
} }
}); });
``` ```
...@@ -3417,8 +3417,8 @@ getAudioEffectInfoArray(content: ContentType, usage: StreamUsage): Promise&lt;Au ...@@ -3417,8 +3417,8 @@ getAudioEffectInfoArray(content: ContentType, usage: StreamUsage): Promise&lt;Au
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------- | -------- | --------------------------- | | -------- | ----------------------------------- | -------- | --------------------------- |
| content | [ContentType](#contenttype) | 是 | 音频内容类型。 | | content | [ContentType](#contenttype) | 是 | 音频内容类型。 |
| usage | [StreamUsage](#streamusage) | 是 | 音频流使用类型。 | | usage | [StreamUsage](#streamusage) | 是 | 音频流使用类型。 |
**返回值:** **返回值:**
...@@ -3429,14 +3429,12 @@ getAudioEffectInfoArray(content: ContentType, usage: StreamUsage): Promise&lt;Au ...@@ -3429,14 +3429,12 @@ getAudioEffectInfoArray(content: ContentType, usage: StreamUsage): Promise&lt;Au
**示例:** **示例:**
```js ```js
async function getAudioEffectInfoArray(){ audioStreamManager.getAudioEffectInfoArray().then((audioEffectInfoArray) => {
await audioStreamManager.getAudioEffectInfoArray().then( function (AudioEffectInfoArray) { console.info(`getAudioEffectInfoArray ######### Get Promise is called ##########`);
console.info(`getAudioEffectInfoArray ######### Get Promise is called ##########`); console.info(`The contentType of ${CONTENT_TYPE_MUSIC} and the streamUsage of ${STREAM_USAGE_MEDIA} 's effect mode are: ${audioEffectInfoArray}`);
console.info(`The contentType of ${CONTENT_TYPE_MUSIC} and the streamUsage of ${STREAM_USAGE_MEDIA} 's effect mode are: ${AudioEffectInfoArray}`); }).catch((err) => {
}).catch((err) => { console.error(`getAudioEffectInfoArray :ERROR: ${err}`);
console.error(`getAudioEffectInfoArray :ERROR: ${err}`); });
});
}
``` ```
## AudioRoutingManager<sup>9+</sup> ## AudioRoutingManager<sup>9+</sup>
...@@ -4235,7 +4233,7 @@ audioStreamManager.on('audioCapturerChange', (AudioCapturerChangeInfoArray) => ...@@ -4235,7 +4233,7 @@ audioStreamManager.on('audioCapturerChange', (AudioCapturerChangeInfoArray) =>
## AudioEffectInfoArray<sup>10+</sup> ## AudioEffectInfoArray<sup>10+</sup>
待查询ContentType和StreamUsage组合场景下的音效模式数组类型,[AudioEffectMode](#audioeffectmode)数组,只读。 待查询ContentType和StreamUsage组合场景下的音效模式数组类型,[AudioEffectMode](#audioeffectmode10)数组,只读。
## AudioDeviceDescriptors ## AudioDeviceDescriptors
...@@ -4492,8 +4490,8 @@ setAudioEffectMode(mode: AudioEffectMode, callback: AsyncCallback\<void>): void ...@@ -4492,8 +4490,8 @@ setAudioEffectMode(mode: AudioEffectMode, callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------ | | -------- | ---------------------------------------- | ---- | ------------------------ |
| mode | [AudioEffectMode](#audioeffectmode10) | 是 | 音效模式。 | | mode | [AudioEffectMode](#audioeffectmode10) | 是 | 音效模式。 |
| callback | AsyncCallback\<void> | 是 | 用于返回执行结果的回调。 | | callback | AsyncCallback\<void> | 是 | 用于返回执行结果的回调。 |
**示例:** **示例:**
...@@ -4519,7 +4517,7 @@ setAudioEffectMode(mode: AudioEffectMode): Promise\<void> ...@@ -4519,7 +4517,7 @@ setAudioEffectMode(mode: AudioEffectMode): Promise\<void>
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------- | ---- | ------------ | | ------ | ---------------------------------------- | ---- | ------------ |
| mode | [AudioEffectMode](#audioeffectmode10) | 是 | 音效模式。 | | mode | [AudioEffectMode](#audioeffectmode10) | 是 | 音效模式。 |
**返回值:** **返回值:**
...@@ -4555,7 +4553,11 @@ getAudioEffectMode(callback: AsyncCallback\<AudioEffectMode>): void ...@@ -4555,7 +4553,11 @@ getAudioEffectMode(callback: AsyncCallback\<AudioEffectMode>): void
```js ```js
audioRenderer.getAudioEffectMode((err, effectmode) => { audioRenderer.getAudioEffectMode((err, effectmode) => {
console.info(`getAudioEffectMode: ${effectmode}`); if (err) {
console.error('Failed to get params');
} else {
console.info(`getAudioEffectMode: ${effectmode}`);
}
}); });
``` ```
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册