DCA SDK创建引导

DCA(DUI Companion APP) SDK 提供了整套的移动开发支持,能让开发者的移动应用拥有对搭载思必驰语音服务的设备进行配网、指令发送、技能控制、设备管理、智能家居控制等交互能力。目前支持手机系统有:iOS(苹果)、Android(安卓)

一、接入前准备

1、如果您使用的是思必驰音箱、故事机、电视整体解决方案或整机设备,您可以直接接入

2、如果您的设备仅使用思必驰DDS SDK(语音全链路SDK),您的设备需要先接入DLA协议(DUI Linking APP),DLA协议包括:

  • 配网协议(非必须);帮助无屏设备实现蓝牙、声波、Wi-Fi配网
  • 设备账号授权(必须);APP将用户账号信息(Access Token)通过一定方式(例如MQTT)传给设备,设备获取Access Token访问相关技能服务
  • 音频播控(非必须);实现APP将音频推送到设备进行播放,并支持音量调节、上一首/下一首/暂停播放等
  • 其他(非必须);APP与设备其他相关的交互,例如闹钟提醒、开关控制

3、如果您的设备还没有实现配网、播控等功能且不想额外开发接入DLA,建议直接使用思必驰的语音整体解决方案(通过商务方式联系思必驰项目经理),快速实现方案落地

二、创建SDK应用

登录DUI账号

选择申请使用DCA SDK,进入DUI移动管理平台,若DUI账号未登录,请登录DUI平台。如果未有账号,则点击旁边的【立即注册】按钮进行注册,如下图所示

 

创建应用

点击右上角【新建】开始创建您的应用,选择“DCA SDK”,填写应用基础信息

  • 公司名称:默认使用您注册DUI账号时填写的公司名称,也可以手动修改
  • 产品类型:选项包括音箱、电视、故事机、耳机、通用、其他
  • 设备名称:不超过20个字符,仅支持中文、英文和数字
  • 设备图片:尺寸300x300,仅支持png
  • 账号接入方式:默认为思必驰账号,如果你没有自己的账号系统,建议直接使用思必驰账号,接入简单快速

 

DCA SDK支持开发者使用自有账号系统,自有账号需要跟思必驰账号进行互通,互通流程请参考:Android DCA SDK接入文档4.2章

选择自有账号,需要开发者提供以下参数,用于申请账号互通相关的key

Manufacture:公司英文表示,仅支持字母和数字,不超过10个字符

Token-address:账号互通时开发者需要提供的账号校验服务地址,用于校验贵司token合法性,提供前请详细阅读账号互通流程,遇到问题时请联系思必驰项目经理nianxin.xia@aispeech.com

 

等待审核

创建后点击提交,DCA SDK进入审核阶段,我们工作人员将在1个工作日之内完成审核,在此期间开发者可以重新提交,审核后将返回集成DCA SDK的必要参数

APIkey:SDK鉴权参数,SDK初始化时使用

APIsecret:SDK鉴权参数,SDK初始化时使用

Client_id:设备账号授权参数,语音中控设备授权时使用,具体可参考DLA协议或直接使用思必驰语音解决方案

Client_name:设备账号授权参数,语音中控设备授权时使用,默认为设备名称全拼,也可以修改

Redrect_url:设备账号授权重定向URL,默认为http://dui.callback,若无特殊要求请勿修改

Manufacture Secret:厂商密文,账号互通时使用,使用思必驰账号的开发者请忽略

 

 

审核成功

工作人员审核成功后,SDK需要的参数系统会自动生成,开发者可复制粘贴后使用,审核成功后如果需要修改token-address账号互通校验地址,可修改并重新保存提交,待审核后生效

三、运营配置

申请完SDK参数并成功集成SDK后,开发者可以在移动管理平台运营管理自己的内容和应用,包括banner配置、专辑内容配置、技能运营配置

首页banner

开发者可配置最多5张首页轮播图,按照要求上传banner图、banner标题、类型以及跳转地址;其中轮播图类型包括广告、新功能介绍或内容专辑,广告和新功能介绍需填写跳转的外部URL,而内容专辑选择要跳转的某一专辑(需先配置专辑);点击确定后创建banner成功,点击右上角发布立即在APP首页生效

 

专辑分类管理

具体请联系对接商务或者项目经理。

 

技能中心配置

  • 技能轮播图:配置技能中心的轮播图,可配置轮播图图片以及跳转,跳转只能跳转到推荐的某一技能详情。需要先配置该技能的详情信息
  • 技能分类:配置技能中心的技能分类名称和icon,点击某一分类,则呈现该类别下的所有技能列表
  • 技能管理:配置您的设备支持的系统技能,包括技能icon、技能名称、技能分类、使用说明、技能描叙、技能示例;可手动配置,也可以输入您设备的productID(从DUI控制台获取)快速导入
  • 技能页运营:配置技能运营板块,例如新增热门技能,推荐用户感兴趣的语音技能