提交 507628f4 编写于 作者: Z zhujie81

Add setInterruptMode interface of docs

Signed-off-by: Nzhujie81 <zhujie81@huawei.com>
上级 a6b2b103
master OpenHarmony-3.2-Beta2 OpenHarmony-3.2-Beta3 OpenHarmony-3.2-Beta4 OpenHarmony-3.2-Beta5 OpenHarmony-3.2-Release OpenHarmony-4.0-Beta1 OpenHarmony-4.0-Beta2 TR4270 bak_OpenHarmony-4.0-Beta1_20230529 docs-modify feature_IDL_20220811 monthly_20220816 monthly_20221018 monthly_20230815 revert-merge-17651-master revert-merge-19334-OpenHarmony-4.0-Beta1 revert-merge-19586-master revert-merge-20613-master revert-merge-21757-OpenHarmony-4.0-Beta2 revert-merge-21765-OpenHarmony-4.0-Beta2 revert-merge-23766-master revert-merge-5580-master weekly_20220621 weekly_20220628 weekly_20220705 weekly_20220712 weekly_20220719 weekly_20220726 weekly_20220802 weekly_20220809 weekly_20220816 weekly_20220823 weekly_20220830 weekly_20220906 weekly_20220913 weekly_20220920 weekly_20220927 weekly_20221004 weekly_20221011 weekly_20221018 weekly_20221025 weekly_20221101 weekly_20221108 weekly_20221115 weekly_20221122 weekly_20221129 weekly_20221206 weekly_20221213 weekly_20221220 weekly_20221227 weekly_20230103 weekly_20230110 weekly_20230117 weekly_20230124 weekly_20230131 weekly_20230207 weekly_20230214 weekly_20230221 weekly_20230228 weekly_20230307 weekly_20230314 weekly_20230321 weekly_20230328 weekly_20230404 weekly_20230411 weekly_20230418 weekly_20230425 weekly_20230502 weekly_20230509 weekly_20230516 weekly_20230523 weekly_20230530 weekly_20230606 weekly_20230613 weekly_20230619 weekly_20230626 weekly_20230627 weekly_20230704 weekly_20230712 weekly_20230725 weekly_20230801 weekly_20230808 weekly_20230815 weekly_20230822 weekly_20230829 weekly_20230905 OpenHarmony-v4.0-Beta2 OpenHarmony-v4.0-Beta1 OpenHarmony-v3.2.3-Release OpenHarmony-v3.2.2-Release OpenHarmony-v3.2.1-Release OpenHarmony-v3.2-Release OpenHarmony-v3.2-Beta5 OpenHarmony-v3.2-Beta4 OpenHarmony-v3.2-Beta3 OpenHarmony-v3.2-Beta2
无相关合并请求
# 音频焦点模式开发指导
## 场景介绍
音频焦点模式指的是应用内,允许对多个声音的播放进行控制<br>
音频应用可以在AudioRenderer下设置独立焦点模式、共享焦点模式。<br>
当设置在共享的模式下,多个音频可以进行同时共存播放;独立焦点模式下,仅支持一个音频;
......@@ -24,7 +24,7 @@
var audioStreamInfo = {
samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
channels: audio.AudioChannel.CHANNEL_1,
sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
}
......@@ -42,14 +42,13 @@
let audioRenderer = await audio.createAudioRenderer(audioRendererOptions);
```
2. 调用
2. 设置焦点模式
启动完成后,可以进行焦点模式调用。<br>
```js
var mode_ = audio.InterruptMode.SHARE_MODE;
await this.audioRenderer.setInterruptMode(mode_).then((value)=>{
console.log('[JSAR] [audioRenderer.SetInterruptMode] value : ' + value);
await this.audioRenderer.setInterruptMode(mode_).then(()=>{
console.log('[JSAR] [SetInterruptMode] 设置: ' + (mode == 0 ? "共享模式":"独立焦点模式") + "成功" );
});
```
......
......@@ -246,16 +246,16 @@ audio.createAudioRenderer(audioCapturerOptions).then((data) => {
| VOICE_ASSISTANT<sup>8+</sup> | 9 | 语音助手。 |
## InterruptMode
## InterruptMode<sup>9+</sup>
枚举,焦点模型类型
枚举,焦点模型。
**系统能力:** 以下各项对应的系统能力均为SystemCapability.Multimedia.Audio.InterruptMode
**系统能力:** SystemCapability.Multimedia.Audio.InterruptMode
| 名称 | 默认值 | 描述 |
| ---------------------------- | ------ | ---------- |
| SHARE_MODE<sup>9+</sup> | 0 | 共享焦点模式。 |
| INDEPENDENT_MODE<sup>9+</sup>| 1 | 独立焦点模式。 |
| SHARE_MODE | 0 | 共享焦点模式。 |
| INDEPENDENT_MODE| 1 | 独立焦点模式。 |
## DeviceFlag
......@@ -2490,9 +2490,9 @@ audioRenderer.getRenderRate().then((renderRate) => {
```
### setInterruptMode<sup>9+</sup>
setInterruptMode(interruptType: InterruptType): Promise&lt;void&gt;
setInterruptMode(interruptMode: InterruptMode): Promise&lt;void&gt;
设置指定流的音量,使用Promise方式异步返回结果
设置应用的焦点模型。使用Promise异步回调
**系统能力:** SystemCapability.Multimedia.Audio.Renderer
......@@ -2500,13 +2500,13 @@ setInterruptMode(interruptType: InterruptType): Promise&lt;void&gt;
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ----------------------------------- | ---- | -------------------------------------------------------- |
| interruptType | [InterruptType](#InterruptMode) | 是 | 焦点模型类型。 |
| interruptMode | [InterruptMode](#InterruptMode) | 是 | 焦点模型。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | ----------------------------- |
| Promise&lt;void&gt; | Promise回调表示成功还是失败。 |
| Promise&lt;void&gt; | 以Promise对象返回结果,设置成功时返回undefined,否则返回error。 |
**示例:**
......@@ -2514,6 +2514,10 @@ setInterruptMode(interruptType: InterruptType): Promise&lt;void&gt;
audioManager.setInterruptMode(audio.InterruptType.SHARE_MODE).then(() => {
console.log('Promise returned to indicate a successful volume setting.');
});
audioManager.setInterruptMode(audio.InterruptType.SHARE_MODE,()=>{
console.log('Promise returned to indicate a successful volume setting.');
});
```
### on('interrupt')<sup>9+</sup>
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册
反馈
建议
客服 返回
顶部