Diff: dcs-sdk-java-master/README.md

Revision:

45:2aa9f933c8d2

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/dcs-sdk-java-master/README.md	Tue Jul 18 16:34:48 2017 +0800
@@ -0,0 +1,71 @@
+# DCS SDK（Java）开发者指南
+
+## DCS协议
+
+DCS协议是DuerOS服务端与设备端之间的通讯协议，是一套把DuerOS的智能语音交互能力向所有设备开放的API，了解详情请看[DCS协议文档](http://developer.dueros.baidu.com/doc/dueros-conversational-service/introduction_markdown)。
+
+## 摘要
+
+DCS SDK提供DCS协议在设备端的实现，旨在降低设备接入DuerOS的开发成本。DCS SDK是完整的Sample App，可以直接在目标设备运行，并且源代码全部开源，开发者可以基于源码进行二次开发。
+
+本文档介绍的DCS SDK（Java）是Java版本的实现，该版本目前支持Android系统。
+
+## 1-前置条件
+
+a.完成注册百度账号、开发者认证和产品创建（选择手机场景和Android平台）后，请保存client_id和client_secret
+
+![](images/client-id-secret.png)
+
+具体参考[控制台接入流程](http://developer.dueros.baidu.com/doc/overall/console-guide_markdown)。
+
+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-克隆项目
+
+```shell
+git clone https://github.com/dueros/dcs-sdk-java.git
+```
+
+## 3-运行
+
+a.通过Android Studio找到DcsSampleOAuthActivity.java，利用上述client_id进行替换
+
+![](images/modify-client-id.png)  
+
+b.运行（Android真机）
+
+![](images/login1.png)
+
+c.百度账号登录
+
+![](images/login2.png)
+
+## 4-唤醒
+
+说“小度小度”，成功唤醒后进入“录音中”状态，如下图：
+
+![](images/wakeup.png)
+
+## 5-和小度对话
+
+a.通过唤醒或者单击“点击说话”进入录音状态， 问“北京天气怎么样”，DuerOS后端将发送stopListen指令，同时返回speak指令，播报北京天气。
+
+b.问“播放刘若英的歌”, 返回play指令播放歌，可以从界面上进行“播放”、“暂停”、“上一首”和“下一首”操作。
+
+## 6 SDK结构
+
+![](images/sdk-architecture.png)
+
+![](images/access-architecture.png)