云音乐播放的最佳实践
更新时间：2025-10-20
本文提供一些内容资源播放实践经验及指导：控制台 服务器 端具体操作
一、控制台配置
内容资源播放支持开始播放、暂停播放、继续播放、上一首和下一首四种指令，其中暂停播放和继续播放通过Function Call控制，暂停播放后，可通过继续指令接着播放之前的音乐或故事，下面讲描述如何配置播放控制的Function Call。
1.1 开关
控制台创建时候打开音乐播放开关
1.2 内容资源播放控制funciton配置支持
- Function 名称:play_control, 注：名称不可更改
- Function 描述:播放控制，暂停播放，继续播放 描述写的尽可能全面
- Function 例句:目前支持暂停播放和继续播放场景下的指令，填写内容参考下方表格，填写尽可能详尽
- 每一个类别的指令写在一行，中间用；隔开。
- 例句内不得出现标点符号
- 例句穷举，这里关乎到意图识别的准确性，需尽量穷尽用户使用场景内可能有的互动语言方式
- 请求地址:选择【发送 SDK 消息】
- 输入参数:
- 参数名:mode
- 参数类型:String
- 是否必填:是
- 参数描述:播放控制的模式，取值该列表中的一种:[pause(暂停播放)、resume(继续播放)]
音乐播放例句填写参考
| 场景 | Function例句 |
|---|---|
| 暂停播放 | 暂停播放；暂停音乐；暂停故事；把音乐停一下；暂停这首歌；请暂停；停止播放；停下音乐；别放了；我不想听音乐了；我不想听歌了；我不想听了 |
| 继续播放 | 继续播放；可以接着放了；现在继续刚才的；恢复播放吧刚才暂停了；接着来刚才停了一下 |
二、服务器播放方式控制：云播放or端播放
generateAIAgentCall接口config参数控制音乐播放方式：云播放or本地播放
v1/aiagent/generateAIAgentCall 参数添加 ：\"remote_music_player\": true
例子："{"app_id": "appqb1g7txxabc",
"config" : "{\"llm\" : \"LLMRacing\", \"llm_token\" : \"no\",
\"rtc_ac\": \"g722\", \"remotemusicplayer\": true ,\"lang\" : \"zh\"}", "quick_start": true}"
三、端侧云播放控制和事件
3.1 云播放：端测会收到播放事件
| 云播放事件 | 返回事件 |
|---|---|
| 云播放开始 | [E]: [REMOTE_PLAYER_BEGIN |
| 云播放停止 | [E]: [REMOTE_PLAYER_END |
3.2 播放控制：语音控制或者发送控制命令控制
语音控制：详细见fuction配置的播放控制语音指令。
事件控制命令：
| 播放控制文本命令 | 详细命令 |
|---|---|
| 开始播放 | [T]:播放歌曲 |
| 停止播放 | [E]:[CMD]:[REMOTE_PLAYER]:[STOP] |
| 暂停播放 | [E]:[CMD]:[REMOTE_PLAYER]:[PAUSE] |
| 继续播放 | [E]:[CMD]:[REMOTE_PLAYER]:[RESUME] |