---
title: 高级-随机定时
summary: 灯光看家功能，在设定时间段内随机开关灯模拟有人在家场景，含 random_timing DP 协议。
---

## 高级-随机定时

### 功能介绍
灯光看家功能将在所设时间段期间，通过随机开、关灯模拟有人在家的场景，起到防盗的作用。
- 部分参数说明如下：
  - 重复周期：用于设置单次开启还是循环重复开启。选择周一到周日的任意时间，在对应时间该任务会重复执行；不选择任何时间，默认为单次开启，执行完一次后该任务自动关闭
  - 自定义颜色：用于自定义设置执行灯光看家功能期间灯光亮起时的灯光状态
- 使用示例：
  - 设置任务时间为 6:00 pm～12:00 am，选择休息日周六、周日，开启灯光看家后，灯光将自动在周六和周日的6:00 pm～12:00 am 期间自动随机执行开、关灯动作，模拟有人在家的场景。
### DP 协议
- DP： random_timing

|序号|	名称|	字节数|	标识	|数据类型|	字段属性|	字段说明|
|---|---|---|---|---|---|---|
|1|	协议版本|	1|	version|	枚举|	初始版本：00	|协议版本|
|2|	节点长度|	1|	length|	数值|	最大值：255 最小值：0 步距：1 倍数：0	|节点长度|
|3|	任务开关|		on_off|	枚举|	任务关闭：02 任务开启：03	||
|4|	星期|	1|	week|	周数据|	反算|	如果全为 0，表示单次模式，只生效一次；否则为循环模式，判断相应位是否置 1，位置 1 表示当天生效。如 0x42 表示任务在星期六和星期一生效（注意必须保证相应的任务开关是处于开启状态）|
|5|	起始时间|	2	|start_time|	数值|	最大值：1439 最小值：0 步距：1 倍数：0|	x10：hex 码，16%；取值范围：0~1439|
|6|	结束时间|	2	|end_time	|数值	|最大值：1439 最小值：0 步距：1 倍数：0|	x10：hex 码，16%；取值范围 0-1439|
|7|	色调（百位）|	1|	H_hundreds|	数值|	最大值：3 最小值：0 步距：1 倍数：0	|0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360|
|8|	色调（十位个位）|	1	H_tens_ones|	数值|	最大值：99 最小值：0 步距：1 倍数：0|	0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0-360|
|9|	饱和度百分比|	1|	S	|数值	|最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0-100|
|10|	明度百分比|	1|	V|	数值|	最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0-100|
|11	|亮度百分比	|1|	B|	数值|	最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0-100|
|12	|色温百分比	|1|	T|	数值|	最大值：100 最小值：0 步距：1 倍数：0|	0x10：hex 码，16%；取值范围：0-100|

### 如何开发
- 根据 UI 交互进行 DP 的监听上报与下发
  - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听)

### 注意事项

暂无

### 相关物料
- 【功能页】：无
- 【组件】：无
- 【教程】：无
- 【SDK】：无
- 【API】：无