音频播放器功能

本功能修改自酒馆官方扩展 Dynamic Audio。

特性

• 直接播放网络音频
• 全局接管前端界面中的音频播放，解决多楼层音乐会同时播放的冲突问题，以及同一音频在楼层更新时无法接续播放的问题
• 可视化地对音频列表中音频的排序，编辑和删除
• 增加导入按钮，可以批量输入链接导入到歌单
• 四种播放模式：【列表循环、随机播放、单曲循环、播完停止】
• 注册了 Quick Reply 命令,可以使用快速回复听歌。

提示

音频的链接存储在当前聊天的局部变量中，切换聊天就会清空，切换回来时会再加载。可以使用/listvar查看变量列表，变量名分别为bgmurl和ambienturl，支持使用 Quick Reply 对播放列表做更多自定义的改动。

注意

音乐和音效两个播放器内在逻辑完全一致，因未知原因，在音频长度极短的情况下会出现播放不全的问题，禁止缓存后才可正常播放，因此音效播放器不会对音频文件进行缓存。推荐主要使用音乐播放器，音效播放器仅用于文件较小的音频文件。

audioEnable

控制音乐播放器或音效播放器的开启与关闭。

async function audioEnable({type: 'bgm' | 'ambient', state?: boolean})

参数

type

• 类型: 'bgm' | 'ambient'
• 描述: 音乐或音效

state?

• 类型: boolean
• 描述: 开启或关闭, 不填写默认为 true

Quick Reply 命令

/audioenable [type=bgm|ambient] [state=true|false]?

• type: 音乐或音效
• state (可选): 开启或关闭, 不填写默认为 true

示例

/audioenable type=ambient state=false

audioImport

导入一个或多个音频到播放界面。

async function audioImport({type: 'bgm' | 'ambient', play?: boolean}, url: string)

参数

type

• 类型: 'bgm' | 'ambient'
• 描述: 音乐或音效

play?

• 类型: boolean
• 描述: 是否立即播放, 不填写默认为 true

url

• 类型: string
• 描述: 要播放的音频链接，可以批量导入，多个链接之间用英文逗号隔开

Quick Reply 命令

/audioimport [type=bgm|ambient] [play=true|false]? url

• type: 音乐或音效
• play (可选): 是否导入之后立即播放第一个音频, 不填写默认为 true
• url: 要播放的音频链接，可以批量导入，多个链接之间用英文逗号隔开

示例

/audioimport type=ambient play=false url=https://example.com/sound1.mp3,https://example.com/sound2.mp3

audioSelect

选择指定的音频并开始播放。

async function audioSelect({type: 'bgm' | 'ambient'}, url: string)

参数

type

• 类型: 'bgm' | 'ambient'
• 描述: 音乐或音效

url

• 类型: string
• 描述: 要播放的音频链接，如果在播放列表里不存在则先导入再播放，不可批量导入，只能填写一个链接

Quick Reply 命令

/audioselect [type=bgm|ambient] url

• type: 音乐或音效
• url: 要播放的音频链接，如果在播放列表里不存在则先导入再播放，不可批量导入，只能填写一个链接

示例

/audioselect type=bgm https://example.com/song.mp3

audioPlay

控制音频的播放和暂停。

async function audioPlay({type: 'bgm' | 'ambient', play?: boolean})

参数

type

• 类型: 'bgm' | 'ambient'
• 描述: 音乐或音效

play?

• 类型: boolean
• 描述: 播放或暂停, 不填写默认为 true

Quick Reply 命令

/audioplay [type=bgm|ambient] [play=true|false]?

• type: 音乐或音效
• play (可选): 播放或暂停, 不填写默认为 true

示例

/audioplay type=ambient play=false

audioMode

切换音频的播放模式。

async function audioMode({type: 'bgm' | 'ambient', mode: 'repeat' | 'random' | 'single' | 'stop'})

参数

type

• 类型: 'bgm' | 'ambient'
• 描述: 音乐或音效

mode

• 类型: 'repeat' | 'random' | 'single' | 'stop'
• 描述: 播放模式, 分别是列表循环、随机播放、单曲循环、播完停止

Quick Reply 命令

/audiomode [type=bgm|ambient] [mode=repeat|random|single|stop]

• type: 音乐或音效
• mode: 播放模式, 分别是列表循环、随机播放、单曲循环、播完停止

示例

/audiomode type=ambient mode=random