• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 音频焦点模式开发指导
2
3## 简介
4音频焦点模式指的是应用内,允许对多个声音的播放进行控制。<br>
5音频应用可以在AudioRenderer下设置独立焦点模式、共享焦点模式。<br>
6当设置在共享的模式下,多个音频共用一个会话ID;独立焦点模式下,每一个音频拥有单独会话ID。
7
8- **异步操作**:为保证UI线程不被阻塞,大部分AudioRenderer调用都是异步的。对于每个API均提供了callback函数和Promise函数,以下示例均采用Promise函数。
9
10## 开发指导
11
12详细API含义可参考:[音频管理API文档AudioRenderer](../reference/apis/js-apis-audio.md#audiorenderer8)
13
141. 使用createAudioRenderer()创建一个AudioRenderer实例。<br>
15   在audioRendererOptions中设置相关参数。<br>
16   该实例可用于音频渲染、控制和获取采集状态,以及注册通知回调。<br>
17
18   ```js
19   import audio from '@ohos.multimedia.audio';
20
21   var audioStreamInfo = {
22     samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
23     channels: audio.AudioChannel.CHANNEL_1,
24     sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
25     encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
26   }
27
28   var audioRendererInfo = {
29     content: audio.ContentType.CONTENT_TYPE_SPEECH,
30     usage: audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION,
31     rendererFlags: 1
32   }
33
34   var audioRendererOptions = {
35     streamInfo: audioStreamInfo,
36     rendererInfo: audioRendererInfo
37   }
38
39   let audioRenderer = await audio.createAudioRenderer(audioRendererOptions);
40   ```
41
422. 设置焦点模式。
43
44   在AudioRenderer初始化完毕后,可以进行焦点模式的设置。<br>
45
46   ```js
47    var mode_ = audio.InterruptMode.SHARE_MODE;
48    await this.audioRenderer.setInterruptMode(mode_).then(() => {
49      console.log('[JSAR] [SetInterruptMode] 设置: ' + (mode_ == 0 ? "共享模式":"独立焦点模式") + "成功" );
50    });
51   ```
52
53