/dcs-sdk-java

Primary LanguageJavaApache License 2.0Apache-2.0

DCS SDK（Java）开发者指南

DCS协议

DCS协议是DuerOS服务端与设备端之间的通讯协议，是一套把DuerOS的智能语音交互能力向所有设备开放的API，了解详情请看DCS协议文档。

摘要

DCS SDK提供DCS协议在设备端的实现，旨在降低设备接入DuerOS的开发成本。DCS SDK是完整的Sample App，可以直接在目标设备运行，并且源代码全部开源，开发者可以基于源码进行二次开发。

本文档介绍的DCS SDK（Java）是Java版本的实现，该版本目前支持Android系统。

1-前置条件

a.完成注册百度账号、开发者认证和产品创建（选择手机场景和Android平台）后，请保存client_id和client_secret

具体参考控制台接入流程。

b.在百度开发者中心配置OAuth的授权回调页

  1. 到DuerOS开放平台控制台： http://developer.dueros.baidu.com/openduer/product/getproduct
  2. 点击所创建产品的“编辑”按钮，按钮在右侧
  3. 点击OAUTH CONFIG URL，到百度开发者平台控制台
  4. 在开发者平台控制台，点击左侧“安全设置”
  5. 在“授权回调页”输入框中输入"bdconnect://cancel,bdconnect://success"（不带双引号）
  6. 点击页面下方“确定”按钮

c.开发环境

  • Android Studio 2.2+
  • Gradle 2.2+
  • Android SDK 5.0+ (支持http/2)
  • JDK 1.6+

2-克隆项目

git clone https://github.com/dueros/dcs-sdk-java.git

3-运行

a.通过Android Studio找到DcsSampleOAuthActivity.java，利用上述client_id进行替换

b.运行（Android真机）

c.百度账号登录

4-唤醒

说“小度小度”，成功唤醒后进入“录音中”状态，如下图：

5-和小度对话

a.通过唤醒或者单击“点击说话”进入录音状态， 问“北京天气怎么样”，DuerOS后端将发送stopListen指令，同时返回speak指令，播报北京天气。

b.问“播放刘若英的歌”, 返回play指令播放歌，可以从界面上进行“播放”、“暂停”、“上一首”和“下一首”操作。

6 SDK结构