JoyInside 产品使用文档

主题

技能库 - 网易云音乐 ​

「网易云音乐」是一项付费系统技能:接入网易云音乐正版曲库,把用户张口点歌的意图直接命中海量正版内容,弥补默认曲库(6k 首无版权)在流行、热门、艺人歌单上的覆盖不足。

前置约束(启用前请务必确认)

  1. 所有接入前均需商务对接:使用此功能需向 JoyInside 团队 zhaoyingxue11 沟通,可请对接人帮忙联系,配置白名单权限;
  2. 与「歌曲点播」互斥:同一应用只能二选一启用,不可同时生效(详见 §1);
  3. 授权 License 一次性买断,6 元 / 台,在 C 端用户使用时生效。C 端用户支持自主绑定网易云账号:未登录状态可收听非 VIP 曲库;登录网易云账号后可收听 VIP 曲库内容。

启用方式详见 技能配置;协议接入详见 有声书接入(网易云音乐与歌曲点播、有声书点播共用同一套 AUDIO_BOOK_* 端侧协议)。

1. 与「歌曲点播」的关系(互斥) ​

互斥关系

网易云音乐与 歌曲点播 为互斥技能,同一应用只能二选一启用,不可同时生效:

  • 选择 默认歌曲点播 → 使用平台内置无版权 6k 首曲库,免费;
  • 选择 网易云音乐 → 使用网易云正版全曲库,付费(见 §2)。
维度默认歌曲点播网易云音乐技能
曲库规模默认无版权 6k 首(白噪音、戏曲、儿歌、部分流行)网易云正版全曲库(百万级,含最新热歌、艺人独家)
版权平台内置无版权资源网易云正版授权
费用免费授权 License 一次性买断,6 元 / 台(C 端使用时生效)
用户登录无需登录支持自主绑定网易云账号:未登录听非 VIP,登录后听 VIP
授权无需额外申请需商务沟通 + 申请白名单
端侧协议AUDIO_BOOK_* 事件族AUDIO_BOOK_* 事件族(完全一致)
点播模式精准 / 标签 / 模糊 三种精准 / 标签 / 模糊 三种(能力对齐)

选型建议:

  • 儿童设备、成本敏感场景 → 默认歌曲点播足够;
  • 面向 C 端用户的家居 / 车载 / 音箱等重内容场景 → 网易云音乐技能,曲库丰富度直接影响留存与 NPS;此外建议品牌方在自有 App / 小程序侧配合做定制化开发(如网易云账号绑定入口、VIP 权益引导等),具体接入方式请参见技术说明书。

2. 计费与权益说明 💰 ​

项目规则
计费方式授权 License 一次性买断(在 C 端用户使用时生效)
单价6 元 / 台
C 端账号绑定支持 C 端用户在设备/App 侧自主绑定网易云账号
未登录可收听网易云非 VIP 曲库
登录网易云账号可收听 VIP 曲库(享用户在网易云侧的对应权益)
与授权关系白名单授权是准入前提,License 一次性买断后不再重复收取

3. 三种点播模式(与歌曲点播一致) ​

点播分类详情说明典型说法
精准点播指定具体歌曲、歌手,按内容直接搜索;命中即入队列;未命中兜底「当前无此内容」「我要听周杰伦的七里香」「播放告白气球」
标签点播基于歌曲一二级标签(语种、人群、类型、心情)召回,结合用户/热门/场景/内容特征排序「听英文歌」「听摇滚」「放点安静的」
模糊点播无具体指向,通用听歌意图,基于用户偏好 + 热门 + 场景推荐「我要听歌」「随便放首歌」「换一首」

4. 播控支持 ​

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

5. 能力对比 ​

前置条件

以下对比针对「同一应用二选一」场景 —— 启用网易云音乐 vs 仅启用默认歌曲点播:

启用网易云音乐仅启用默认歌曲点播
用户「播放周杰伦最新专辑」→ 命中网易云正版曲库,即时播放用户「播放周杰伦最新专辑」→ 默认库无正版资源,兜底「当前无此内容」
用户「听 2025 热歌榜」→ 网易云榜单实时同步,按榜单顺序播放用户「听 2025 热歌榜」→ 默认库无榜单能力,无法响应
用户「随便放首歌」→ 结合网易云个性化推荐 + 用户偏好,推荐命中率高用户「随便放首歌」→ 从 6k 首默认库随机推荐,内容单一
队列播完后自动串场词 + 网易云推荐续播队列播完后无后续动作,体验中断

6. 使用场景 ​

  • 家居休闲:用户做家务、休息时,「放首周杰伦」直接命中正版最新专辑;
  • 心情场景:「放点安静的 / 放点摇滚」按标签自动生成场景歌单;
  • 热门实时:「听最近的热歌」跟随网易云榜单实时更新;
  • 连续收听:队列播完自动推荐续播,实现零操作陪伴听歌;
  • 播控语音化:随时说「暂停 / 继续 / 下一首」,双手无需触碰设备。

7. 开通流程 ​

前置提示

所有接入前都需先与商务对接,以下 step1 是所有接入方的必经环节:

  1. 商务对接:使用此功能需向 JoyInside 团队 zhaoyingxue11 沟通,可请对接人帮忙联系;
  2. 技能互斥确认:确认应用当前的歌曲点播启用状态 —— 网易云音乐与 歌曲点播 互斥,启用网易云音乐时需同步关闭默认歌曲点播;
  3. 签署授权与买断:完成网易云音乐版权授权与商务合同,授权 License 一次性买断 6 元 / 台(C 端使用时生效);
  4. 白名单开通:JoyInside 团队为对应企业配置白名单权限;
  5. 智能体侧启用:进入 技能配置,勾选「网易云音乐」加入当前智能体的技能列表;
  6. 设备端接入:若尚未接入过 歌曲点播 / 有声书点播,需先按 AUDIO_BOOK_* 协议完成端侧对接;若已接入过,无需重复开发;
  7. 品牌 App / 小程序定制开发(建议):建议品牌方 / 合作方在自有 App、小程序侧配合做定制化开发(如网易云账号绑定入口、VIP 权益引导、播放态展示等);具体接入方式与协议规范请等待技术说明书后续版本更新;
  8. 联调验证:通过 批量测试 与端到端联调,确认点播命中率与播控正常。

8. 端侧协议引用 🔌 ​

网易云音乐技能与歌曲点播、有声书点播完全复用同一套 AUDIO_BOOK_* 事件族,端侧无需为该技能单独开发协议:

9. Q&A ​

Q1:已经启用了歌曲点播,还需要单独启用网易云音乐吗?两者互斥,同一应用只能二选一。启用网易云音乐时需同步关闭默认歌曲点播 —— 用户对「点歌」的意图会由网易云音乐技能统一承接,命中网易云正版曲库。

Q2:6 元/台 是一次性还是周期费用?授权 License 一次性买断,一次付费后不再重复收取;费用在 C 端用户使用时生效。

Q3:C 端用户需要登录网易云账号吗? 不强制。设备/App 侧支持 C 端用户自主绑定网易云账号:未登录状态即可收听非 VIP 曲库;登录网易云账号后即可收听 VIP 曲库,享用户在网易云侧的对应 VIP 权益。

Q4:端侧需要新增开发吗? 不需要单独开发。网易云音乐与 歌曲点播 / 有声书点播 复用同一套 AUDIO_BOOK_* 协议,若这两项技能已完成端侧对接,则网易云音乐即插即用。

Q5:授权和费用是绑定的吗?可以只授权不付费吗? 不可以。白名单授权是使用前提,费用为一次性买断,两者共同构成启用条件。