---
title: 设备通信协议
summary: WiFi、BLE、Beacon、BLE Mesh、Zigbee 等照明设备通信协议下的开发注意事项。
---

## 设备通信协议

### 一、WiFi
#### 1. 什么是 WiFi
- 具体介绍查看 [WiFi 基础知识 wiki](https://zh.wikipedia.org/wiki/Wi-Fi) 或 [WiFi 基础知识 百科](https://baike.baidu.com/item/Wi-Fi/151036)
#### 2. 项目开发
- 注意事项
  - WiFi、BLE、Zigbee设备滑动过程中，灯光随调色板变化而变化，面板显示与灯光颜色一致。
  - WiFi 设备离线提示时间在 150s 左右，即设备离线后 150s 后才会发送事件给 APP 通知。

### 二、BLE
#### 1. 什么是 BLE
- 具体介绍查看 [BLE 基础知识 wiki](https://zh.wikipedia.org/wiki/%E8%93%9D%E7%89%99%E4%BD%8E%E5%8A%9F%E8%80%97) 或 [BLE 基础知识 百科](https://baike.baidu.com/item/%E8%93%9D%E7%89%99%E4%BD%8E%E8%83%BD%E8%80%97/12806839?fr=ge_ala)
#### 2. 项目开发
- 注意事项
  - BLE 设备通过蓝牙直连，可能存在断网使用场景（缓存必要数据或必须联网的能力需要进行提示），开发时需要考虑。
  - WiFi、BLE、Zigbee设备滑动过程中，灯光随调色板变化而变化，面板显示与灯光颜色一致。
  - WiFi 设备离线提示时间在 150s 左右，即设备离线后 150s 后才会发送事件给 APP 通知。

### 三、Beacon
#### 1. 什么是 Beacon
- 具体介绍查看 [Beacon 基础知识 wiki](https://en.wikipedia.org/wiki/Beacon) 或 [WiFi 基础知识 百科](https://baike.baidu.com/item/Beacon/2649124)
#### 2. 项目开发
- 注意事项
  - 由于 Beacon 协议的特殊性，控制指令延时比较严重， Beacon 设备下发 DP 之后，APP SDK 会直接把 DP 上报给面板。 如果设备再上报 DP， 在快速控制的时候，经常面板状态和设备状态不一致
  - 如果需要持久化，面板端进行云端保存然后同步
    - 保存数据：`import { saveDevProperty } from '@ray-js/ray';`
    - 获取数据：`import { getDevProperty } from '@ray-js/ray';`
  - Sig Mesh、Beacon 设备滑动过程中，灯不会跟随变化，需要松开滑块，面板与灯光颜色一致
  - 打开设备面板，APP 只会接收 30s 的数据，超过这个时间，APP 就不再接收了。如果需要修改该限制，可以定制面板， 所以在 Beacon 设备配网后，APP立即控制，设备端上报，面板能够正常显示，但过一段时间后设备端主动上报，面板不能正常显示

### 四、BLE Mesh
#### 1. 什么是 BLE Mesh
- 具体介绍查看 [BLE Mesh 基础知识 百科](https://baike.baidu.com/item/mesh/4418120?fr=aladdin)

#### 2. 项目开发
- 注意事项
  - 需要在开发过程中注意 DP 同步问题，不建议高频上报下发数据，可能引起数据风暴，导致丢包。
  - 需要主动查询非标准 DP ，DP Id > 50的一般都属于非标准 DP。
  - 群组暂不支持高级定时
  - 不支持的dp
    - control_data （实时下发数据，频率过高）
  - 面板需要根据 Sig Mesh 设备是否添加到网关下
    - [判断方法 useIsSigmeshGatewayConnected](https://developer.tuya.com/cn/miniapp/solution-panel/ability/common/hooks/useIsSigmeshGatewayConnected)
  - Sig Mesh、Beacon 设备滑动过程中，灯不会跟随变化，需要松开滑块，面板与灯光颜色一致。

### 五、Zigbee
#### 1. 什么是 Zigbee
- 具体介绍查看 [Zigbee 基础知识 百科](https://baike.baidu.com/item/zigbee?fromModule=lemma_search-box)
#### 2. 项目开发
- 注意事项
  - WiFi、BLE、Zigbee 设备滑动过程中，灯光随调色板变化而变化，面板显示与灯光颜色一致
  - WiFi 设备离线提示时间在150s左右，即设备离线后 150s 后才会发送事件给 APP 通知