小度音箱对接之DuerOS开放平台智能家居技能协议分析

最新推荐文章于 2022-11-07 16:41:27 发布
最新推荐文章于 2022-11-07 16:41:27 发布
阅读量6.4k 收藏 17
点赞数 1
分类专栏： DuerOS 文章标签： 小度 DuerOS
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/mylitboy/article/details/106720429
版权

本文，旨在分析DuerOS开放平台中智能家居技能协议。
参考的官方地址： https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/protocol/intro-protocol_markdown
文中仅摘取了几条协议举例，具体参照官方文档。

文章目录

协议简介

智能家居协议是DuerOS与智能家居技能之间的通讯协议。通过这些协议您可以轻松的通过语音控制家里的智能设备，与设备进行交互。
智能家居协议使用HTTPS传输，协议采用JSON消息格式。

协议格式

智能家居协议指令（directives）由Header和Payload两部分组成。

举例如下：

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Control",
        "name": "TurnOnRequest",
        "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
        "payloadVersion": "1"
    },
    "payload": {
        "accessToken": "[OAuth token here]",
        "appliance": {
            "additionalApplianceDetails": {},
            "applianceId": "[Device ID for Light]"
        },
        "function": "light"
    }
}
Header信息

Header包含消息标识符、指令名称、命令空间和payload版本信息。

消息格式

{
    "header": {        
        "namespace": "DuerOS.ConnectedHome.Discovery",
        "name": "DiscoverAppliancesRequest",
        "messageId": "6d6d6e14-8aee-473e-8c24-0d31ff9c17a2",
        "payloadVersion": "1"
    }
}

属性说明

Header包含的属性及属性说明。

属性属性说明是否必须
namespace指令的类别。 目前支持的类别有：
DuerOS.ConnectedHome.Discovery：发现设备指令。
DuerOS.ConnectedHome.Control：控制设备指令。
DuerOS.ConnectedHome.Query：查询设备指令。		是
name指令的名称。是
messageId消息的唯一标识符，长度小于128个字符。
messageId仅用于标识消息，无其他使用。
建议使用随机生成的UUID作为messageId。		是
payloadVersionpayload的版本号。是
Payload信息

Payload的内容与Header中的name值相关，不同类型的指令，其payload内容也不相同。

举例如下：

{
    "payload": {
        "accessToken": "[OAuth token here]",
        "appliance": {
            "additionalApplianceDetails": {},
            "applianceId": "[Device ID for Light]"
        },
        "function": "light"
    }
}

协议详述

DuerOS对控制、查询、属性上报等消息进行了分类。根据不同的流程，使用不同的消息。

大致说明如下：

消息类型说明控制方向举例
发现设备小度平台向设备云发现用户的设备列表小度–请求–>设备云小度，发现设备
控制消息用户对设备的控制类消息
由小度音箱或APP发起，发送到设备云进行解析		小度–请求–>设备云小度，打开油烟机
小度，回家模式
查询消息用户查询设备的状态数据
由小度音箱或APP发起，发送到设备云进行解析		小度–请求–>设备云小度，查询烟机风速
小度，查询PM2.5
错误消息控制、查询消息，操作失败时，响应给小度的错误消息设备云–响应–>小度
设备属性主动上报当手动或其他非小度平台操作了设备后，通知到小度有属性更新
小度收到通知后，再向设备云请求设备属性信息。		设备云–请求–>小度
小度–请求–>设备云
设备信息同步消息用户设备信息发生变化时，通知给小度音箱设备云–请求–>小度
技能解绑消息通知当用户在技能商店解绑智能家居技能时，通知设备云小度–请求–>设备云

发现设备

发现设备消息用于查找用户可用的设备、可以使用的场景和设备分组信息，有DiscoverAppliancesRequest和DiscoverAppliancesResponse两个指令。DiscoverAppliancesRequest指令是发出查找设备请求，DiscoverAppliancesResponse指令回复查找到的设备。如果你的技能应用中的用户设备信息变更时,可以通过DuerOS提供的异步接口发送通知，触发用户设备信息同步到DuerOS。

