🎵 初叶 MetingAPI 点歌
插件名称： astrbot_plugin_meting
当前版本： v1.1.4
基于 MetingAPI 的多音源点歌插件，支持网易云、QQ 音乐、酷狗和酷我。
插件可以发送音乐卡片、语音分段或音乐文件；具体方式由当前平台和管理员配置决定。
🚀 快速开始
直接点歌
@bot 点歌 坠落星空
系统会使用当前会话的默认音源搜索，并播放第一首结果。
先搜索再选歌
@bot 搜歌 坠落星空
收到搜索列表后发送：
@bot 点歌 1
其中 1 是搜索结果序号。
⌨️ 命令速查
| 命令 | 说明 |
|---|---|
@bot 点歌指令 | 查看全部点歌指令 |
@bot 点歌帮助 | 查看全部点歌指令 |
@bot 搜歌 歌名 | 使用当前音源搜索歌曲 |
@bot 点歌 序号 | 播放刚才搜索结果中的指定歌曲 |
@bot 点歌 歌名 | 直接搜索并播放第一首 |
@bot 网易点歌 歌名 | 使用网易云音乐快捷点歌 |
@bot QQ点歌 歌名 | 使用 QQ 音乐快捷点歌 |
@bot 酷狗点歌 歌名 | 使用酷狗音乐快捷点歌 |
@bot 酷我点歌 歌名 | 使用酷我音乐快捷点歌 |
@bot 切换网易云 | 将当前会话默认音源切换为网易云 |
@bot 切换QQ音乐 | 将当前会话默认音源切换为 QQ 音乐 |
@bot 切换酷狗 | 将当前会话默认音源切换为酷狗 |
@bot 切换酷我 | 将当前会话默认音源切换为酷我 |
🎚️ 切换发送模式
以下命令仅管理员可用，并且只修改当前会话的发送模式。
| 命令 | 说明 |
|---|---|
@bot 切换发送模式 卡片 | 优先发送音乐卡片 |
@bot 切换发送模式 语音 | 将音乐作为语音发送，过长时自动分段 |
@bot 切换发送模式 文件 | 将音乐作为文件发送 |
@bot 切换发送模式 默认 | 恢复管理员设置的默认模式 |
音乐卡片目前只支持 QQ 平台；其他平台会自动降级为文件或语音。
🎼 支持的音源
| 音源 | 中文命令 |
|---|---|
| 网易云音乐 | @bot 网易点歌 歌名 |
| QQ 音乐 | @bot QQ点歌 歌名 |
| 酷狗音乐 | @bot 酷狗点歌 歌名 |
| 酷我音乐 | @bot 酷我点歌 歌名 |
实际可用音源取决于管理员选择的 MetingAPI 服务。有些 API 可能只支持其中一部分平台。
🧩 会话级设置
音源和发送模式按会话隔离：
- 在一个群里执行
@bot 切换网易云，不会改变其他群或私聊的音源； - bot 重启后，会话音源可能恢复为管理员设置的默认值；
- 搜索结果有有效期，过期后需要重新搜索；
- 管理员可以限制只有发起搜索的人才能选择结果。
🤖 AI 自动点歌
插件提供 LLM 工具。用户用自然语言表达想听某首歌时，AI 可能自动调用点歌功能，例如：
@bot 我想听《坠落星空》
AI 自动调用是否成功，取决于当前模型是否支持工具调用以及管理员是否启用了相关能力。
📤 音乐会以什么形式发送？
| 形式 | 说明 |
|---|---|
| 音乐卡片 | 显示封面、歌名、歌手和跳转链接，仅 QQ 平台支持 |
| 语音 | 音乐过长时会自动分段发送 |
| 文件 | 以音乐文件形式直接发送 |
| 自动降级 | 首选方式不可用时，切换到管理员配置的备选方式 |
语音模式下，超长歌曲会被切成多个片段；默认每段不超过 120 秒，实际值由管理员配置。
⚠️ 使用注意
- 搜索和下载依赖外部 MetingAPI，API 不稳定时可能无法搜歌。
- 音乐卡片要求 AstrBot 版本不低于
4.17.6。 - 搜索结果可能会在一段时间后自动撤回或失效。
- 音源版权、地区限制和平台接口变化都可能导致歌曲无法播放。
- 过大的音乐文件可能超过管理员设置的下载上限。
- 非 QQ 平台不支持音乐卡片，会自动使用文件或语音。
- 语音和文件发送可能需要等待下载及转码，请勿连续重复发送命令。
❓ 常见问题
Q：为什么 @bot 点歌 1 提示没有搜索结果？
搜索结果可能已经过期，或者当前会话没有先执行搜歌。请重新发送：
@bot 搜歌 歌名
Q：为什么卡片没有显示？
可能原因包括：
- 当前平台不是 QQ；
- AstrBot 版本低于
4.17.6； - 音乐卡片签名服务不可用；
- 管理员切换到了语音或文件模式。
Q：为什么搜歌提示网络错误？
管理员配置的 API 地址可能不可用，或 API 类型不匹配。该问题需要管理员检查。
Q：为什么一首歌被拆成多条语音？
歌曲长度超过单条语音限制，插件会自动分段发送。
📎 项目信息
- 显示名称：初叶 MetingAPI 点歌
- 当前版本：v1.1.4
- 作者：初叶竹叶
- AstrBot 要求：
>= 4.17.6 - 开源协议：AGPL-3.0
- 项目地址：https://github.com/chuyegzs/astrbot_plugin_meting
