mp3音频

简介

这是Sillytavern插件的音频控制模块。它通过 /xbaudio 斜杠命令，让能够直接在聊天界面控制网络音频的播放。

🎵 /xbaudio 指令使用说明

该指令用于播放、停止或管理网络音频（支持 http 或 https 链接）。它支持双轨道播放，这意味着可以同时播放背景音乐和音效。

1. 基础语法

/xbaudio [play=参数] [mode=参数] [area=参数] [volume=数字] [音频URL或list]

2. 参数详情表 🛠️

参数名称	可选值	默认值	功能描述
play	`on`, `off`, `clear`	`on`	`on`: 播放音频；`off`: 暂停播放，可重启；`clear`: 彻底卸载音频资源
mode	`loop`, `once`	`loop`	`loop`: 循环播放；`once`: 只播放一次。
area	`primary`, `secondary`	`primary`	播放区域（轨道）。`secondary` 可用于叠加第二层声音。
volume	`1` 到 `10`	`5`	设置音量大小，范围为 1-10。
(匿名参数)	`URL` 或 `list`	-	输入音频的网页链接。输入 `list` 可查看当前正在播放的链接。

3. 常用示例 💡

场景	命令示例
播放背景音乐 (循环)	`/xbaudio https://files.catbox.moe/0ryoa5.mp3`
在第二轨道播放音效 (仅一次)	`/xbaudio mode=once area=secondary https://files.catbox.moe/0ryoa5.mp3`
调大音量播放	`/xbaudio volume=10 https://files.catbox.moe/0ryoa5.mp3`
停止特定播放轨道 (次频道)	`/xbaudio play=off area=secondary`
停止并关闭所有声音	`/xbaudio play=off` (不指定 area 时默认为全部停止)
查看当前播放的链接	`/xbaudio list

4. 进阶功能与注意事项 ⚠️

双轨机制：可以分别控制 primary（主轨道）和 secondary（次轨道）。例如，主轨道放 BGM，次轨道放雨声或环境音。
自动重置：为了防止音频干扰，当切换聊天频道（Chat Changed）时，所有正在播放的音频都会自动停止并清空。
链接限制：仅支持以 http:// 或 https:// 开头的网络音频链接。
开关控制：
- 可以在插件设置界面中找到 xiaobaix_audio_enabled 复选框来开启或关闭此功能。
- 如果全局扩展被禁用，音频功能也会自动停止并注销指令。