DiscoverAppliancesRequest

当用户查找设备时，DuerOS会将该消息发送给技能。另外，用户每次在DuerOS技能商店启用你的技能时，此消息会自动触发一次。

Header信息

属性取值
nameDiscoverAppliancesRequest
namespaceDuerOS.ConnectedHome.Discovery

Payload信息

属性描述是否必须
accessToken设备云端获取的access token。是
openUid被授权的百度账号开放ID，与设备云账号一一对应。
设备云端需要将该字段与用户账号一一对应起来存储
其它协议中如果需要携带openUid字段时，则需要返回用户账号对应的openUid值。		是

应用举例
当用户说“小度小度，发现设备”，DuerOS理解用户为发现设备意图时或者当用户在DuerOS技能商店里启用技能并授权完成之后会向技能发送该DiscoverAppliancesRequest消息。消息示例如下：

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Discovery",
        "name": "DiscoverAppliancesRequest",
        "messageId": "6d6d6e14-8aee-473e-8c24-0d31ff9c17a2",
        "payloadVersion": "1"
    },
    "payload": {
        "accessToken": "[OAuth Token here]",
        "openUid": "27a7d83c2d3cfbad5d387cd35f3ca17b"
    }
}
DiscoverAppliancesResponse

当DuerOS请求技能查找可用设备或可用场景时，技能会返回DiscoverAppliancesResponse消息。 如果查找到设备时，会返回设备的相关信息，包括actions、applianceTypes、additionalApplianceDetails、applianceId、friendlyDescription、friendlyName等属性信息。如果没有找到设备时，会返回空数组。

Header信息

属性取值
nameDiscoverAppliancesResponse
namespaceDuerOS.ConnectedHome.Discovery

Payload信息

1. 设备信息

属性描述说明是否必须
discoveredAppliances以对象数组返回客户关联设备云帐户的设备、场景。
如客户关联帐户没有设备、场景则返回空数组。
如果在发现过程中出现错误，字段值设置为null, 用户允许接入的最大的设备数量是300。		是
discoveredAppliance.applianceTypes支持的设备、场景类型。是
discoveredAppliance.applianceId设备标识符。
标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。
标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。标识符不能超过256个字符。		是
discoveredAppliance.modelName设备型号名称，是字符串类型，长度不能超过128个字符。是
discoveredAppliance.version供应商提供的设备版本。是字符串类型，长度不能超过128个字符。是
discoveredAppliance.friendlyName用户用来识别设备的名称。
是字符串类型，不能包含特殊字符和标点符号，长度不能超过128个字符。		是
discoveredAppliance.
friendlyDescription		设备相关的描述。
描述内容需要提及设备厂商，使用场景及连接方式。
长度不超过128个字符。		是
discoveredAppliance.isReachable设备当前是否能够到达。true表示设备当前可以到达，false表示当前设备不能到达。是
discoveredAppliance.actions设备支持的操作类型数组。详细情况请参见 设备操作类型。是
discoveredAppliance.
additionalApplianceDetails		提供给设备云使用，存放设备或场景相关的附加信息，是键值对。
DuerOS不解析或使用这些数据。该属性的内容不能超过5000字节。		是
内容可以为空
discoveredAppliance.
manufacturerName		设备厂商的名字。是
discoveredAppliance.attributes设备的属性信息。
当设备没有属性信息时，协议中不需要传入该字段。
每个设备允许同步的最大的属性数量是10。
详细信息请参考设备属性及设备属性上报。		否
建议将设备属性上报，方便用户查询
discoveredAppliance.attribute.name属性名称，支持数字、字母和下划线，长度不能超过128个字符。是
discoveredAppliance.attribute.value属性值，支持多种json类型。是
discoveredAppliance.attribute.scale属性值的单位名称，支持数字、字母和下划线，长度不能超过128个字符。是
discoveredAppliance.attribute.
timestampOfSample		属性值取样的时间戳，单位是秒。是
discoveredAppliance.
attribute.
uncertaintyInMilliseconds		属性值取样的时间误差，单位是ms。
如果设备使用的是轮询时间间隔的取样方式，那么uncertaintyInMilliseconds就等于时间间隔。如温度传感器每1秒取样1次，那么uncertaintyInMilliseconds的值就是1000。		是

