使用 OrangePi Zero3 搭建 TS3AudioBot

前言
#

在如何搭建自己的 ts3 服务器这一篇文章中教学了如何搭建属于自己的 ts3 服务器，现在我想放一个音乐机器人在 ts3 里面常驻，可以用来活跃频道，还可以分享自己喜欢的歌。

于是找到了 TS3AudioBot 这个项目，它十分符合预期，不需要公网，只需要一个可以联网的机器就行。而香橙派十分符合作为搭建的机器，有着极低的功耗，还可以 24h 都在线。

Splamy/TS3AudioBot

Advanced Musicbot for Teamspeak 3

698

139

下载及安装
#

首先确认自己的系统，在 TS3AudioBot Releases 中下载最新的程序包。因为我是 arm 开发板，所以下载的是arm64架构版本。请按照自己的系统和架构选择对应的版本。

可以选择下载到电脑上然后使用 FTP 传到开发板上；还可以复制文件的地址然后在开发板上使用curl -jLO "<文件地址>"将文件直接下载到开发板（下载慢的话注意网络环境）；当然你也可以选择使用SCP指令。这里就不赘述了，不会用SCP的话请查看菜鸟教程 - Linux scp 命令。

将程序包准备好后进行解压tar -zxvf <压缩包文件名> -C <指定解压到的文件夹>，

解压好后进入文件夹，可以看到以下内容：

先不急着运行，因为没有对应的库和环境肯定会报错，需要先使用sudo apt-get install libopus-dev ffmpeg安装需要的库。因为我是 Arm Ubuntu 22.04，所以还需要安装旧版本的libssl1.1，所使用的镜像源中也没有，所以需要手动下载安装：

请注意，我是因为自己是 Arm 开发板才需要进行旧版本libssl安装，你是否也需要请按实际情况进行操作，不知道的话可以直接运行 TS3AudioBot 来观察是否有对应报错

前往 ubuntu - ports 官方库搜索libssl1.1_1.1.1，然后选择对应自己系统架构和版本的进行下载。例如我的下载是libssl1.1_1.1.1-1ubuntu2.1~18.04.23_arm64.deb这一个
下载到开发版后sudo dpkg -i <软件包名>进行安装，例如我的sudo dpkg -i libssl1.1_1.1.1-1ubuntu2.1~18.04.23_arm64.deb

运行及配置
#

接下来./TS3AudioBot运行TS3AudioBot，依次进行下面操作：

会让问你是否需要设定管理员，建议选择「是」；
选择「是」的话接下来就会让你输入管理员的 uid，可以在 ts3 中「权限 -> 所有客户端列表」找到自己名字，后面的「唯一标识符」就是你的 uid，粘贴上去就行；
会问你加入的服务器的 IP 、地址或者别名，输入你的服务器地 IP 或者地址或者别名就行；
输入服务器密码，没有的话直接回车即可；

接下来就会有一个名为「TS3AudioBot」的机器人进入你服务器的默认频道。私聊发送!api token即可开启 web 面板，浏览器输入http://{机器人地址}:58913/进行登录后可以进行一些基本的修改。

配置服务（开机自启动等）
#

使用 root 用户或者使用sudo创建一个文件：/usr/lib/systemd/system/ts3audiobot.service，填入以下内容：

[Unit]
Description=TS3AudioBot
After=teamspeak.service

[Service]
Type=simple
User={运行TS3AudioBot的用户名}
Group={运行TS3AudioBot的用户名}
KillSignal=SIGINT
Restart=on-failure
RestartSec=10
WorkingDirectory={TS3AudioBot文件夹绝对路径}
ExecStart={TS3AudioBot文件夹绝对路径}/TS3AudioBot

[Install]
WantedBy=multi-user.target

systemd 服务使用方式（新加服务或者修改过.service文件需要重载生效）：

# 重载
systemctl daemon-reload

# 开启自启动
systemctl enable ts3audiobot.service

# 启动 ts3audiobot
systemctl start ts3audiobot.service

# 停止 ts3audiobot
systemctl stop ts3audiobot.service

# 重启 ts3audiobot
systemctl restart ts3audiobot.service

接下来你就可以开始进机器人配置了。

配置歌单
#

在自己电脑上下好自己想让机器让播放的歌，压缩成.tar.gz格式，上传到开发板，解压到和TS3AudioBot同级的文件夹下面，例如我的TS3AudioBot在/home/he_tong/ts3audiobot-test文件夹下面，所有的音乐文件就在/home/he_tong/ts3audiobot-test/music下面。

进入音乐文件夹，创建一个export_music_list.py文件，输入以下内容，其中，第 27 行的「title」需要注意，可以改为你想要最终在网页中显示的名字，可以为中文：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
import os
import json

