文档

开关

更新时间:
一键部署

开关组件可用于展示和控制设备的某个属性(例如设备的电源开关)状态,或展示接口返回的数据值状态。本文介绍开关组件的详细配置方法。

步骤一:添加组件

  1. 创建移动应用。具体操作,请参见创建移动应用

  2. 在移动应用编辑器中,单击最左侧的组件图标组件

  3. (可选)添加分栏组件,进行应用页面布局设置。具体操作,请参见横向分栏和纵向分栏

  4. 在画布左侧组件列表上方,在搜索框中输入开关,找到该组件,然后将组件拖拽到中间画布。

    有关添加组件的更多信息,请参见添加组件

    开关

步骤二:配置数据源

  1. 在移动应用编辑器右侧样式中,单击开关数据后的配置数据源

  2. 在数据源配置页面,选择数据源类型,完成配置。

    可选数据源类型有设备接口静态数据应用推送

    说明

    数据源支持返回的数据类型:

    • 设备:布尔型(bool)和整数型(int)。

    • 接口:布尔型(bool)和数值型(单精度数字、双精度数字和整数)

    映射关系配置如下:

    • 布尔型:true对应开(On),false对应关(Off)。

    • 整数型:将设备返回的整数型数据转换为布尔型,需设置转换为True和False的整数值。

    • 数值型:使用数据过滤脚本将接口返回的数值型数据转换为布尔型。

  3. 单击确定

    组件状态将基于关联的数据源实时更新。

步骤三:配置样式

  1. 在移动应用编辑器右侧样式中,配置组件展示的样式。

    配置项

    说明

    开关样式

    设置组件的样式类型。可选:

    • 默认:显示效果为组件当前默认样式。

    • 图片:自定义图片对应开关状态。

    ON状态

    为开关的ON和OFF状态设置显示颜色(默认)或图片。

    颜色或图片支持配置动态数据源:

    • 颜色支持配置的数据源类型有接口应用推送

    • 图片支持配置的数据源与图片组件相同,具体信息,请参见图片

    OFF状态

    开关响应模式

    仅组件数据源为设备时,该配置生效。手动修改开关状态,会下发指令给设备更新对应设备属性值。

    您可设置组件开关状态的更新模式:

    • 等待数据返回:等到设备更新并上报属性值成功后,更新组件开关状态。

    • 操作即时响应:手动更新组件状态后,立即更新组件开关状态。

      您需设置数据上报延时(ms),如果超出该时间范围设备没有上报更新的数据,组件开关状态会恢复为修改前的状态,开关状态更新失败。

  2. 调整组件宽高和在页面中的布局位置。具体操作,请参见通用样式

步骤四:配置交互动作

  1. 在移动应用编辑器右侧交互中,单击新增交互,设置事件动作

    该组件支持事件值改变单击双击。例如,组件值改变,执行动作设置设备属性,下发指令给某设备,修改该设备的某个属性值。

    具体操作,请参见交互配置

  2. 预览和调试组件展示的数据和效果。具体操作,请参见预览与调试

  • 本页导读 (1)
文档反馈