2. 分组信息

属性描述说明是否必须
discoveredGroupsdiscoveredGroups 对象的数组，该对象包含可发现分组，与用户设备帐户相关联的。
如果没有与用户帐户关联的分组，此属性应包含一个空数组。
如果发生错误，该属性可以为空数组[]。阵列中允许的最大项目数量为10。		是
discoveredGroups.groupName用户用来识别分组的名称, 不应包含特殊字符或标点符号，长度不超过20字符。是
discoveredGroups.applianceIds分组所包含设备ID的数组，要求设备ID必须是已经发现的设备中的ID，否则会同步失败
每个分组设备ID数量不超过50。		是
discoveredGroups.groupNotes分组备注信息，不能超过128个字符。是
discoveredGroups.additionalGroupDetails提供给技能使用的分组相关的附加信息的键值对。
该属性的内容不能超过2000字符。而且DuerOS也不了解或使用这些数据。		是，但可以为空数组[]

说明：

  • 如果没有找到设备或相关场景，此时返回的discoveredAppliances是一个空数组。如果查找设备过程中发生了错误，该字段值设置为null。
  • 当applianceTypes=ACTIVITY_TRIGGER/SCENE_TRIGGER时，场景和模式不支持通过分组来控制，比如只支持“打开回家模式”，而不支持“打开客厅的回家模式”。

此处就不举例了，示例较长。
参考官网： https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/protocol/discovery-message_markdown

控制消息

控制消息(Control Message)是对智能家居设备进行控制的消息。有门锁设备控制消息、摄像机设备控制消息、灯光设备控制消息、温度设备控制消息等。

目前支持以下设备控制消息：

在这里插入图片描述
在这里插入图片描述

以上描述及语料，纯属个人理解，具体看小度。

举个例子

TurnOnRequest

当用户想打开指定设备时，DuerOS会将该消息发送给技能。

Header信息

属性取值
nameTurnOnRequest
namespaceDuerOS.ConnectedHome.Control

Payload信息

属性描述说明是否必须
accessToken设备云端获取的access token。是
appliance设备操作的具体对象，包括applianceId和additionalApplianceDetails。是
appliance.applianceId设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。标识符不能超过256个字符。是
appliance.additionalApplianceDetails提供给设备云使用，存放设备或场景相关的附加信息，是键值对。DuerOS不解析或使用这些数据。该属性的内容不能超过5000字节。是，内容可以为空
function表示打开设备的子功能，例如，打开关闭灶台的灯光、根据此字段识别此类的请求否

应用举例

当用户说“小度小度，打开电灯”，DuerOS理解到用户意图后，向技能发送TurnOnRequest消息，消息示例如下。

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Control",
        "name": "TurnOnRequest",
        "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
        "payloadVersion": "1"
    },
    "payload": {
        "accessToken": "[OAuth token here]",
        "appliance": {
            "additionalApplianceDetails": {},
            "applianceId": "[Device ID for Light]"
        },
        "function": "light"
    }
}
TurnOnConfirmation

当请求的设备成功打开时，技能会发送该消息给DuerOS。

Header信息

属性取值
nameTurnOnConfirmation
namespaceDuerOS.ConnectedHome.Control

Payload信息

属性取值是否必须
attributes设备属性信息，支持上报一个或多个属性信息。请查看属性信息附录，了解设备的属性和上报方式。否，当设备属性信息发生变化时，建议将属性变更信息上报给DuerOS。

应用举例

当电视成功打开时，技能向DuerOS发送TurnOnConfirmation消息，示例如下。

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Control",
        "name": "TurnOnConfirmation",
        "messageId": "26fa11a8-accb-4f66-a272-8b1ff7abd722",
        "payloadVersion": "1"
    },
    "payload": {
        "attributes": []
    }
}