# 支持的音频文件扩展名
supported_extensions = ['.mp3', '.flac', '.wav', '.m4a']

def is_music_file(filename):
    # 检查文件扩展名是否是音频文件
    ext = os.path.splitext(filename)[1].lower()
    return ext in supported_extensions

def get_music_files(path):
    music_files = []
    # 遍历指定目录下的所有文件
    for root, _, files in os.walk(path):
        for file in files:
            if is_music_file(file):
                full_path = os.path.join(root, file)
                music_files.append((file, full_path))
    return music_files

def create_playlist(music_files):
    count = len(music_files)
    # 生成歌单文件内容
    playlist_content = []
    playlist_content.append(f'version:3')
    playlist_content.append(f'meta:{{"count":{count},"title":"Music"}}')

    for title, path in music_files:
        playlist_content.append(f'rsj:{{"type":"media","resid":"{path}","title":"{title}"}}')

    return '\n'.join(playlist_content)

def save_playlist(content, filename="music_list"):
    # 使用 surrogateescape 来处理代理字符问题
    with open(filename, 'w', encoding='utf-8', errors='surrogateescape') as f:
        f.write(content)

if __name__ == "__main__":
    # 获取当前运行位置的路径
    current_dir = os.getcwd()

    # 获取所有音频文件
    music_files = get_music_files(current_dir)

    # 创建歌单内容
    playlist_content = create_playlist(music_files)

    # 保存到文件
    save_playlist(playlist_content)

    print(f"歌单已生成，包含 {len(music_files)} 首歌曲。")

然后使用python export_music_list.py来运行这个 Python 脚本（没有 python 的话请先使用sudo apt-get install python3安装 python），就会生成一个文件，名叫「music_list」，将其复制到{TS3AudioBot_Path}/bots/default/playlists文件夹中，就会有一个播放列表

配置机器人行为
#

启动机器人后会在TS3AudioBot同级目录生成一个名为ts3audiobot.toml的文件，这个文件就是机器人的配置文件（不过这个配置是全局的，因为我这只有一个机器人，也只会生成一个，所以修改它就行了，如果你想只修改一个机器人的配置可以进入/bots下对应机器人文件夹下修改bot.toml文件）

以下我只说一些我自己修改的项目参数（你可以使用 Extended Client Info 主题包查看频道 id）：

[bot.connect]
# 服务器密码。如果没有，则留空。
server_password = { pw = "", hashed = false, autohash = false }
# 默认频道密码。如果没有，则留空。
channel_password = { pw = "", hashed = false, autohash = false }
# 覆盖 ts3 客户端显示的版本。留空表示默认。
client_version = { build = "", platform = "", sign = "" }
# TeamSpeak3 服务器的地址、IP 或昵称（以及端口；默认：9987）
address = "{服务器地址}"
# 连接时的默认频道。使用频道路径或「/<id>」。
# 例如 「Home/Lobby「, 」/5「, 」Home/Afk\/ Not Here"。
channel = "{频道地址，或者"/频道 id"}"
# 徽章展示架。您可以设置一个逗号分隔的字符串，最多包含三个 GUID。下面是一个列表： http://yat.qa/ressourcen/abzeichen-badges/
badges = ""
# 连接时的客户端昵称。
name = "{机器人名字}"

[bot.events]
# 当机器人连接服务器时调用。
onconnect = "!list play music_list (!repeat all)" # 作用是连接服务器时使用全部循环播放"music_list"这个文件的播放列表
# 机器人断开连接时调用。
ondisconnect = ""
# 当机器人在一定时间内未播放任何内容时调用。
onidle = ""
# 指定机器人闲置多长时间，直到 「onidle 」事件被触发。
# 您可以使用 ISO-8601 格式 「PT30S 」或类似格式指定时间： 15s、1h、3m30s
idletime = "0s"
# 当最后一个客户端离开机器人频道时调用。可指定延迟时间
onalone = "!pause" # 作用是在最后一个人退出机器人所在频道后暂停播放
# 指定机器人在 「onalone 」事件被触发前的独处时间。
# 您可以使用 ISO-8601 格式 「PT30S 」或类似格式指定时间： 15s、1h、3m30s
alone_delay = "10s" #结合上一项，作用是最后一个人退出机器人后 10s 触发上一条的暂停播放
# 当机器人独自一人时，有客户端加入他的频道时调用。可以指定延迟时间。
onparty = "!play" # 作用是原本机器人一个人在频道后有人进入频道就继续播放
# 指定机器人在 「onalone 」事件被触发前的独处时间。
# 您可以使用 ISO-8601 格式 「PT30S 」或类似格式指定时间： 15秒、1小时、3分30秒
party_delay = "0s"
# 新歌开始时调用。
onsongstart = ""