> For the complete documentation index, see [llms.txt](https://doc.youzhuan.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.youzhuan.net/dev-link-host/zhi-neng-jia-ju-xie-yi.md).

# 智能家居协议

## 简介

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

## 协议说明

### 身份认证

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

### 组成说明

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

**Header信息**

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

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

**Header属性说明**

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

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

#### Payload信息

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