查询消息

查询消息(Query Message)主要是通过智能家居设备查询空气质量、查询空气湿度、查询设备温度、查询设备状态等信息。目前支持以下查询消息。

在这里插入图片描述

举个例子

GetStateRequest

当用户想了解设备状态时，DuerOS会该将消息发送给技能，比如想要了解扫地机器人当前状态(清扫中/充电中/回充中…)时，可以说，“小度小度, 扫地机器人在干吗?”， 这时技能会收到GetStateRequest消息。

Header信息

属性取值
nameGetStateRequest
namespaceDuerOS.ConnectedHome.Query

Payload信息

属性描述说明是否必须
accessToken设备云端获取的access token。是
appliance设备操作的具体对象。包括applianceId和additionalApplianceDetails。是
appliance.applianceId设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。标识符不能超过256个字符。是
appliance.additionalApplianceDetails提供给设备云使用，存放设备或场景相关的附加信息，是键值对。DuerOS不解析或使用这些数据。该属性的内容不能超过5000字节。是，内容可以为空

应用举例

用户说“小度小度，扫地机器人在干吗?”，DuerOS接收到用户意图后，向技能发送GetStateRequest消息。消息示例如下。

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Query",
        "name": "GetStateRequest",
        "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
        "payloadVersion": "1"
    },
    "payload": {
        "accessToken": "[OAuth token here]",
        "appliance": {
            "additionalApplianceDetails": {},
            "applianceId": "[Device ID for Ceiling Fan]"
        }
    }
}
GetStateResponse

当技能查询到设备当前状态时，需要给DuerOS返回该消息，告知用户当前扫地机器人的状态。

Header信息

属性取值
nameGetStateResponse
namespaceDuerOS.ConnectedHome.Query

Payload信息

属性描述说明是否必须
attributes设备的属性信息，最多支持上报10个属性。是
attribute.name属性名称，这里取"state"。是
attribute.value字符串，目前支持的属性值如下:
CLEANING：清扫中
CHARGING：充电中
RECHARGING：回充中
SLEEPING：休眠中
STAND_BY：待命中
REPORT_ERROR：报错
SHUT_DOWN：关机
REMOTE_CONTROLING：遥控中
PAUSED：已暂停
是
attribute.scale属性值的单位名称，这里是空串’’。是
attribute.timestampOfSample属性值取样的时间戳，单位是秒。是
attribute.uncertaintyInMilliseconds属性值取样的时间误差，单位是ms。是

应用举例

技能查询到“扫地机器人当前的运行状态是正在清扫时”，向DuerOS返回GetStateResponse消息，消息示例如下。

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Query",
        "name": "GetStateResponse",
        "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
        "payloadVersion": "1"
    },
    "payload": {
        "attributes": [{
            "name": "state",
            "value": "CLEANING",
            "scale": "",
            "timestampOfSample":1496741861,
            "uncertaintyInMilliseconds": 10
        }]
    }
}

错误消息

当DuerOS向技能发送设备请求信息时，请求信息中可能存在设备不支持或者超出设备使用范围等问题，此时技能会返回相应的错误类型和信息。技能不需要返回每个错误，仅返回错误对应的错误类型。本文列出了错误类型和详细信息。

在这里插入图片描述
在这里插入图片描述

举个例子

ValueOutOfRangeError

当用户请求中对设备的设置参数超过设备支持的参数范围时，DuerOS就会收到该错误消息。

Header信息

属性取值
nameValueOutOfRangeError
namespaceDuerOS.ConnectedHome.Control

Payload信息

属性描述说明是否必须
minimumValue设备的允许设置参数的最小值，是64位双精度值类型。是
maximumValue设备的允许设置参数的最大值，是64位双精度值类型。是

应用举例

如用户想把空调温度设置为10度，但是空调的温度范围是17到30度，此时技能就会发送该消息给DuerOS，说明用户输入参数范围错误。消息示例如下。

