--- title: 特色-灯带涂抹 summary: 灯带自定义上色能力，支持白光、彩光、色卡、组合模式，含 paint_colour_data DP 协议。 --- ## 特色-灯带涂抹 ### 功能介绍 - 灯带涂抹能力主要用于灯带品类，允许用户自定义的去给灯带进行上色，丰富灯带的可玩性。 - 涂鸦彩光 DP 色值采用 [HSV 颜色模型](https://baike.baidu.com/item/HSV%E9%A2%9C%E8%89%B2%E6%A8%A1%E5%9E%8B/21501482)，通过面板下发 HSV 模型颜色对应的字符串值。 1. 色调（H） 色调调节范围：0-360，面板下发的值的范围0-360，色环调节范围和面板下发的值为线性对应关系。 2. 饱和度（S） 饱和度调节范围：0%-100%，面板下发的值的范围0-1000，色环调节范围和面板下发的值为线性对应关系。 3. 明度（V） 明度调节范围：1%-100%，面板下发的值的范围10-1000，色环调节范围和面板下发的值为线性对应关系。 - 彩光支持展示： 1. [三路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base) 2. [四路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base) 3. [五路](/cn/miniapp/solution-ai/ability/lamp-solution/lamp/quick-start/base) ### DP 协议 --- | DP code | DP 含义 | DP 类型 | 备注 | | ----------------- | ----------- | -------------------------------- | ---- | | paint_colour_data | 彩光涂抹 DP | { "type": "raw", "maxlen": 255 } | | --- - paint_colour_data DP 详情 | 版本号 | 调节模式 | 调节效果 | 段数 | 数据 | | ------ | ------------------------------------------------------- | ------------------------------------------------------------------ | -------- | ------ | | 1byte | 1byte | 1byte | 1byte | 见下表 | | 0x00 | 0x00:白光模式 0x01:彩光模式 0x02:色卡模式 0x03:组合模式 | 0x00：无效果 0x01：段段之间有过渡 0x02：闪烁 0x03：呼吸 0x04：闪耀 | 灯带段数 | 见下表 | - 白光模式： | 调节动作 | B亮度 | T色温 | | ------------ | ------ | ------ | | 1byte | 2byte | 2byte | | 0x00：油漆桶 | 0-1000 | 0-1000 | - 彩光、色卡模式： | 调节动作 | HSV | 段选 | 数据1 | 数据2 | 数据x... | | ------------------------------------------------- | -------------------- | ----------------------------------------------------------------------------- | ----------------------------- | ----------------------------- | -------- | | 1byte | 6byte | 1byte | 1byte | 1byte | ... | | 0x00：油漆桶 0X01：铅笔（点选）0X02：橡皮擦（擦除 | 彩光HSV色值（2+2+2） | 7bit：(0：连续；1：不连续)0bit-6bit：(连续时，无意义；不连续时，代表段的总数) | 连续：起始编号 不连续：段编号 | 连续：结束编号 不连续：段编号 | ... | - 组合模式 | 组合模式（预留） | 颜色1 | 颜色2 | ... | | ---------------- | -------------------- | -------------------- | --- | | 1byte | 6byte | 6byte | ... | | 0x00：均匀 | 彩光HSV色值（2+2+2） | 彩光HSV色值（2+2+2） | ... | ### 如何开发 - [灯带组件实现参考](https://developer.tuya.com/material/library_oHEKLjj0/component?code=LampStripLightSmear) - 安装后在 `node_module/@ray-js/lamp-strip-light-smear/src/README.md` 中描述了具体实现的逻辑 - 根据 UI 交互进行 DP 的监听上报与下发 - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听) ### 注意事项 - 涂抹灯带的ui实现: 1. 小程序中可以使用 Canvas/SVG + 碰撞💥检测来实现。 2. 在 RN 中则是使用对应的图片然后动态修改颜色以及其渐变色实现。 - 灯带状态与设备状态同步问题 1. 因为 DP 点只保存最近一次涂抹的数据，白光与彩光的数据需要放在云端存储（推荐分开存储），来同步面板与设备的状态 2. 按键或遥控器操作灯具时，监听 DP 状态同步 ### 相关物料 - 【功能页】：无 - 【组件】： 1. [灯带组件](https://developer.tuya.com/material/library_oHEKLjj0/component?code=LampStripLightSmear) - 【教程】： 1. [灯带模板教程](https://developer.tuya.com/cn/miniapp-codelabs/codelabs/panel-lamp-strip/index.html#0) - 【SDK】：无 - 【API】：无