bowen liu / Mbed OS mbed-os-example-blinky

ex

Fork of mbed-os-example-mbed5-blinky by mbed-os-examples

dumi_doc-master/doc/directives/SmartHomeControl.md@44:c1d8923072ba, 2017-07-18 (annotated)

Committer:
TMBOY
Date:
Tue Jul 18 16:27:22 2017 +0800
Revision:
44:c1d8923072ba
?

Who changed what in which revision?

UserRevisionLine numberNew contents of line
TMBOY 44:c1d8923072ba 1 # SmartHomeControl
TMBOY 44:c1d8923072ba 2
TMBOY 44:c1d8923072ba 3 ## Table of Contents
TMBOY 44:c1d8923072ba 4
TMBOY 44:c1d8923072ba 5
TMBOY 44:c1d8923072ba 6 * [SmartHomeControl](#smarthomecontrol)
TMBOY 44:c1d8923072ba 7 * [Table of Contents](#table-of-contents)
TMBOY 44:c1d8923072ba 8 * [总体逻辑](#总体逻辑)
TMBOY 44:c1d8923072ba 9 * [上报SmartHomeControl状态](#上报smarthomecontrol状态)
TMBOY 44:c1d8923072ba 10
TMBOY 44:c1d8923072ba 11
TMBOY 44:c1d8923072ba 12 ## 总体逻辑
TMBOY 44:c1d8923072ba 13
TMBOY 44:c1d8923072ba 14 这个协议用于用一个可以语音交互的设备，去控制可联网的其它设备
TMBOY 44:c1d8923072ba 15
TMBOY 44:c1d8923072ba 16 客户端在请求中上报当前可以被控制的设备列表，da如果识别出语音请求是在操作设备列表中的某个设备（比如用户说：“打开客厅的电视”，设备列表中存在一项“客厅的电视”），就会返回设备控制的intent，并在槽位中加上target_device字段
TMBOY 44:c1d8923072ba 17
TMBOY 44:c1d8923072ba 18
TMBOY 44:c1d8923072ba 19 ## 上报SmartHomeControl状态
TMBOY 44:c1d8923072ba 20
TMBOY 44:c1d8923072ba 21 在[请求](../api/request.md)中的device_status字段
TMBOY 44:c1d8923072ba 22
TMBOY 44:c1d8923072ba 23 ```javascript
TMBOY 44:c1d8923072ba 24 "device_status":{
TMBOY 44:c1d8923072ba 25 "SmartHomeControl":{
TMBOY 44:c1d8923072ba 26 "target_devices":[
TMBOY 44:c1d8923072ba 27 {"name":"客厅的电视","id":"xxxxxx","type":"duer_iot"},//type、id可选
TMBOY 44:c1d8923072ba 28 {"name":"厨房的音箱","id":"yyy"}
TMBOY 44:c1d8923072ba 29 ],
TMBOY 44:c1d8923072ba 30 },
TMBOY 44:c1d8923072ba 31 },
TMBOY 44:c1d8923072ba 32 ```
TMBOY 44:c1d8923072ba 33
TMBOY 44:c1d8923072ba 34 target_devices是设备列表，一个设备的描述包含如下字段
TMBOY 44:c1d8923072ba 35 * name 必选，设备名字，会用这个值做query的匹配
TMBOY 44:c1d8923072ba 36 * id 可选，代表设备id
TMBOY 44:c1d8923072ba 37 * type 可选，设备类型，代表
TMBOY 44:c1d8923072ba 38
TMBOY 44:c1d8923072ba 39 被用户query选中要操作的设备，以上设备描述字段会完整的发给bot（会放在da解析的槽位中），由bot完成最终的控制操作（比如调用设备云接口），并且由bot返回给用户的反馈（指在主控设备上的反馈）