{
    "header":{
        "namespace":"DuerOS.ConnectedHome.Control",
        "name":" ValueOutOfRangeError",
        "messageId":"697fe957-c842-4545-a159-8a8c75fbe5bd"，
        "payloadVersion":"1",
    },
    "payload":{
        "minimumValue":17.0,
        "maximumValue":30.0
    }
}

设备属性主动上报

当用户手动操作设备或者通过第三方app修改设备状态，如手动关闭厨房灯，手动切换电风扇模式，使用第三方app修改设备名称等，这些情况下DuerOS不会感知到设备属性变化，需要设备云主动上报设备属性。

流程：

  1. 技能主动向DuerOS发送请求消息，请求DuerOS同步设备属性信息。

  2. DuerOS收到请求后向技能发送ReportStateRequest消息，请求技能上报相应的属性信息

  3. 技能收到请求后，将向DuerOS发送ReportStateResponse消息，上报属性信息。

主动上报请求消息

当用户手动操作设备或者通过第三方app修改设备状态时，技能会主动上报属性信息，发送上报请求消息。

接口地址

https://xiaodu.baidu.com/saiya/smarthome/changereport

请求方式

POST请求方式。

Head说明

参数名称取值
Content-Typeapplication/json

参数信息

1. Header信息

属性取值
namespaceDuerOS.ConnectedHome.Control
nameChangeReportRequest

2. Payload信息

属性描述说明是否必须
botId设备云技能ID。是
openUid用户被授权的百度账号开放ID，与设备云账号一一对应。是
appliance上报的设备对象，包括applianceId和attributeName。是
appliance.applianceId设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。标识符不能超过256个字符。是
appliance.attributeName设备的属性名称，每次仅请求上报一个属性。是

请求示例

curl -v "https://xiaodu.baidu.com/saiya/smarthome/changereport" -H 'Content-Type:application/json' -d
'{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Control",
        "name": "ChangeReportRequest",
        "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
        "payloadVersion": "1"
    },
    "payload": {
        "botId": "5385e18b-619a-abcd-ed10-33a7d69780a6",
        "openUid": "27a7d83c2d3cfbad5d387cd35f3ca17b",
        "appliance": {
            "applianceId": "[Device ID for Light]",
            "attributeName": "powerState"
        }
    }
}

说明

  • 这里主动上报的属性，属性值是通过ReportStateRequest查询到的，所以需要在ReportStateRequest协议实现中支持上对于上报属性的查询。
请求返回消息

当技能主动发起上报属性请求后，DuerOS返回确认信息。

参数说明

参数名称描述类型是否必须
status消息状态。0表示已经完成属性上报，非0表示消息异常。int是
msg消息提示信息。当状态码为0时，提示更新的属性记录数。当状态码非0时，返回对应的错误消息。string是
messageId请求消息中的messageId信息。string是
data返回消息的数据信息。array是
data.updated_attribute_num同步属性的数量。int是

返回示例

{
    “status”: 0, 
    "msg": "update 3 attributes", 
    "messageId": "请求消息中的messageId", 
    "data": {
        "updated_attribute_num": 3
    }
}
ReportStateRequest消息

当DuerOS收到技能主动上报设备属性的请求时，会向技能发送ReportStateRequest消息，请求技能上报属性的完整信息。

Header信息

属性取值
nameReportStateRequest
namespaceDuerOS.ConnectedHome.Query

Payload信息

属性描述说明是否必须
accessToken设备云端获取的access token。是
appliance设备操作的具体对象。包括applianceId和additionalApplianceDetails。是
appliance.applianceId设备标识符。标识符在用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。标识符不能超过256个字符。是
appliance.additionalApplianceDetails提供给设备云使用，存放设备或场景相关的附加信息，是键值对。DuerOS不解析或使用这些数据。该属性的内容不能超过5000字节。是，内容可以为空
appliance.attributeName查询的属性名称，字符串类型，支持数字、字母和下划线，长度不能超过128个字符。是

应用举例

