audio-interruptmode.md

# 音频焦点模式开发指导

## 场景介绍

音频应用可以在AudioRenderer下设置独立焦点模式、共享焦点模式。<br>
当设置在共享的模式下，多个音频可以进行同时共存播放；独立焦点模式下，仅支持一个音频；

### 异步操作

为保证UI线程不被阻塞，大部分AudioRenderer调用都是异步的。对于每个API均提供了callback函数和Promise函数，以下示例均采用Promise函数。

## 开发步骤

详细API含义可参考：[音频管理API文档AudioRenderer](../reference/apis/js-apis-audio.md#audiorenderer8)


1. 使用createAudioRenderer()创建一个AudioRenderer实例。<br>
   在audioCapturerOptions中设置相关参数。<br>
   该实例可用于音频渲染、控制和获取采集状态，以及注册通知回调。<br>

   ```js
   import audio from '@ohos.multimedia.audio';

    var audioStreamInfo = {
        samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_44100,
        channels: audio.AudioChannel.CHANNEL_1,
     sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,
        encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW
    }
   
    var audioRendererInfo = {
        content: audio.ContentType.CONTENT_TYPE_SPEECH,
        usage: audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION,
        rendererFlags: 1
    }
   
    var audioRendererOptions = {
        streamInfo: audioStreamInfo,
        rendererInfo: audioRendererInfo
    }
   
    let audioRenderer = await audio.createAudioRenderer(audioRendererOptions);
   ```

2. 调用。
   
   启动完成后，可以进行焦点模式调用。<br>

   ```js
    var mode_ = audio.InterruptMode.SHARE_MODE;
    await this.audioRenderer.setInterruptMode(mode_).then((value)=>{
      console.log('[JSAR] [audioRenderer.SetInterruptMode] value : ' + value);
      console.log('[JSAR] [SetInterruptMode] 设置: ' + (mode == 0 ? "共享模式":"独立焦点模式") + "成功" );
    });
   ```