音频播放示例

由于 Cocos Creator 3.x 移除了 v2.x cc.audioEngine 系列的 API，统一使用 AudioSource 控制音频播放，因此我们需要在项目中将 AudioSource 组件 声明为常驻根节点，并封装一个管理器使用。可参考以下代码：

  1. import { assert, AudioSource, Component, game } from 'cc';
  2. const { ccclass, property } = _decorator;
  4. @ccclass('GameRoot')
  5. export class GameRoot extends Component {
  7.     @property(AudioSource) 
  8.     _audioSource: AudioSource = null!;
  10.     onLoad () {
  11.         const audioSource = this.node.getComponent(AudioSource)!;
  12.         assert(audioSource);
  13.         this._audioSource = audioSource;
  14.         // 声明常驻根节点，该节点不会在场景切换中被销毁。目标节点必须是根节点，否则无效。
  15.         game.addPersistRootNode(this.node);
  17.         // 将节点封装到管理器中
  18.         audioManager.instance.init(this._audioSource);
  19.     }
  20. }

音频管理的具体实现，可参考以下代码：

  1. import { AudioClip, AudioSource, assert, warn, clamp01, resources } from "cc";
  2. export class audioManager {
  4.     private static _instance: audioManager;
  5.     private static _audioSource?: AudioSource;
  7.     static get instance () {
  8.         if (this._instance) {
  9.             return this._instance;
  10.         }
  12.         this._instance = new audioManager();
  13.         return this._instance;
  14.     }
  16.     /**管理器初始化*/
  17.     init (audioSource: AudioSource) {
  18.         audioManager._audioSource = audioSource;
  19.     }
  21.       /**
  22.      * 播放音乐
  23.      * @param {Boolean} loop 是否循环播放
  24.      */
  25.     playMusic (loop: boolean) {
  26.         const audioSource = audioManager._audioSource!;
  27.         assert(audioSource, 'AudioManager not inited!');
  29.         audioSource.loop = loop;
  30.         if (!audioSource.playing) {
  31.             audioSource.play();
  32.         }
  33.     }
  35.      /**
  36.      * 播放音效
  37.      * @param {String} name 音效名称
  38.      * @param {Number} volumeScale 播放音量倍数
  39.      */
  40.     playSound (name: string, volumeScale: number = 1 ) {
  41.         const audioSource = audioManager._audioSource!;
  42.         assert(audioSource, 'AudioManager not inited!');
  44.         // 注意：第二个参数 “volumeScale” 是指播放音量的倍数，最终播放的音量为 “audioSource.volume * volumeScale”
  45.         audioSource.playOneShot(audioClip, volumeScale);
  47.     }
  48.     // 设置音乐音量
  49.     setMusicVolume (flag: number) {
  50.         const audioSource = audioManager._audioSource!;
  51.         assert(audioSource, 'AudioManager not inited!');
  53.         flag = clamp01(flag);
  54.         audioSource.volume = flag;
  55.     }
  57. }

以上代码片段只是举例了 AudioSource 组件播放的一种使用方式，并不完整。Creator 在范例项目 快上车（GitHub | Gitee）中提供了完整的封装好的音频播放管理器的使用示例。开发者可打开 Dashboard 的 项目 页面，点击右下角的 新建 按钮，进入新建项目页面，即可看到 Example Taxi Game 范例，根据需要填写项目名称和项目位置后即可创建并打开：

audioEdit