App 设备卡片

约 2545 字大约 8 分钟

App 设备卡片

什么是 App 设备卡片？

ThingsCloud 提供了开箱即用的用户应用通用版 ThingsX。用户登录 ThingsX 后，首先会看到设备列表，这里展示了与用户关联的一个或多个设备，每个设备显示的方形区域，称为 设备卡片。

每个设备类型都有自己独立的设备卡片，您可以为设备类型编辑设备卡片的内容和样式，对设备类型下的所有设备生效。

因此，用户在 ThingsX 中看到的每个设备卡片，是由设备所属设备类型决定的，通过编辑设备类型的设备面板，就可以为用户展示各种不同的设备面板。

如何编辑设备卡片？

设备面板是可编辑的，您可以在控制台中，进入任意设备类型的详情页面，在应用配置中可以看到设备面板编辑器的入口，如下图：

进入设备面板编辑器，在编辑器的中央区域，可以看到左侧有一个 App 设备列表的模拟页面，点击当前设备类型的设备卡片，可进入编辑状态。如下图：

您可以在线编辑设备卡片的内容和样式，选择设备进行效果预览，完成编辑后点击保存，保存后的设备卡片在 ThingsX 上立即生效。

设备卡片中可以编辑的区域包括：

预览面板
状态栏

预览面板

预览面板位于设备卡片的中央区域，可以快捷展示设备的多个属性状态，帮助用户快速获取设备的重要运行状态，无需进行多次跳转和费时的查找操作，大大提升了用户体验和信息获取速度，使得用户的设备管理流程更加流畅和高效。

可以关联哪些属性？

首先为预览面板选择要关联的一个或多个设备属性，这些属性需要事先在设备类型的功能定义中添加。预览看板可关联的属性数据类型包括：

数值类型：比如设备的实时功率数值、电量消耗数值等，能精准反映设备的运行量化指标。
开关量类型：像设备的紧急制动开关状态、灯光照明开关状态等，可直观呈现设备的二元状态信息。
文本类型：诸如设备的编号、ICCID、生产批次文本等，有助于深入了解设备的相关背景信息。
枚举类型：例如设备的不同工作模式枚举（如高速、中速、低速模式）、不同故障类型枚举等，方便用户快速知晓设备的特定运行模式或故障类别。

您可以将设备的一些关键属性集中展示在这里，例如：设备的温度数值、运行状态、设备编号以及工作模式等。

如何设置不同的布局？

预览面板采用网格作为属性呈现的基本布局，您可以根据关联属性的数量和展示需求，自定义属性列数。这里还支持分别设置宽卡片和窄卡片模式下的属性列数。

对于一些内容较长的文本属性，还可以单独设置占用多列，以便获得更大的展示空间。

您还可以通过编辑布局样式和对齐方式，对设备预览面板进行多种样式的尝试。

如何单独设置每个属性的样式？

在完成属性关联后，您可以在右侧的设置栏中，分别展开每个属性，进行样式设置。

针对数值类型的属性，您可以设置显示名称、文字颜色、背景色等，除此之外，您还可以为数值设置不同区间范围的颜色，便于用户直观的了解设备的状态级别。

针对开关量属性，您可以使用信号灯或图标的呈现方式，并且可以设置不同状态下的颜色和图标，以及图标动画效果。

状态栏

状态栏位于设备卡片的底部，如下图：

状态栏可以显示设备的以下状态

在线状态文字
在线状态图标
信号强度图标
电池电量图标
告警状态图标
最近活跃时间

下面介绍这些状态的设置方法，根据实际需要可能会用到一些属性定义，在这里事先定义以下属性：

在线状态文字

可以直接设置是否显示在线状态文字，以及设备在线时的文字颜色。当设备离线时，文字显示为灰色。

在线状态图标

可以设置是否显示在线图标，并选择要显示的图标，如下图：

在图标列表中选择在线图标，如下图：

