内容资源播放的最佳实践
更新时间:2025-12-23
本文提供内容资源播放实践经验及指导:控制台 服务器 端具体操作。音乐播放包括云端播放和端侧播放两种播放形式,云端播放为系统能力,本地播放需要您自行开发播放器功能。具体可以根据需求选择播放方式
一、控制台配置
1.1 开关

- 控制台创建时候打开音乐播放开关
- 成人资源是全量资源,包含儿童;
-
云播放和端播放:
- 云播放为云端直接处理并推送音乐,设备无需适配即可播放;
- 端播放为设备本地播放器播放音乐,需要端侧自行适配音频资源,可通过配置functioncall调用,以下是一些端播放配置fucntioncall建议
- 注:云播放支持开始播放、暂停播放、继续播放、上一首和下一首四种指令,并且为系统内置能力,不需要再手动配置function call(若配置播放相关functioncall会与系统能力冲突)
1.2 端播放控制function配置建议
第一步,进入【意图设置】,点击【推荐function】
第二步,在弹窗中根据需求选择播放音乐、暂停播放和继续播放对应的function
第三步,根据业务需求修改例句、描述等内容。若有其他场景(如上一首、下一首、播放xx类型歌曲),也可以根据业务需求通过自定义function的形式将指令给到端侧实现内容资源的控制。具体配置详见 意图设置



二、服务器播放方式控制:云播放or端播放
v1/aiagent/generateAIAgentCall 参数添加 :\"remote_music_player\": true
例子:"{"app_id": "appqb1g7txxabc",
"config" : "{\"llm\" : \"LLMRacing\", \"llm_token\" : \"no\",
\"rtc_ac\": \"g722\", \"remote_music_player\": true ,\"lang\" : \"zh\"}", "quick_start": true}"
参数说明参考 服务端API
三、端侧云播放控制和事件
3.1 云播放:端测会收到播放事件
| 云播放事件 | 返回事件 |
|---|---|
| 云播放开始 | [E]: [REMOTE_PLAYER_BEGIN |
| 云播放停止 | [E]: [REMOTE_PLAYER_END |
3.2 播放控制:语音控制或者发送控制命令控制
语音控制:详细见function配置的播放控制语音指令。
事件控制命令:
| 播放控制文本命令 | 详细命令 |
|---|---|
| 开始播放 | [T]:播放歌曲 |
| 停止播放 | [E]:[CMD]:[REMOTE_PLAYER]:[STOP] |
| 暂停播放 | [E]:[CMD]:[REMOTE_PLAYER]:[PAUSE] |
| 继续播放 | [E]:[CMD]:[REMOTE_PLAYER]:[RESUME] |