当手动将关上厨房灯时，厨房灯的属性发生变化，技能主动向DuerOS发送请求，DuerOS收到请求后，向技能发送ReportStateRequest消息，消息示例如下。

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Query",
        "name": "ReportStateRequest",
        "messageId": "01ebf625-0b89-4c4d-b3aa-32340e894688",
        "payloadVersion": "1"
    },
    "payload": {
        "accessToken": "[OAuth token here]",
        "appliance": {
            "additionalApplianceDetails": {},
            "applianceId": "[Device ID for Light ]"
            "attributeName": "turnOnState"
        }
    }
}
ReportStateResponse消息

当技能收到ReportStateRequest请求消息时，会主动上报请求消息中属性的完整信息，并向技能发送ReportStateResponse消息。

Header信息

属性取值
nameReportStateResponse
namespaceDuerOS.ConnectedHome.Query

Payload信息

属性描述说明是否必须
attributes设备的属性信息，最多支持上报10个属性。是
attribute.name属性名称，支持数字、字母和下划线，长度不能超过128个字符。是
attribute.value属性值，支持多种json类型。是
attribute.scale属性值的单位名称，支持数字、字母和下划线，长度不能超过128个字符。是
attribute.timestampOfSample属性值取样的时间戳，单位是秒。是
attribute.uncertaintyInMilliseconds属性值取样的时间误差，单位是ms。如果设备使用的是轮询时间间隔的取样方式，那么uncertaintyInMilliseconds就等于时间间隔。如温度传感器每1秒取样1次，那么uncertaintyInMilliseconds的值就是1000。是

应用举例

技能获取到厨房灯的turnOnState属性时，向DuerOS发送ReportStateResponse消息，消息示例如下。

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.Query",
        "name": "ReportStateResponse",
        "messageId": "780013dd-99d0-4c69-9e35-db0457f9f2a7",
        "payloadVersion": "1"
    },
    "payload": {
        "attributes": [
            {
                "name": "turnOnState",
                "value": "OFF",
                "scale": "",
                "timestampOfSample": 1496741861,
                "uncertaintyInMilliseconds": 0
            }
        ]
    }
}

说明

  • 技能主动上报属性时，在主动上报请求消息中每次仅请求上报一个属性，在ReportStateResponse消息中除了返回请求的属性外，还可以返回设备的其他属性信息，最多支持返回10个属性信息。

设备信息同步消息

该接口为厂商通知DuerOS的接口，当技能涉及的用户设备信息发生变化时，如用户新增设备或减少设备，此时技能可以通过设备信息同步接口请求DuerOS进行设备信息同步。

请求消息说明

技能向DuerOS发送请求消息，请求DuerOS同步设备变更信息。

接口地址

https://xiaodu.baidu.com/saiya/smarthome/devicesync

请求方式

POST请求方式

参数说明

参数名称参数说明类型是否必需
botId技能ID。string是
logId技能本次请求logId。string是
openUids需要同步的用户openUid信息，每次同步的openUid不超过5个。array是

Head说明

参数名称取值
Content-Typeapplication/json

请求示例

curl -v "https://xiaodu.baidu.com/saiya/smarthome/devicesync" -H 'Content-Type:application/json' -d
'{
    "botId":"123456xyz-123456-4c5d-345677xyz",
    "logId":"123456789",
    "openUids":[
        "17a7d83c2d3cfbad5d387cd35f3ca17b"
    ]
}'
返回说明

当技能发起设备信息同步请求后，DuerOS返回信息同步确认消息。

参数说明

参数名称描述类型是否必须
status请求消息状态。0表示消息正常，非0表示消息异常。int是
msg请求消息同步状态，可能出现以下情况。
ok：表示至少一个openUid同步成功。
openUid not more than 5：表示openUid信息超过5个。
not support botId：表示技能ID不存在。
sync failed：表示请求信息同步失败。
param error：表示参数不合法。		string是
logid请求消息中的logid。string是
data返回消息的数据信息。array是
data.failed同步失败的openUid集合。array是
data.succeed同步成功的openUid集合。array是

返回示例

