TS3AudioBot 网易云音乐机器人部署教程

前言

涉及项目：TS3AudioBot、NeteaseCloudMusicApi、TS3AudioBot-NetEaseCloudmusic-plugin
此机器人可实现网易云音乐、歌单的检索播放，以及对应ID、歌单ID的播放。并包含播放/暂停、音量调节、切歌等基础功能。
可通过TS内指令或通过API自建播放页实现上述功能，推荐内存预留1G起。
但由于项目存在部分不足，可能会遇到许多限制与BUG，如歌单无法清除导致的内存过大、歌单歌曲无法展示封面等等，追求完美者可止步。

1/6/2015 插件优化版 含更多功能，包括清理歌曲列表。

API部署

网易云插件中需要用到API，配置位置于/plugins/YunSettings.ini
可自行部署或使用公共API如https://163.lilac.pp.ua/，但此API经测试可能会出现SSL问题，建议自行部署。

部署教程

需要NodeJS 14+及NPM环境

git clone https://gitlab.com/Binaryify/NeteaseCloudMusicApi.git
cd NeteaseCloudMusicApi
npm install

大陆服务器可能会网络问题，可以采用阿里云的NPM镜像。
完成后运行node app.js，便可成功访问默认3000端口。

Windows部署

1.下载TS3AudioBot与网易云插件集成版，即win-x64.zip。
2.配置bot.toml的ts服务器信息、rights.toml的用户权限、YunSettings.ini中的API地址。
3.用户权限配置请参考Rights；YunSettings.ini默认的API地址已失效，需要手动修改为本地部署端口/公共API。
4.修改完成后，运行TS3AudioBot.exe，可以看见TS3AudioBot进入服务器，此时本地58913端口也可成功访问。

Linux部署

环境配置

1.下载1.1.0版本的with.TS3Bot.linux-x64.zip、2.0.3版本的YunPlugin-UNM.zip，用UNM的文件替换掉1.1.0的/linux-x64/plugins中的所有文件。
2.若有文件缺失，如/bots、/Webinterface、rights.toml等，可直接从它处补齐。
3.运行./TS3AudioBot，可见TS3AudioBot进入服务器，本地58913端口也可成功访问

TS侧配置

授予机器人身份组，以赋予相关权限，如修改头像、描述、名称等。
执行命令：
!plugin list查看插件，!plugin load 0加载云音乐插件。
!yun login登录网易云账号，扫描二维码登录。
!yun play 海阔天空播放歌曲。

指令功能及频道描述效果：

频道描述分享：

[B]网易云在线指令(实际使用无需加"[]")[/B]:
!yun play [音乐名称] - 以名称播放[COLOR=#ffaa00][B]音乐[/B][/COLOR]
!yun playid [音乐id] - 以ID播放[COLOR=#ffaa00][B]音乐[/B][/COLOR]
!yun add [音乐名称] - 添加[COLOR=#ffaa00][B]音乐[/B][/COLOR]到下一首
!yun add [音乐id] - 以ID添加[COLOR=#ffaa00][B]音乐[/B][/COLOR]到下一首
!next - 播放列表中您添加的下一首[COLOR=#ffaa00][B]音乐[/B][/COLOR]

*音乐与歌单平行，意味着歌单也是列表中的一首"音乐"。所以!yun add会加在歌单最末尾。!next为针对列表指令，!yun next为针对歌单指令*

!yun gedan [歌单名称] - 以名称播放[COLOR=#aaaaff][B]歌单[/B][/COLOR]
!yun gedanid [歌单id] - 以ID播放[COLOR=#aaaaff][B]歌单[/B][/COLOR]
!yun next - 播放[COLOR=#aaaaff][B]歌单[/B][/COLOR]中的下一首

[I]*需要注意如果歌单歌曲过多,需要时间加载,期间一定不要输入其他指令。[/I]
[B]其他指令：[/B]
!yun next - 播放[COLOR=#aaaaff][B]歌单[/B][/COLOR]中的下一首
!next - 播放列表中的下一首(您添加的[COLOR=#ffaa00][B]音乐[/B][/COLOR])
!pause - 暂停
!play [XX] - 继续/播放[COLOR=#e39700][B]外链音乐[/B][/COLOR]
!volume [XX] - 查看/调整音量大小
!song - 查看歌曲信息

Webinterface的使用

私聊机器人!api token，获取类此内容：
hFE8icC4Xkv2PAU4RxI88sjz9df=:djdJnJZssdfwWf32FD06s1OAfWuy3Rmo
以:为分隔，分别填入左右侧。

可在Infoboard中查看服务器占用，在Bot面板中修改名称、创建更多Bot等等。

API的运用

可对/Webinterface/index.html进行修改，利用API，以实现更多样化效果。
关于API的使用：WebAPI、Ts3AudioBot API
本人开源项目：TS3AudioBot_NetEase_WebUI（注意，此项目需要使用wellwhz优化版插件）
效果展示：

常见问题

• Bot显示正在播放，但无声音：需先登录网易云!yun login
• 端口无法访问：修改过程注意防火墙端口的放行。
• !yun login登录超时/SSL错误：检查TLS版本，尝试其他API地址（建议自己搭建）
• 为什么win/linux上运行的程序自动退出了：请持久化部署程序，文中win/linux中的TS3AudioBot、app.js等都需要挂起；此外请检查是否有报错。
• 为什么我按照你的步骤走，却出错了：这是一篇回忆，部分细节可能遗忘，但应均可通过AI解决；重点在于环境的配置。
• 更多细节内容都在各项目文档，请自行查阅。