Skip to content

客户端音频

Audio 是继承自 UiEvent

客户端音频播放不受引擎内下水等声音变化的影响,但是会受玩家客户端整体音量控制(主音量)

构造函数

Audio()

实例化一个客户端音频对象

输入参数

参数必填默认值类型说明
srcstring音频路径
javascript
let url = 'https://static.dao3.fun/block/QmSkEpcxqFYvZNwZg2EwzTz7y9XNxQnChZ18CDCM8Q8uvE';

const audio = new Audio(url);

属性

src

音频路径,目前仅支持白名单内的URL,不支持项目内音频路径。

技巧:项目内的音频,请复制音频Hash,然后拼接在 https://static.dao3.fun/block/{Hash}


volume

范围:0-1

音频播放音量,但最终音量受玩家客户端整体音量控制。


error

音频播放错误码

方法

play()

播放音频


pause()

暂停音频


load()

预加载音频

事件

loadeddata

音频加载完成事件


ended

音频播放结束事件


error

音频播放错误事件

javascript
let url = 'https://static.dao3.fun/block/QmSkEpcxqFYvZNwZg2EwzTz7y9XNxQnChZ18CDCM8Q8uvE';

const audio = new Audio(url);

//当监听到音频加载完成时触发
audio.add('loadeddata',(e) => {
    //xxx
})

//当监听到音频播放结束时触发
audio.add('ended',(e) => {
    //xxx
})

//当监听到音频发送错误时触发
audio.add('error',(e) => {
    //xxx
})