本文为您介绍如何开通与使用腾讯云物联网开发平台酷狗音乐增值服务。
限制条件
仅支持在以下地区激活设备开通酷狗音乐服务：
中国大陆（不含港澳台地区）
申请开通酷狗音乐服务
操作步骤
步骤一：开通酷狗音乐服务
1. 登录 物联网开发平台控制台 ，地区选择“中国区”并创建项目及产品，详情请参见 产品定义。
2. 单击左侧导航菜单产品开发进入产品列表页。
3. 选择已创建的产品进入产品详情页，单击物模型定义，在高级功能中单击“酷狗音乐服务”处按钮即可开通成功。
4. 成功开通酷狗音乐服务后，该产品的物模型会自动添加酷狗音乐服务相关的系统属性。
步骤二：创建设备
单击设备调试 > 新建设备，填写相关信息单击保存即可。
注意：
当产品下存在设备时，不可更改增值服务开关状态。
若删除已开通增值服务的设备，所购买 License 数量不可恢复。
步骤三：设备端接入指引
Android SDK 接入指引
提供面向车机、智能屏幕、TV 等 Android 终端设备的 IoT+ 音乐内容服务的 Android SDK 接入。设备移植 SDK 后，绑定在腾讯连连小程序后，可在腾讯连连小程序授权设备接入酷狗音乐的权限；通过酷狗音乐小程序可控制设备播放酷狗音乐的音频资源。
集成 SDK 方式
dependencies {implementation project(':explorer:explorer-device-tme')}
说明：
需要集成该 SDK 请线下联系，Demo 示例工程使用的是 依赖本地 explorer-device-tme 的 sdk 源码构建方式。
集成 SDK 时的注意点
在 build.gradle 文件中添加如下配置：
//目前 sdk 仅提供 armeabi-v7a 和 x86 两种so,加上 abiFilters 以防某些情况下出现加载不了 so 库的问题android {ndk {abiFilters 'armeabi-v7a', 'x86'}if (findProject(':explorer:explorer-device-tme') != null) {api project(':explorer:explorer-device-tme')}implementation 'io.reactivex.rxjava2:rxjava:2.2.10'implementation 'io.reactivex.rxjava2:rxandroid:2.1.1'implementation 'com.squareup.retrofit2:retrofit:2.6.0'implementation 'com.squareup.retrofit2:adapter-rxjava2:2.6.0'def room_version = "2.2.5"implementation "androidx.room:room-runtime:$room_version"annotationProcessor "androidx.room:room-compiler:$room_version"implementation "androidx.room:room-rxjava2:$room_version"}
在 Android6.0 以上系统时，以下需求权限需要动态申请，请确保已授权。
<uses-permission android:name="android.permission.RECORD_AUDIO" /><uses-permission android:name="android.permission.READ_PHONE_STATE" /><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
在 Application#onCreate 里调用 UltimateTv#onApplicationCreate()。
public class MyApplication extends Application {@Overridepublic void onCreate() {super.onCreate();//调用sdk的onAppcationCreateUltimateTv.getInstance().onAppcationCreate(this);...}...}
C-SDK 接入指引
概述
面向穿戴、小家电、儿童教育类等 Linux 或嵌入式操作系统终端设备的 IoT+ 酷狗音乐内容服务的 C-SDK 接入。设备移植 SDK 后，绑定在腾讯连连小程序后，可在腾讯连连小程序授权设备接入酷狗音乐的权限；通过酷狗音乐小程序可控制设备播放酷狗音乐的音频资源。
交互流程
数据模板
小程序通过数据模板下发歌单，待播放歌曲 ID。
控制播放/暂停/下一首/前一首。
设置播放进度/播放音质等。
设备通过数据模板上报播放信息，当前歌曲 ID/播放音质/播放进度等。
topic
$thing/up/property/{product_id}/{device_name}$thing/down/property/{product_id}/{device_name}
歌曲查询与歌单查询
topic
$thing/up/service/{product_id}/{device_name}$thing/down/service/{product_id}/{device_name}
数据格式
歌曲信息查询{"method": "kugou_query_song","clientToken": "与之前不重复的字符串","params": {"song_id": "xxxxx",}}{"method": "kugou_query_song_reply","clientToken": "与上行消息的保持一致","code": 0,"status": "","data":{"song_info"}}歌单查询{"method": "kugou_user_command","clientToken": "与之前不重复的字符串","timestamp": 1594108563000"params": {"album_id/playlist_id/top_id":"歌单ID","page":请求歌单的第几页歌曲从1开始, "size":每页几首歌曲,"kugou_command":"歌单查询命令"}}{"method": "kugou_user_command_reply","clientToken": "20a4ccfd-d308-11e9-86c6-5254008a4f10","code": 0,"status": "","data": {"歌单信息""total": 歌单总共多少首歌曲,"songs": [{"song_id 等信息"},{"song_id 等信息"},{"song_id 等信息"}]}}
步骤四：应用端开发接入指引
基于腾讯连连酷狗音乐免开发面板接入
需在 控制台 创建产品时选择标准品类，指定智慧生活 > 影音办公 > 背景音乐品类。
开通酷狗音乐服务后，在交互开发中选择面板类型为“免开发面板”，即可使用产品常用的标准功能，快速完成产品开发。
选择小程序免开发面板后，即可获取海量音乐资源通过设备进行播控。
基于音乐服务 SDK 接入
连连小程序用户使用指南
1. 设备绑定：使用腾讯连连小程序，扫描设备二维码进行设备绑定。（根据设备通信类型不同选择不同的绑定方式，Wi-Fi 类设备配网绑定，蜂窝类设备扫码绑定）
2. 通过连连小程序绑定设备，选择设备后进入主界面入口授权酷狗音乐服务。
3. 授权酷狗音乐服务后，即可获取海量音乐资源播控。
SDK 接入指引
应用端 SDK 使用可访问官网参考最新版本 H5 自定义开发 SDK。
设备端 SDK 使用 Github 托管，可访问 Github 下载最新版本 Android SDK 接入指南、设备端 C-SDK 接入指南。
