JoyInside 产品使用文档

主题

技能库 - 歌曲点播 ​

「歌曲点播」是一项系统技能：针对用户听音乐需求，整合多源音频内容，实现精准点播、智能推荐，达到「张口即听」的对话体验。

启用方式详见 技能配置；协议接入详见 有声书接入（歌曲与有声书共用同一套点播协议）。

与「网易云音乐」互斥

本技能与 网易云音乐 互斥，同一应用只能二选一，启用网易云音乐时需关闭默认歌曲点播。

歌曲点播（本技能）网易云音乐
曲库平台内置无版权 6k 首（白噪音、戏曲、儿歌、流行音乐等）网易云正版曲库，弥补默认曲库覆盖不足
费用免费付费，授权 License 一次性买断 6 元 / 台（C 端使用时生效）
开通方式技能配置中自助启用特殊技能，需申请白名单授权
点播能力 / 端侧协议两者完全一致，均复用 AUDIO_BOOK_* 协议，已接入过则无需重复开发

怎么选：默认曲库够用、不想引入授权成本 → 本技能；需要正版 VIP 曲库与更广覆盖 → 网易云音乐。

与「TTS 唱歌」可同时启用（本技能为其兜底）

本技能与 TTS 唱歌 不互斥，可同时启用，平台按用户说法的意图路由：

用户说法路由结果
「我要听小星星」「听首歌」优先走本技能（播放资源库音频）
「给我唱首歌」「唱一个小星星」优先走 TTS 唱歌（由 TTS 演唱）

本技能是 TTS 唱歌的兜底：当用户要唱的歌超出 TTS 唱歌的歌单范围（约 320 首）时，会转为本技能检索资源库——命中资源则播放音频，未命中同样不播放；若未启用本技能，则只能回复用户「我还不会唱」。注意本技能需设备端对接专门的播放协议（AUDIO_BOOK_*）才能生效，未对接协议则无法提供该兜底。因此启用 TTS 唱歌时建议同时保留歌曲点播并完成端侧协议对接。

1. 支持的内容资源 ​

内容源详情说明费用
视觉中国默认无版权 6k 首（包含白噪音、戏曲、儿歌、流行音乐等）免费

音乐资源完整清单：https://joyspace.jd.com/sheets/zX27xbGAsOL2qOb6q8n2

2. 三种点播模式 ​

点播分类详情说明典型说法
精准点播指定了具体的歌曲、歌手，按内容直接搜索对应歌曲/歌手；搜索到则放入播放队列；未搜索到则兜底回复「当前无此内容」「我要听周杰伦的七里香」「播放七里香」「播放歌手的歌」
标签点播基于歌曲一二级标签搜索，如语种、人群、音乐类型等。根据标签从歌曲库中召回，并结合用户特征、热门特征、场景特征和内容特征排序，生成播放队列「听英文歌」「听儿歌」「听戏曲」
模糊点播无具体指向，通用说法。结合用户特征、热门特征、场景特征和内容特征，从歌曲库中召回歌曲并排序，生成播放队列「我要听音乐」「给我放首歌」「换一首歌」

3. 播控支持 ​

子模块说明功能
播放控制控制歌曲播放基本状态继续播放、暂停播放、重新播放
播放章节控制播放章节切换上一曲 / 下一曲

4. 能力对比 ​

有该技能无该技能
用户「播放周杰伦的七里香」→ 精准检索到歌曲，立即播放用户「播放周杰伦的七里香」→ 无法理解音乐意图，仅文字回复
用户「听英文歌」→ 基于标签召回英文歌曲，结合推荐排序生成播放队列用户「听英文歌」→ 无法解析标签，无法提供音乐内容
用户「我要听歌」→ 结合用户偏好、热门、场景等智能推荐歌曲播放用户「我要听歌」→ 无推荐能力，无法响应
队列播完后自动串场词 + 推荐续播：「点播歌曲已结束，即将为你随机推荐播放」队列播完后无后续动作，体验中断

5. 使用场景 ​

  • 居家休闲：用户做家务、休息时，语音说「放首歌」即可享受音乐陪伴。
  • 指定歌手 / 歌曲：明确想听某首歌或某位歌手的作品，精准点播即时播放。
  • 按心情 / 场景听歌：通过标签点播「听轻音乐」「听摇滚」等，获得符合当下氛围的歌曲列表。
  • 连续收听：播放队列播完后自动推荐续播，实现无缝听歌体验，无需反复唤醒操作。
  • 播放控制：随时通过语音指令暂停、继续、切歌，双手无需操作设备。

6. 端侧协议引用 🔌 ​

歌曲点播与有声书点播复用同一套 AUDIO_BOOK_* 事件族,端侧需按技术手册实现建连/开播/停播/心跳/播控全链路: