--- title: 高级-灯光入睡 summary: 灯光渐暗助眠功能，在所设时间点开始渐暗直至关灯，含 sleep_mode DP 协议说明。 --- ## 高级-灯光入睡 ### 功能介绍 灯光助眠功能将在所设时间点开始，经过一段时间的渐暗变化，直至关灯，帮助人更好地入睡。 - 部分参数说明如下： - 渐暗变化时间：用于设置开始执行灯光助眠的时间点到完全关灯所需的时间，可根据实际使用需求自主设置。 - 重复周期：用于设置单次开启还是循环重复开启。选择周一到周日的任意时间，在对应时间该任务会重复执行。不选择任何时间，默认为单次开启，执行完一次后该任务自动关闭。 - 使用示例 - 设置时间 11:00 pm，选择周一至周五，渐暗变化时间设置为 30 分钟。在每周的周一至周五的 11:00 pm，灯光自动调整到低亮度低色温状态，并逐渐变暗，直至 11:30 pm 时完全关灯。 ### DP 协议 - Wi-FI 协议 DP: sleep_mode |序号| 名称| 字节数 |标识|数据类型| 字段属性| 字段说明| |---|---|---|---|---|---|---| |1| 版本号| 1 |version| 枚举 |初始版本：00 || |2| 任务节点数| 1| node| 枚举| 1 个节点：01 2个节点：02 3个节点：03 4个节点：04 | 0x01：1 个节点；0x02：2 个节点；0x03：3 个节点；0x04：4 个节点| |3| 任务开关| 1| on_off| 布尔值| 0：任务关闭 1：任务打开 |0x00：任务关闭；0x01：任务打开| |4| 日期设定| 1| date| 周数据| 反算| 如果全为 0，表示单次模式，只生效一次；否则为循环模式，判断相应位是否置 1，位置 1 表示当天生效。如 0x42 表示任务在星期六和星期一生效（注意必须保证相应的任务开关是处于开启状态）| |5| 渐变步进值| 1| step| 数值| 最大值：24 最小值：1 步距：1 倍数：0| 0x10：hex 码，5 分钟一个步进，16*5=90 分钟渐变时长。取值范围：1~24| |6| 起始小时| 1| hour| 数值| 最大值：23 最小值：0 步距：1 倍数：0| 0x10：hex 码，16 点。取值范围：0~23| |7| 起始分钟| 1 |minute| 数值| 最大值：59 最小值：0 步距：1 倍数：0| 0x10：hex 码，16 分。取值范围：0~59| |8| 色调（百位）| 1 |H_hundreds| 数值| 最大值：3 最小值：0 步距：1 倍数：0 |0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360| |9| 色调（十位个位）| 1 |H_tens_ones| 数值 |最大值：99 最小值：0 步距：1 倍数：0 |0x03, 0x10：hex 码。大端格式，第一个字节表示百位，第二个字节表示十位，个位。实际值表示 316，取值范围：0~360| |10| 饱和度百分比| 1 |S| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |11| 明度百分比| 1 |V| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |12| 亮度百分比| 1| B| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |13| 色温百分比| 1| T| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |14| 维持时间|1 |time_duration| 数值 | 最大值：24 最小值：0 步距：1 倍数：0| 0x10：hex 码，5 分钟一个步进。渐变完成后再持续该时间后关灯。取值范围： 0~24, 0 表示不关灯，24 表示 120 分钟后关灯| - Ble Mesh 协议 DP： sleep_mode |序号| 名称| 字节数 |标识| 数据类型| 字段属性 |字段说明| |----|----|----|----|----|----|----| |1| 版本号| 1| version |枚举 |初始版本：00 || |2 |参数模式 |1| data_mode| 枚举| 灯光参数进含亮度色温：01 灯光参数仅含彩光HSV：02 灯光参数包含亮度色温和彩光：03 | 0x01:仅含白光亮度色温；0x02:仅含彩光HSV；0x03:含白光亮度色温和彩光| |3| 任务节点数| 1 |node |枚举 |1个节点：01 2个节点：02 3个节点：03 4个节点：04 |0x01：1 个节点；0x02：2 个节点；0x03：3 个节点；0x04：4 个节点| |4| 任务开关| 1| on_off |布尔值 |0：任务关闭 1：任务打开| 0x00：任务关闭；0x01：任务打开| |5 |日期设定| 1| date| 周数据| 反算| 如果全为 0，表示单次模式，只生效一次；否则为循环模式，判断相应位是否置 1，位置 1 表示当天生效。如 0x42 表示任务在星期六和星期一生效（注意必须保证相应的任务开关是处于开启状态）| |6| 渐变步进值| 1 |step| 数值| 最大值：24 最小值：1 步距：1倍数：0 |0x10：hex 码，5 分钟一个步进，16*5=90 分钟渐变时长。取值范围：1~24| |7| 起始小时| 1 |hour| 数值| 最大值：23 最小值：0 步距：1 倍数：0 |0x10：hex 码，16 点。取值范围：0~23| |8| 起始分钟| 1| minute| 数值| 最大值：59 最小值：0 步距：1 倍数：0| 0x10：hex 码，16 分。取值范围：0~59| |9| 亮度百分比| 1| B| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| |10| 色温百分比| 1| T| 数值| 最大值：100 最小值：0 步距：1 倍数：0| 0x10：hex 码，16%；取值范围：0~100| ### 如何开发 - 根据 UI 交互进行 DP 的监听上报与下发 - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听) ### 注意事项 暂无 ### 相关物料 - 【功能页】：无 - 【组件】：无 - 【教程】：无 - 【SDK】：无 - 【API】：无