🎵 TS3AudioBot Bilibili 插件

一个功能强大的 TS3AudioBot 插件，让您可以在 TeamSpeak 中直接播放 Bilibili 视频的音频内容。

✨ 功能特性

• 🎯 直接播放 - 输入 BV 号即可播放 Bilibili 视频音频
• 📜 历史记录 - 查看并播放最近观看的视频
• 🔐 账号登录 - 支持二维码登录和 Cookie 登录
• 📝 播放队列 - 支持添加音频到播放队列
• 🎬 多P支持 - 完美支持多分P视频的选择播放
• 👥 多用户 - 每个用户独立的登录状态和历史记录

📦 安装方法

Release 包安装

1. 前往 Releases 下载最新版本
2. 到1.1.5.1 下载TS3audioBot（第一次操作需要）
3. 解压，并将最新版本替换1.1.5.1的插件（插件目录在/plugin中）
4. 下载并解压 bilibili-referer-proxy
5. 在 rights.toml 中添加以下权限： 

   "cmd.bilibili"
   "cmd.bilibili.qr"
   "cmd.bilibili.login"
   "cmd.bilibili.history"
   "cmd.bilibili.h"
   "cmd.bilibili.hp"
   "cmd.bilibili.addh"
   "cmd.bilibili.bv"
   "cmd.bilibili.p"
   "cmd.bilibili.add"
   "cmd.bilibili.addp"

🚀 快速开始

1. 启动服务

   # 启动代理服务（必须先启动）
   ./proxy.exe

   # 启动 TS3AudioBot
   ./TS3AudioBot.exe

2. 加载插件

   !plugin lists          # 查看插件列表
   !plugin load [插件编号]  # 加载 Bilibili 插件

3. 开始使用

   !bilibili bv BV1UT42167xb    # 播放指定视频
   !bilibili qr                 # 二维码登录
   !bilibili history           # 查看观看历史

📖 详细使用教程

🔐 用户登录

二维码登录（推荐）

!bilibili qr

• 发送命令后会生成二维码链接
• 使用 Bilibili APP 扫描二维码
• 系统会自动检测登录状态并保存凭据
• 每个用户的登录信息独立保存

Cookie 登录

!bilibili login SESSDATA=你的SESSDATA; bili\_jct=你的bili\_jct;

• 手动输入 Cookie 信息进行登录
• 适合高级用户或批量部署

查看登录状态

!bilibili status [1/2]

• 不输入任何参数可以查看代理是否开启与地址
• 1参数为播放时修改机器人名字为视频标题
• 2参数为播放时修改机器人简介为视频标题

🎵 音频播放

基础播放命令

!bilibili bv BV1UT42167xb

• 直接播放指定 BV 号的视频音频
• 如果是多P视频，会显示分P列表供选择
• 单P视频会直接开始播放
• 可以修改 BV 号为 BV 号-分 P （如BV1234567-1为播放该视频的第一个分P）快捷播放对应分P

多P视频播放

当视频包含多个分P时：

# 首先获取视频信息
!bilibili bv BV1UT42167xb

# 系统会显示：
# 视频包含 3 个分P：
# 1. 第一集：开场
# 2. 第二集：正片
# 3. 第三集：片尾
# 
# 请使用命令 !bilibili p \[编号] 播放对应分P。

# 播放指定分P
!bilibili p 2    # 播放第二集

📝 播放队列管理

添加到播放队列

!bilibili add BV1UT42167xb

• 将视频音频添加到播放队列，不会立即播放
• 适合连续播放多个视频

多P视频添加队列

# 获取视频信息
!bilibili add BV1UT42167xb

# 添加指定分P到队列
!bilibili addp 2    # 将第二集添加到队列

📜 历史记录功能

查看观看历史

!bilibili history

• 显示最近观看的10个视频
• 需要先登录账号
• 显示格式：编号. 视频标题

播放历史视频

