上传群聊语音,并返回可直接发送的语音消息段。
调用
const voice = await api.upload_group_voice(self_id, group_id, file_path)
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id |
number | 是 | 在线 Bot QQ 号 |
group_id |
number | 是 | 目标群聊 ID |
file_path |
string | 是 | 后端本地路径、file:// 或后端可访问的 HTTP(S) 音频地址 |
后端通过 FFmpeg 解码常见音频格式,转换为单声道 24kHz PCM 后编码为 Silk,并生成语音波形。需要先安装并运行 FFmpeg 镜像。
返回值
{
type: 'voice',
data: {
file_id: 'FILE_ID',
duration: 5,
},
}
返回段只能发送到上传时指定的群。
示例
const voice = await api.upload_group_voice(
123456789,
987654321,
'D:/voices/example.mp3',
)
await api.send_group_msg(123456789, 987654321, [voice])
插件与萌卡NT不在同一台主机时,应传后端可访问的 HTTP(S) 地址。