AudioSource 组件参考

AudioSource - 图1

属性

属性说明
Clip用来播放的声音资源对象
Loop是否循环播放
PlayOnAwake是否在组件激活后自动播放声音
Volume音量大小，范围在 0~1 之间

监听音频播放事件

AudioSource 组件在 v3.3.0 支持了事件监听接口，具体使用范例如下：

  1. @ccclass('AudioDemo')
  2. export class AudioDemo extends Component {
  4.     @property(AudioSource)
  5.     audioSource: AudioSource = null!;
  7.     onEnable () {
  8.         // Register the started event callback
  9.         this.audioSource.node.on(AudioSource.EventType.STARTED, this.onAudioStarted, this);
  10.         // Register the ended event callback
  11.         this.audioSource.node.on(AudioSource.EventType.ENDED, this.onAudioEnded, this);
  12.     }
  14.     onDisable () {
  15.         this.audioSource.node.off(AudioSource.EventType.STARTED, this.onAudioStarted, this);
  16.         this.audioSource.node.off(AudioSource.EventType.ENDED, this.onAudioEnded, this);
  17.     }
  19.     onAudioStarted () {
  20.         // TODO...
  21.     }
  23.     onAudioEnded () {
  24.         // TODO...
  25.     }
  26. }

更多声音接口的脚本接口请参考 AudioSource API。
具体的播放控制，可以参考文档 声音系统总览。