涂鸦公版面板配置指南

注意： APP控制面板扫码预览功能目前仅支持中国区APP账号使用
蓝牙与zigbee的产品对虚拟设备支持不佳，故扫码预览面板时可能会出现问题，最终面板效果以真实设备显示为准

一、SOC产品面板配置——以WiFi四路排插为例

常见品类：电工、照明
SOC免开发方案的产品，无法更改功能点，只能更改面板外观与面板文案

产品功能需求

包含2个国标插座与2个USB插座的四路排插

配置效果展示

配置步骤

1、设置面板样式

该部分可修改面板的图案样式，平台提供固定样式模板和自定义模板

a）选择自定义面板（只有左上角标注了自定义的面板才支持自定义修改）

b）使用选中模板后，进入模板编辑界面

c）编辑面板背景

此模块可选择APP面板的背景样式，奠定面板基调

面板背景可选择纯色背景或图片背景。编辑完成后可扫描页面右侧二维码预览效果。

Ⅰ）纯色背景

可选择预设颜色，也可填写十六进制的RGB颜色代码进行自定义。填写完成后点击保存。

Ⅱ）图片背景

可选择预设图片，也可上传自定义背景图。

注意：图片尺寸要求：750px*1334px，图片格式要求：png、jpeg、jpg。

填写完成后点击保存。

修改完成后的面板如图

d）编辑面板主题色

此模块可选择面板呈现的主题颜色，在四路排插面板中呈现为总开关的背景颜色

面板主题色可选择预设颜色或十六进制RGB颜色代码。编辑完成后请点击保存，并可扫描页面右侧二维码预览效果。

修改完成后的面板如图

e）编辑字体颜色

此模块可选择面板呈现的字体颜色。在四路排插面板中还能改变按钮图标的前景色

字体颜色可选择预设颜色或十六进制RGB颜色代码。点击绿色方框中的色块可出现调色盘进行更多颜色的选择。

编辑完成后请点击保存，并可扫描页面右侧二维码预览效果。

修改完成后的面板如图

f）编辑图标样式

此模块可选择面板呈现的图标样式，也可上传自定义的图标样式。在四路排插面板中可选择插座规格样式

注意：自定义图标尺寸要求：336px*336px，图标格式要求：png。

编辑完成后请点击保存，并可扫描页面右侧二维码预览效果。

修改完成后的面板如图

2、设置面板文案（若修改未生效请清理APP缓存或重新扫码）

在多语言管理选项中可编辑面板的文案描述

a）进入多语言管理

b）在产品界面可编辑DP点对应的字段文案

根据面板图标设置，做出如下修改:

修改前	修改后
开关3	USB开关1
开关4	USB开关2
开关3倒计时	USB开关1倒计时
开关4倒计时	USB开关2倒计时

修改完成并保存后，APP面板如图：

c）在APP信息界面可编辑面板上除DP点外的字段文案

本次我们对其做出如下修改

修改前	修改后
取消	我再想想
修改名称	取个小名

面板效果如图：

二、MCU产品面板配置——以WiFi空气净化器为例

常见品类：小家电、厨房电器、传感
MCU产品由于可编辑DP点，故可在部分支持自定义的公版面板上增删产品功能
DP点类型定义指南请参考：https://docs.tuya.com/cn/product/function.html
注意：
由于涂鸦公版的面板是与默认的标准DP点一一对应的，故某些必选标准DP点的缺失可能会导致面板无法加载；某些标准DP点的缺失可会导致面板功能不全
部分设备标准功能及自定义功能点累计添加总数超过25个可能会影响设备稳定性，请谨慎操作。最多可添加40个功能点（不包括云功能）

产品功能需求

1、面板上展示室内温湿度、TVOC和甲醛浓度

2、面板上增加一个摆叶开关

3、室内PM2.5数值字体颜色根据数值进行改变（0-50为绿色;50-100为黄色;100以上为红色）

4、室外天气展示天气图标而不是单纯的文案

5、取消室内PM2.5曲线展示

配置效果展示

配置步骤

1、设置DP点

a）根据产品需求勾选下图标准DP点：

b）确定后DP点详情展示如下：

c）根据产品需求自定义添加下图DP点

d）选择一款公版空净模板

e）此时的面板样式如下：

2、设置多语言文案（若修改未生效请清理APP缓存或重新扫码）

a）补充多语言文案如下：

序号	功能点	属性值	语言包Key值	简体中文	英语
14	TVOC	-	dp_tvoc	TVOC	TVOC
	tvoc	unit	dp_tvoc_unit
101	甲醛	-	dp_ch2o	甲醛	CH2O
	ch2o	unit	dp_ch2o_unit
102	摆叶	-	dp_pendulum	摆叶	Pendulum
	pendulum	on	dp_pendulum_on	开	On
		off	dp_pendulum_off	关	Off

b）保存后面板样式如下：

3、通过工单提交面板更改需求

PM2.5数值字体颜色、天气图标、室内PM2.5曲线需要涂鸦工作人员通过配置后台代码实现，因此有上述修改需求请提交工单申请更改

