智能家居协议

右转智能家居通信协议详细介绍

简介

智能家居协议是右转智能主机与智能家居设备之间的通讯协议。通过这些协议您可以通过语音，主机上的图形界面控制家里的智能设备，与设备进行交互。智能家居协议使用HTTPS传输，协议采用JSON消息格式。

协议说明

身份认证

智能家居协议遵循OAuth2.0规范。 从右转智能主机发送到智能设备的每个请求都包含OAuth的access token。

组成说明

智能家居协议由Header和Payload两部分组成。

Header信息

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

{
    "header": {        
        "namespace": "YouZhuan.ConnectedHome.Discovery",
        "name": "DiscoverAppliancesRequest",
        "messageId": "xxxxx-xxxx-xxxx-xxx",
        "payloadVersion": "1"
    }
}

Header属性说明

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

属性	属性说明	是否必须
namespace	指令的类别。 目前支持的类别有： 1: YouZhuan.ConnectedHome.Discovery：发现设备指令。 2: YouZhuan.ConnectedHome.Control：控制设备指令。	是
name	指令的名称。	是
messageId	消息的唯一标识符，messageId仅用于标识消息 无其他使用。建议使用随机生成的UUID作为messageId。	是
payloadVersion	payload的版本号。	是

Payload信息

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