1.1. 叮当音乐 Skill 接入流程
本文旨在介绍叮当音乐技能的接入流程，方便B端厂商快速接入叮当音乐优质的资源内容。
1.1.1. 叮当音乐skill介绍
叮当音乐skill内容介绍
| 技能名称 | 介绍 | 价格 | >头部内容 | 内容数量 |
| 叮当音乐 | 容来自腾讯QQ音乐，API方式接入，需要和腾讯叮当进行商务合作 | 15元／台／年以上 | 歌手：周杰伦、陈奕迅、王菲、张学友、刘德华、林俊杰、李荣浩、邓紫棋、艾伦.沃克、张杰、杨宗纬、李宇春、陈粒、赵雷、张靓颖、吴亦凡、金志文、胡彦斌、TFboys、胡66、华晨宇、周笔畅等 歌单&专辑：抖音神曲、中国好声音、中国新说唱、明日之子等 | 歌曲数1700W 腾讯QQ音乐音箱端版权所有歌曲 |
叮当音乐skill功能列表
| 功能 | 示例 |
| 歌手点播 | 我要听刘德华的歌 |
| 歌曲点播 | 我要听冰雨 |
| 歌手+歌曲点播 | 我要听刘德华的冰雨 |
| 播放我的收藏 | 播放我的收藏歌曲 |
| 点播专辑 | 播放周杰伦的专辑范特西 |
| 播放榜单歌曲 | 我要听新歌榜 |
| 若琪推荐 | 播放音乐 |
| 年代、场景、情绪点播 | 播放睡前音乐 |
| 语言点播 | 我要听中文歌 |
| 点播播放历史 | 播放我最近听过的歌 |
| 歌手类别点播 | 我要听华语歌手的歌 / 我要听男歌手的歌 |
| 下一首/td> | 下一首 |
| 上一首 | 上一首 |
| 停止播放 | 别放了 |
| 继续播放 | 继续播放 |
| 暂停 | 暂停播放 |
| 取消循环 | 取消单曲循环 |
| 单曲循环 | 单曲循环 |
| 从头播放 | 再放一遍 |
| 收藏/我喜欢 | 我喜欢这首歌 / 收藏 |
| 歌曲黑名单 | 我不喜欢这首歌 |
| 不取消收藏 | 取消收藏 |
| 帮助 | 介绍下音乐功能 |
| 取消订阅专辑 | 取消订阅 |
| 询问歌曲信息 | 这是什么歌/这首歌谁唱的 |
1.1.2. 叮当音乐skill接入通用流程介绍
需要合作方和若琪商务（rokidopen@rokid.com）、叮当音乐商务确定合作，确定商务协议后，进行叮当音乐skill的接入，需要进行的步骤:
获取叮当音乐App key和App secret：详细见3.1描述
若琪开放平台授权叮当音乐相关 skill：详细见3.2描述
移动端 App 内容展示/点播：详细见3.3描述
需要手机App进行内容展示时需要开发，如不需App内容展示，则无需开发。
QQ音乐账号oauth流程：详细见3.4描述
接入QQ音乐账号登录后，则合作方用户可关联其已有QQ音乐账号下的收藏歌曲，并支持收藏相关功能，如不需要QQ音乐账号登陆，则无需开发。
1.1.3. 叮当音乐skill接入流程
获取叮当音乐的App key和App Secret
每个合作商在商务流程确认后，腾讯叮当会给到该厂商持有的App Key和APP Secret，用来申请音乐资源。
若琪开放平台授权叮当音乐相关 skill
联系对接的商务进行授权。并将在叮当音乐商务给到的 App Key 和 App Secret 给到对应的商务。
移动端 App 内容展示/点播
目前叮当音乐还未开放资源展示页面，正在开发中，后续再提供移动端App内容展示界面。
QQ音乐账号oauth流程
叮当音乐未登录QQ音乐账号时可以进行点播、控制功能，但只有绑定了QQ音乐账号后，才可以享受个性化音乐推荐，使用收藏功能。
- 合作方需要在QQ互联平台创建移动应用
备注：目前腾讯已不开放微信登录能力，厂商新申请的微信登录的ID是不能打通微信登录的，只能使用QQ账号登录。
- 在QQ互联平台-应用管理-移动应用-查看处获取App ID 和 App Key，用于QQ音乐账号 oauth
将从QQ互联平台获取的App ID 和 App Key 给到对应的商务。
提供两种oauth流程接入方式：
公版APP方式： 如果是通过公版APP的方式接入，已包含oauth鉴权的流程和页面，只需在开放平台创建一个APP即可：开放平台APP配置。
SDK方式：
如果是通过SDK方式接入，则需要按照以下文档开发完成SDK接入才可以完成喜马拉雅账号oauth鉴权：
IOS：IOS端QQ音乐账号授权接入文档
Android：Android端QQ音乐账号授权接入文档
再次提醒下，目前腾讯已不开放微信登录能力，合作商新申请的微信登录的ID是不能打通微信登录的，只能使用QQ账号登录，所以不用开发微信登录。