# 局域网控制
 
## discovery((server)=>{console.info(server)}, type='ewelink')

传参：

| 名称         | 类型                        | 允许为空 | 说明                       |
|:-----------|:--------------------------|:-----|:-------------------------|
| onDiscover | (server: Service) => void | Y    | callback function        |
| type       | String                    | Y    | service type, 默认：ewelink |

发现符合条件的设备，返回 Service 对象，Service 对象包含以下属性：

| 名称     | 类型   | 允许为空 | 说明                                  |
| :------- | :----- | :------- | :------------------------------------ |
| name     | String | N        | 设备名称                              |
| host     | String | N        | 设备 IP 地址                          |
| port     | Number | N        | 设备端口                              |
| type     | String | N        | 设备类型                              |
| subtypes | Array  | Y        | 设备子类型，如：[ 'switch', 'light' ] |
| protocol | String | Y        | 传输协议，udp 或 tcp，默认：tcp       |
| txt      | Object | Y        | TXT 记录                              |

txt 记录中的内容：

| 名称    | 类型   | 允许为空 | 说明                                                                                                                                                                                                                                                         |
| :------ | :----- | :------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id      | String | N        | 设备 id                                                                                                                                                                                                                                                      |
| txtvers | String | N        | TXT 记录版本号，必须为 1                                                                                                                                                                                                                                     |
| type    | String | N        | 设备类型，如：switch                                                                                                                                                                                                                                         |
| apivers | String | N        | 设备 API 接口版本，如：1                                                                                                                                                                                                                                     |
| encrypt | String | N        | 是否加密，如：true                                                                                                                                                                                                                                           |
| data1   | String | N        | 设备状态信息，如：{ "switch": "on" } ，默认加密|
| seq     | String | N        | TXT 记录序列号，从 1 开始递增的正整数，用于表示 TXT 记录更新的先后顺序                                                                                                                                                                                       |
| iv      | String | N        | 加密时的初始化向量，加密算法必须为“AES-128-CBC/PKCS7Padding”（AES 128 Cipher Block Chaining (CBC) with PKCS7 Padding），当设备信息（未加密或已加密后的字符串）长度超过 249 个字节时，必须将前 249 个字节存储在 data1 中，剩余字节放在 data2、data3、data4 中 |

## encrypt(data, secretKey, iv)

功能：加密

传参：

| 名称      | 类型   | 允许为空 | 说明       |
| :-------- | :----- | :------- | :--------- |
| data      | String | N        | 待加密内容 |
| secretKey | String | N        | 密钥       |
| iv        | String | N        | 向量       |

返回：

| 名称 | 类型   | 允许为空 | 说明     |
| :--- | :----- | :------- | :------- |
| data | String | N        | 加密内容 |

## decrypt

功能：解密

传参：

| 名称      | 类型   | 允许为空 | 说明       |
| :-------- | :----- | :------- | :--------- |
| data      | String | N        | 待解密内容 |
| secretKey | String | N        | 密钥       |
| iv        | String | N        | 向量       |

返回：

| 名称 | 类型   | 允许为空 | 说明       |
| :--- | :----- | :------- | :--------- |
| data | Object | N        | 解密的内容 |

## getDeviceIpPort

功能：获取设备的 IP 和端口

传参：

| 名称   | 类型    | 允许为空 | 说明      |
| :----- | :------ | :------- | :-------- |
| server | Service | N        | mDNS 服务 |

返回：

| 名称 | 类型   | 允许为空 | 说明     |
| :--- | :----- | :------- | :------- |
| result | Object | N        | IP 和 Port 信息 |
| ip   | String | N        | 设备 IP  |
| port | Number | N        | 设备端口 |

## generalRequest(serverOptions)

功能：发送局域网控制请求

传参：

| 名称                     | 类型    | 允许为空 | 说明                  |
| :----------------------- | :------ | :------- | :-------------------- |
| serverOptions            | Object  | N        | 服务内容              |
| serverOptions.method     | String  | N        | 请求方法              |
| serverOptions.ip         | String  | N        | 设备 IP               |
| serverOptions.port       | Number  | N        | 设备端口              |
| serverOptions.path       | String  | N        | 请求路径              |
| serverOptions.deviceId   | String  | N        | 设备 ID               |
| serverOptions.data       | Object  | N        | 控制指令              |
| serverOptions.encrypt    | Boolean | N        | 是否加密请求数据      |
| serverOptions.secretKey  | String  | Y        | 加密密码              |
| serverOptions.iv         | String  | Y        | iv                    |
| serverOptions.selfApikey | String  | Y        | 当前用户的 Apikey |

返回：

| 名称     | 类型    | 允许为空 | 说明                     |
| :------- | :------ | :------- | :----------------------- |

| sequence | String  | N        | 时间戳                   |
| error    | Number  | N        | 错误码                   |
| encrypt  | Boolean | N        | 是否加密                 |
| seq      | Number  | N        | 请求序列号，每次控制时+1 |