{
    "status": 0,
    "msg": "ok",
    "logid": "123456789",
    "data": {
        "failed": [],
        "succeed": [
            "17a7d83c2d3cfbad5d387cd35f3ca17b"
        ]
    }
}

技能解绑消息通知

该接口为DuerOS通知厂商的接口。当用户在技能商店解绑智能家居技能时，DuerOS会使用该协议通知到技能服务器，以便第三方智能家居服务提供商获取到用户的这一行为而做出相应的逻辑变化，比如，用户解绑技能后，当用户新增设备时，不再通知DuerOS。协议使用HTTPS传输，采用JSON消息格式。

UnbindBotRequest

当用在技能商店解绑该技能时，DuerOS会将该消息发送给技能。

Header信息

属性取值
nameUnbindBotRequest
namespaceDuerOS.ConnectedHome.UnbindBot

Payload信息

属性描述是否必须
accessToken设备云端获取的access token。是

应用举例

当用户在技能商店解绑了该技能时, DuerOS向技能发送UnbindBot消息，消息样例如下

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.UnbindBot",
        "name": "UnbindBotRequest",
        "messageId": "6d6d6e14-8aee-473e-8c24-0d31ff9c17a2",
        "payloadVersion": "1"
    },
    "payload": {
        "accessToken": "[OAuth Token here]"
    }
}
UnbindBotResponse

当DuerOS通知技能用户解绑了该技能，技能会返回UnbindBotResponse消息。

Header信息

属性取值
nameUnbindBotResponse
namespaceDuerOS.ConnectedHome.UnbindBot

Payload信息

Payload信息为空，DuerOS只是通知技能用户在DuerOS技能商店解绑了该技能。

应用举例

当DuerOS向技能发送了解绑消息后，技能回复DuerOS消息样例如下

