声明

本开发指南为 DuerOS Android DCS SDK v1.0 的版本说明，该工程只做为 dcs 协议示例使用。本开源版本自 2018-09-04 起不再迭代维护。 从降低开发者接入成本、减少不可控问题出现的角度出发，DuerOS 未来将主推 SDK 集成方案。

DuerOS DCS Android SDK v1.6.3.0 及以后的版本将在百度 DuerOS 开放平台提供下载链接： https://dueros.baidu.com/didp/doc/dueros-conversational-service/sdk_markdown

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 开放平台控制台： https://dueros.baidu.com/didp/product/listview
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 结构