在图标列表中，每个图标的底部显示了图标名称。当我们希望由设备或用户动态改变在线图标时，可以使用在线图标属性，关联一个文字类型的设备属性，将属性值改为希望显示的图标名称。如下图：

例如：某设备支持自动切换 WiFi 或 4G 上网，当设备上线时，向平台上报以下属性，即可改变在线图标。

{
    "conn_type": "wifi-1"
}

此外，还可以设置在线状态图标在设备在线时的颜色。当设备离线时，图标为灰色。

信号强度图标

可以设置是否显示设备连接网络的信号强度图标，选择要显示的图标系列，并设置关联的信号强度属性，该属性的数据类型需设置为数值类型，取值范围是 0 到 100 的整数。

平台提供了常用的信号强度图标系列，可以直接选择，如下图：

每组图标系列包含了 4 个图标，根据设备的信号强度属性数值，来自动显示对应的图标，对应关系为：

图标 1 的信号强度范围：0-24
图标 2 的信号强度范围：25-49
图标 3 的信号强度范围：50-75
图标 4 的信号强度范围：75-100

例如：设备每 5 分钟上报一次当前的信号强度，如下：

{
    "signal": 80
}

提示

通常，设备从通信模组读取的信号强度并不是从 0 到 100 个数值，而是根据不同模组类型，有多种信号强度指标，例如：

RSSI 全称 Received Signal Strength Indicator，中文名是接收信号强度指示，是最常用的表示 WiFi 信号强度的名称。它反映了无线设备接收到的来自接入点（AP）或其他无线设备的信号功率大小。WiFi 信号强度的 RSSI 值范围大致在 - 100dBm 至 - 20dBm 之间。

-20dBm 至 - 30dBm：表示信号非常强。
-30dBm 至 - 60dBm：属于较好的信号强度。
-60dBm 至 - 80dBm：信号强度一般。
低于 - 80dBm：信号很弱。

CSQ 全称 Cell Signal Quality，中文名是小区信号质量，它是蜂窝网络中用来衡量手机或其他移动设备与基站之间信号质量的一个指标。CSQ 综合考虑了信号强度、信号干扰、误码率等多种因素，不仅仅反映信号的强弱，还能在一定程度上体现信号的纯净度和稳定性等整体质量情况。

一般来说，CSQ 的取值范围是 0 - 31，另外还有特殊值 99。

0：表示信号质量极差。
1 - 7：代表信号质量很差，网络连接可能极不稳定。
8 - 15：说明信号质量一般，能够进行基本的通信。
16 - 23：表示信号质量较好，设备可以较为稳定地与基站进行通信。
24 - 31：意味着信号质量非常好，设备与基站之间的连接稳定。
99：通常表示设备无法正确获取信号质量信息，可能是设备故障、网络异常或者处于特殊的测试模式等原因导致。

因此，您可以在 ThingsCloud 的消息规则中，使用属性上报预处理规则，将原始的信号强度转换为 0 到 100 个数值即可。

此外，您还可以开启使用信号图标属性，关联到一个数据类型是文本的设备属性，来动态改变状态栏上的信号强度图标，用于支持多种网络连接方式的设备。如下图：

信号图标属性的值，在图标系列的名称中选择，例如 signal-4，设备可以属性上报中通知平台，例如：

{
    "signal_type": "signal-4",
    "signal": 76
}

电池电量图标

可以设置是否显示电池电量图标，并设置关联的以下属性：

电池电量属性：数据类型为数值，取值范围 0 到 100。
电池充电属性：数据类型为开关量，表示是否显示为正在充电的样式。

此外，还可以设置是否在电池图标右侧显示电量百分比数值。

电池电量图标会根据电量数值，自动使用以下颜色：

绿色：电量为 50 - 100。
黄色：电量为 20 - 49。
红色：电量为 0 - 19。

告警状态图标

设置是否显示设备的当前告警状态。

设备告警状态的相关规则，请浏览告警规则。