{
    "header": {
        "namespace": "DuerOS.ConnectedHome.UnbindBot",
        "name": "UnbindBotResponse",
        "messageId": "6d6d6e14-8aee-473e-8c24-0d31ff9c17a2",
        "payloadVersion": "1"
    },
    "payload": {
    }
}
麦粒橙
关注
  • 1
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
小度大模型对接实现即小度二次开发接口对接
NLP与推荐算法
05-07 877
小度接入自有大模型数据
小度音箱对接之DuerOS开放平台功能分析
最新发布
南七小僧的学海无涯
03-12 125
DuerOS开放平台官方地址：技能开放平台智能家居开放平台智能家居平台，实际上是属于技能平台中的一种。DuerOS的技能可以为用户提供无限可能性，类似安卓的手机应用开发者，技能开发者也可以通过开发技能，将自己的产品和服务触达各个DuerOS智能硬件终端用户。技能开放平台提供了对话式技能所需的NLU(自然语义理解)处理和开发提供了直观的可视化编辑界面。通过编辑界面，可以便捷设计技能的意图、词典等内部逻辑，开发对话式技能。
DuerOS 智能家居测试
weixin_41306321的博客
02-13 1452
Idina Menze和Caleb Hyles激情对唱Let It Go：
第三方设备对接小度音箱 记录
hong93426的博客
08-14 4823
小度智能音响对接
小度音箱对接之DuerOS开放平台智能家居技能Java对接Demo实现
水岸梦城 技术博客
06-14 6615
近期调研中，编写了个简单的Demo，对接DuerOS的智能家居技能。 Demo源码地址：https://gitee.com/mylitboy/link-smart-speaker-demo 介绍 小度音箱DuerOS对接demo，模拟OAuth2、设备云功能。 注意： 该项目，只是对接了DuerOS的智能家居技能。 使用说明 注意： 项目使用了Lombok，建议在IDE中安装Lombok插件。 修改application.yml配置文件中，OAuth2的Client信息。 ## OAuth2.
dueros模拟测试没有请求后台_小度音箱对接之DuerOS开放平台功能分析
weixin_42362146的博客
02-06 725
由于项目需要，需要对接DuerOS，使用小度音箱控制设备。近期会对DuerOS技能平台进行一些研究，尤其是智能控制相关功能。特此记录。文章目录DuerOS开放平台简介技能分类自定义技能小技能内容资源智能家居智能家居技能创建技能配置技能1. 基础信息2. 配置服务3. 测试验证4. 发布管理DuerOS开放平台简介DuerOS开放平台官方地址： https://dueros.baidu.com/op...
java8源码-bce-duhome-dueros-demo:集成了dueros和duhome的demo(java版）
06-04
java8 源码 这是一个集成了dueros和duhome的demo项目，实现了对接dueros和...本demo的使用者是一个假想的智能家居服务商，他有两个用户，一个是bob，一个是lily，bob有一个智能设备，叫做小夜灯，而lily则没有智能
小度音箱技能开发模板
03-08
小度音箱技能开发模板是专为开发者设计的一个实践平台，主要针对小度智能音箱的语音交互功能进行定制和扩展。这个模板使用了Java语言，并包含了常见的问答技能，为初学者提供了一个良好的学习起点。通过这个模板，...
智能家居小当家 小爱音箱mini智能音箱.pdf
07-15
智能家居小当家 小爱音箱mini智能音箱.pdf
DuerOs智能硬件
11-11
DuerOs AI 智能硬件，集成项目DuerOs AI 智能硬件，DuerOs AI 智能硬件，集成项目DuerOs AI 智能硬件
智能音箱是智能家居的催化剂.pdf
07-15
智能音箱是智能家居的催化剂.pdf
智能音箱：智能家居时代的入场券.pdf
07-15
智能音箱：智能家居时代的入场券.pdf
小度音箱dueros授权
student_zz的博客
09-09 2150
小度音箱dueros授权 本文讲述小度音箱智能平台dueros的授权过程。 一、授权定位 1.在浏览器输入https://dueros.baidu.com/，你会看到下图所示： 2.点击开放平台-智能家居开放平台中的‘立即进入’，你会看到下图所示： 3.点击智能家居下的控制台。你会看到下图所示： 二、创建新技能 1.点击上图的创建新技能，输入下图中的技能名称、调用名称，然后点击确定。 2.在我的全部技能可以看到刚刚创建的技能，点击编辑。 三、授权 在授权前你必须具备关于oauth2的基础知识。
php实现小度云云对接
qq_35935748的博客
11-07 572
php实现小度对接
通过小度音响控制Modbus物联网平台设备
qq_20363995的博客
09-15 1185
Modbus云平台支持市场上99%以上Modbus设备接入，比如工业仪器仪表，串口继电器，工业传感器，Modbus PLC设备等。用户可以通过串口服务器、4G DTU、PLC工业路由器等传输设备简单配置即可上云。用户可以在任何地方远程访问任何地方的Modbus设备，并对远程设备的数据进行实时采集监控、远程控制、诊断、通讯及调试等。启用“跳动符号Modbus云平台”技能，您可以方便地通过小度智能音箱和小度智能屏，语音控制Modbus云平台上添加的Modbus通断开关类设备
WIFI、蓝牙、射频、Zigbee 浅谈智能家居的几种控制协议
wusuowei1010的博客
11-08 4332
对于普通使用智能家居的用户来说，智能家居是如何控制的不需要了解太多，需要知道的就是这个家电是否可以控制、那个家电是否可以控制。但是对于做智能家居产品的人来说，不得不面对这个问题。 简单而言，控制其实就是由控制端（手机、iPad或遥控器）发射出一个控制信号，然后被控制的家电接收信号，并对信号进行解码并作出响应。 这个控制信号我们称之为遥控协议，目前市面上的家电种类很多，又由于这些年由于智能家居的兴起...
百度人工智能发展怎么样啦？开发者能做什么？
JAVA葵花宝典
01-04 6466
人工智能，将带给人们一个新的场景和蓝海市场2019年的第一天，李彦宏以人工智能领域嘉宾的身份做客央视元旦特别节目《放歌新时代》，与主持人康辉一起展开了一场关于人工智能的对...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值