## zeroconf.switch({...controlOptions, data: {switch: 'on'}})

功能：单通道设备开关

传参：

| 名称                      | 类型    | 允许为空 | 说明                     |
| :------------------------ | :------ | :------- | :----------------------- | ------- |
| controlOptions            | Object  | N        | 控制选项                 |
| controlOptions.ip         | String  | N        | 目标 IP                  |
| controlOptions.port       | Number  | N        | 目标端口                 |
| controlOptions.deviceId   | String  | N        | 设备 ID                  |
| controlOptions.data       | Object  | N        | 控制指令，{ switch: "on" | "off" } |
| controlOptions.encrypt    | Boolean | N        | 是否加密请求数据         |
| controlOptions.secretKey  | String  | Y        | 加密密码                 |
| controlOptions.iv         | String  | Y        | iv                       |
| controlOptions.selfApikey | String  | Y        | 当前用户的 Apikey    |

返回：

参数类型：Object

| 名称     | 类型    | 允许为空 | 说明                     |
| :------- | :------ | :------- | :----------------------- |
| sequence | String  | N        | 时间戳                   |
| error    | Number  | N        | 错误码                   |
| encrypt  | Boolean | N        | 是否加密                 |
| seq      | Number  | N        | 请求序列号，每次控制时+1 |

## zeroconf.switches({...controlOptions, data: {switches: [ {switch: 'on', outlet: 0}, {switch: 'on', outlet: 1}, {switch: 'on', outlet: 2}, {switch: 'on', outlet: 3}]}})

功能：多通道设备开关

传参：

data 参数说明：

| 名称                 | 类型   | 允许为空 | 说明                |
| :------------------- | :----- | :------- | :------------------ |
| switches             | Array  | N        | 4 个通道的开关状态  |
| switches[num].switch | String | N        | 开关状态，on 或 off |
| switches[num]outlet  | Number | N        | 通道号，从 0 开始   |

其他与 zeroconf.switch 一致

## zeroconf.sledOnline({...controlOptions, data: {sledOnline: true}})

功能：网络指示灯开关

传参：

data 参数说明：

| 名称       | 类型    | 允许为空 | 说明           |
| :--------- | :------ | :------- | :------------- |
| sledOnline | Boolean | N        | 网络指示灯开关 |

其他与 zeroconf.switch 一致

## zeroconf.startups({...controlOptions, data: {configure: [{startup: 'on', outlet: 0}, {startup: 'on', outlet: 1}, {startup: 'on', outlet: 2}, {startup: 'on', outlet: 3}], startup: {0: {startup: 'on'}, 1: {startup: 'on'}, 2: {startup: 'on'}, 3: {startup: 'on'}}})

功能：四通道设备上电状态设置

传参：

data 参数说明：

| 名称                 | 类型   | 允许为空 | 说明                       |
| :------------------- | :----- | :------- | :------------------------- |
| configure            | Array  | N        | 4 个通道的状态             |
| startup              | Object | N        | 通道状态                   |
| startup[num].startup | String | N        | 开机状态，on 、off 或 stay |
| startup[num]outlet   | Number | N        | 通道号，从 0 开始          |

其他与 zeroconf.switch 一致

## zeroconf.pulses({...controlOptions,data: {pulses: [{width: 500, outlet: 0, pulse: 'off'}, {width: 500, outlet: 1, pulse: 'off'}, {width: 500, outlet: 2, pulse: 'off'}, {width: 500, outlet: 3, pulse: 'off'}]}})

功能：四通道设备脉冲设置

传参：

data 参数说明：

| 名称              | 类型   | 允许为空 | 说明                             |
| :---------------- | :----- | :------- | :------------------------------- |
| pulses            | Array  | N        | 4 个通道的状态                   |
| pulses[num].width | Number | N        | 脉冲时间，单位：毫秒，步长 500ms |
| pulses[num]outlet | Number | N        | 通道号，从 0 开始                |
| pulses[num]pulse  | Number | N        | 状态，打开 on ，关闭 off         |

其他与 zeroconf.switch 一致

## zeroconf.encrypt(...controlOptions,data: { encrypt: true }}})

功能：加密设置（影响 APP 控制）

传参：

data 参数说明：

| 名称    | 类型    | 允许为空 | 说明     |
| :------ | :------ | :------- | :------- |
| encrypt | Boolean | N        | 是否加密 |

其他与 zeroconf.switch 一致

## zeroconf.password({...controlOptions,data: {oldPassword, newPassword}}})

功能：修改加密密码（影响 APP 控制）

传参：

data 参数说明：

| 名称        | 类型   | 允许为空 | 说明     |
| :---------- | :----- | :------- | :------- |
| newPassword | String | N        | 加密密码 |
| oldPassword | String | N        | 旧密码   |

其他与 zeroconf.switch 一致