# 播放历史记录中的视频
!bilibili h 3    # 播放历史记录第3个视频

# 如果历史视频是多P，会显示分P列表
!bilibili hp 2   # 播放历史视频的第2个分P

# 添加历史视频到播放队列
!bilibili addh 3  # 将历史记录第3个视频添加到队列

💡 使用技巧

1. 批量播放

   !bilibili add BV1111111111    # 添加第一个视频
   !bilibili add BV2222222222    # 添加第二个视频
   !bilibili add BV3333333333    # 添加第三个视频

2. 快速播放历史

   !bilibili history    # 查看历史
   !bilibili h 1        # 直接播放第一个

3. 多P连播

   !bilibili bv BV1234567890    # 获取视频信息
   !bilibili p 1                # 播放第一P
   !bilibili addp 2             # 添加第二P到队列
   !bilibili addp 3             # 添加第三P到队列

📋 完整命令列表

命令	参数	功能描述	示例
!bilibili qr	无	生成二维码进行登录	!bilibili qr
!bilibili login	Cookie字符串	使用Cookie登录	!bilibili login SESSDATA=xxx; bili\_jct=xxx;
!bilibili history	无	查看最近10条观看历史	!bilibili history
!bilibili h	历史编号	播放历史记录中的视频	!bilibili h 3
!bilibili hp	分P编号	播放历史视频的指定分P	!bilibili hp 2
!bilibili addh	历史编号	添加历史视频到播放队列	!bilibili addh 3
!bilibili bv	BV号	播放指定BV号的视频	!bilibili bv BV1UT42167xb
!bilibili p	分P编号	播放当前视频的指定分P	!bilibili p 2
!bilibili add	BV号	添加视频到播放队列	!bilibili add BV1UT42167xb
!bilibili addp	分P编号	添加指定分P到播放队列	!bilibili addp 2

🛠️ 编译源代码

环境要求

• .NET Core 3.1 SDK

编译步骤

1. 克隆仓库

   git clone https://github.com/xxmod/TS3AudioBot-BiliBiliPlugin.git
   cd TS3AudioBot-BiliBiliPlugin

2. 编译项目

   # Windows
   ./release.bat

   # 或使用 dotnet 命令
   dotnet build --configuration Release

3. 获取编译文件 编译完成后，在 bin/Release/netcoreapp3.1/ 目录下可找到所有必要文件。

🔧 故障排除

常见问题

Q: 提示"未能获取音频流地址" A: 检查代理服务 proxy.exe 是否正常运行，确保在端口 32181 上监听。

Q: 登录后仍然无法查看历史记录 A: 确认 Cookie 信息正确，可尝试重新登录或使用二维码登录。

Q: 多P视频无法播放指定分P A: 确保先使用 !bilibili bv 命令获取视频信息，再使用 !bilibili p 命令。

获取 Cookie 方法

1. 打开浏览器，访问 bilibili.com 并登录

2. 打开开发者工具（F12）

3. 切换到 Application 标签页

4. 在左侧菜单中找到 Cookies，展开并选择 https://www.bilibili.com

5. 查找以下两个值：

   • SESSDATA：形如 xxx%2Cxxx%2Cxxx\*xx
   • bili\_jct：形如 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

6. 组合 Cookie：

   SESSDATA=你的SESSDATA值; bili\_jct=你的bili\_jct值;

🙏 致谢

感谢以下项目和开发者：

• bilibili-API-collect - 提供详细的 Bilibili API 文档
• ZHANGTIANYAO1/TS3AudioBot-NetEaseCloudmusic-plugin - 提供插件开发参考
• Splamy/TS3AudioBot - 优秀的 TeamSpeak 音频机器人框架

📄 许可证

本项目基于 MPL2.0 许可证开源，详见 LICENSE 文件。

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目！

---

如果这个项目对您有帮助，请给个 ⭐ Star 支持一下！