a）工单提交入口：

b）更改完成后面板样式如下：

注意事项

1、自定义功能不可选择字符型或raw型，否则将可能导致公版空净面板崩溃

2、自定义功能中可上报类型DP将展示在主界面上，可上报可下发类型DP将展示在设置界面上。

3、故障型DP不展示。

三、自由配置面板配置——以WiFi多功能传感器为例

自由配置面板拥有最大的自由程度，优点是界面功能模块完全与创建的DP点一致，缺点是面板完全模块化，美观度不足
自由配置面板不能显示raw型与故障型DP
自由配置面板常用于项目的调试阶段，作为临时面板使用

产品功能需求

1、支持布防、撤防、离家三种模式选择，其中布防模式为检测且告警；撤防模式为不检测且不告警；离家模式为检测且不告警。

2、支持声音报警、光亮报警、声光报警三种报警方式选择。

3、集成VOC、PM2.5、甲醛三种数据的检测及告警。

4、智能场景支持定时功能。

配置效果展示

配置步骤

1、设置DP点

a）根据产品需求勾选下图标准DP点：

b）确定后DP点详情展示如下：

c）根据产品需求自定义添加下图DP点

注意：由于自由配置面板仅显示DP点内容，云定时功能将不会显示在自由配置面板上，但开启后将支持在APP的场景与自动化中设置定时。

d）设置完DP点后选择自由配置面板，此时的面板样式如下：

2、设置多语言文案（若修改未生效请清理APP缓存或重新扫码）

在多语言管理选项中可编辑DP点的文案描述。由于自由配置面板全部由DP点构成功能模块，因此该部分的文案将如数显示在面板上，利用好多语言文案设置可为面板锦上添花
注意：若某个字段未填写文案，将默认显示功能点名称或语言包Key值

a）下表是产品界面初始的文案

序号	功能点	属性值	语言包Key值	简体中文	英语
31	VOC检测值	-	dp_voc_value	VOC检测值	VOC Value
	voc_value	unit	dp_voc_value_unit
33	PM2.5检测值	-	dp_pm25_value	PM2.5检测值	PM2.5 Value
	pm25_value	unit	dp_pm25_value_unit
39	甲醛检测值	-	dp_ch2o_value	甲醛检测值	CH2O Value
	ch2o_value	unit	dp_ch2o_value_unit
40	布防模式	-	dp_mode_arm
	mode_arm	armed_staying	dp_mode_arm_armed_staying
		disarmed	dp_mode_arm_disarmed
		armed_leaving	dp_mode_arm_armed_leaving
101	VOC告警	-	dp_bt_voc
	bt_voc	on	dp_bt_voc_on
		off	dp_bt_voc_off
102	PM2.5告警	-	dp_bt_pm25
	bt_pm25	on	dp_bt_pm25_on
		off	dp_bt_pm25_off
103	甲醛告警	-	dp_bt_coho
	bt_coho	on	dp_bt_coho_on
		off	dp_bt_coho_off
104	报警方式	-	dp_alarm
	alarm	A1	dp_alarm_a1
		A2	dp_alarm_a2
		A3	dp_alarm_a3
		A4	dp_alarm_a4

b）补充多语言文案如下：

序号	功能点	属性值	语言包Key值	简体中文	英语
31	VOC检测值	-	dp_voc_value	VOC检测值	VOC Value
	voc_value	unit	dp_voc_value_unit	mg/m3	ppm
33	PM2.5检测值	-	dp_pm25_value	PM2.5检测值	PM2.5 Value
	pm25_value	unit	dp_pm25_value_unit	μg/m³	μg/m³
39	甲醛检测值	-	dp_ch2o_value	甲醛检测值	CH2O Value
	ch2o_value	unit	dp_ch2o_value_unit	ppm	ppm
40	布防模式	-	dp_mode_arm	模式	Model
	mode_arm	armed_staying	dp_mode_arm_armed_staying	布防	Armed
		disarmed	dp_mode_arm_disarmed	撤防	Disarmed
		armed_leaving	dp_mode_arm_armed_leaving	离家	leaving
101	VOC告警	-	dp_bt_voc	VOC告警	VOC alarm
	bt_voc	on	dp_bt_voc_on	开	On
		off	dp_bt_voc_off	关	Off
102	PM2.5告警	-	dp_bt_pm25	PM2.5告警	PM2.5 alarm
	bt_pm25	on	dp_bt_pm25_on	开	On
		off	dp_bt_pm25_off	关	Off
103	甲醛告警	-	dp_bt_coho	甲醛告警	COHO alarm
	bt_coho	on	dp_bt_coho_on	开	On
		off	dp_bt_coho_off	关	Off
104	报警方式	-	dp_alarm
	alarm	A1	dp_alarm_a1	声音报警	Sound
		A2	dp_alarm_a2	光亮报警	Light
		A3	dp_alarm_a3	声光报警	Sound&Light
		A4	dp_alarm_a4	报警解除	Disarm