使用TonePlayer开发音频播放功能（仅对系统应用开放）

TonePlayer⁹⁺提供播放和管理DTMF（Dual Tone Multi Frequency，双音多频）音调的方法，包括各种系统监听音调、专有音调，如拨号音、通话回铃音等。主要工作是将需要生成音调的ToneType类型，通过自带算法生成多个不同频率的正弦波叠加形成声音数据，通过AudioRenderer进行播放，同时对播放任务进行管理。包含加载DTMF音调配置、启动DTMF音调播放、停止当前正在播放的音调、释放与此TonePlayer对象关联的资源等流程。详细API说明请参考TonePlayer API文档。

支持的播放音调类型

播放音调类型ToneType信息（如下表所示），可通过"audio.ToneType.指定类型" 作为参数调用load()方法加载指定类型的音调资源。

开发步骤及注意事项

以下步骤描述了TonePlayer接口实现播放功能流程：

1. 创建DTMF播放器 ，获取tonePlayer实例。

   import audio from '@ohos.multimedia.audio';
   let audioRendererInfo = {
     content : audio.ContentType.CONTENT_TYPE_SONIFICATION,
     usage : audio.StreamUsage.STREAM_USAGE_MEDIA,
     rendererFlags : 0
   };
   tonePlayerPromise = audio.createTonePlayer(audioRendererInfo);
   

2. 加载指定类型DTMF音调配置。

   tonePlayerPromise.load(audio.ToneType.TONE_TYPE_DIAL_0);
   

3. 启动DTMF音调播放。

   tonePlayerPromise.start();
   

4. 停止当前正在播放的音调。

   tonePlayerPromise.stop();
   

5. 释放与此TonePlayer对象关联的资源。

   tonePlayerPromise.release();
   

在接口未按此正常调用时序调用时，接口会返回错误码6800301 NAPI_ERR_SYSTEM。

完整示例

参考以下示例，点击键盘拨号按键，并启动对应的DTMF音调播放。

为保证UI线程不被阻塞，大部分TonePlayer调用都是异步的。对于每个API均提供了callback函数和Promise函数，以下示例均采用Promise函数，更多方式可参考API文档TonePlayer。

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

export class TonelayerDemo {
  private timer : number;
  private timerPro : number;
  // promise调用方式
  async testTonePlayerPromise(type) {
    console.info('testTonePlayerPromise start');
    if (this.timerPro) clearTimeout(this.timerPro);
    let tonePlayerPromise;
    let audioRendererInfo = {
      content : audio.ContentType.CONTENT_TYPE_SONIFICATION,
      usage : audio.StreamUsage.STREAM_USAGE_MEDIA,
      rendererFlags : 0
    };
    this.timerPro = setTimeout(async () => {
      try {
        console.info('testTonePlayerPromise: createTonePlayer');
        // 创建DTMF播放器      
        tonePlayerPromise = await audio.createTonePlayer(audioRendererInfo);
        console.info('testTonePlayerPromise: createTonePlayer-success');
        console.info(`testTonePlayerPromise: load type: ${type}`);
        // 加载type类型音调
        await tonePlayerPromise.load(type);
        console.info('testTonePlayerPromise: load-success');
        console.info(`testTonePlayerPromise: start type: ${type}`);
        // 启动DTMF音调播放
        await tonePlayerPromise.start();
        console.info('testTonePlayerPromise: start-success');
        console.info(`testTonePlayerPromise: stop type: ${type}`);
        setTimeout(async()=>{
          // 停止当前正在播放的音调
          await tonePlayerPromise.stop();
          console.info('testTonePlayerPromise: stop-success');
          console.info(`testTonePlayerPromise: release type: ${type}`);
          // 释放与此TonePlayer对象关联的资源
          await tonePlayerPromise.release();
          console.info('testTonePlayerPromise: release-success');
        }, 30)
      } catch(err) {
        console.error(`testTonePlayerPromise err : ${err}`);
      }
    }, 200)
  };
  async testTonePlayer() {
    this.testTonePlayerPromise(audio.ToneType.TONE_TYPE_DIAL_0);
  }
}