智能家居 SensorState 特征架构

action.devices.traits.SensorState - 此特征同时涵盖定量衡量和定性状态。

设备属性

具有此特征的设备可能会在 SYNC 操作过程中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性	类型	说明
sensorStatesSupported	数组	必填。 每个对象都代表此特定设备支持的传感器状态功能。每个传感器必须至少具有描述性或数字功能。传感器也可以报告这两者，在这种情况下，系统会优先使用数值。
[item, ...]	对象	支持的传感器功能。 至少需要 1 项。
name	String	必填。 支持的传感器类型。请参阅“支持的传感器”表。
descriptiveCapabilities	对象	传感器功能的说明。
availableStates	数组	必填。 设备的可用状态列表。当传感器未返回值时，系统隐式支持“未知”状态。
[item, ...]	String	支持的描述性状态值。 至少需要 1 项。
numericCapabilities	对象	说明传感器可以报告的可能数值。
rawValueUnit	String	必填。 支持的数字单位。

如需详细了解此特征支持的不同功能和传感器类型，请参阅支持的传感器。

示例

报告描述性状态值的传感器设备。

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

报告数字状态值的传感器设备。

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

报告描述性和数字状态值的传感器设备。

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

支持的传感器

下表列出了支持的传感器类型及其相关功能。

空气质量

名称	描述性功能	数值功能
支持的值： AirQuality	支持的值： healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	支持的值： AQI

一氧化碳

名称	描述性功能	数值功能
支持的值： CarbonMonoxideLevel	支持的值： carbon monoxide detected high no carbon monoxide detected unknown	支持的值： PARTS_PER_MILLION

烟雾水平

名称	描述性功能	数值功能
支持的值： SmokeLevel	支持的值： smoke detected high no smoke detected unknown	支持的值： PARTS_PER_MILLION

过滤器清洁度

名称	描述性功能	数值功能
支持的值： FilterCleanliness	支持的值： clean dirty needs replacement unknown	不受支持。

漏水

名称	描述性功能	数值功能
支持的值： WaterLeak	支持的值： leak no leak unknown	不受支持。

雨水检测

名称	描述性功能	数值功能
支持的值： RainDetection	支持的值： rain detected no rain detected unknown	不受支持。

过滤器寿命

名称	描述性功能	数值功能
支持的值： FilterLifeTime	支持的值： new good replace soon replace now unknown	支持的值： PERCENTAGE

计算出的过滤器生命周期

名称	描述性功能	数值功能
支持的值： PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	不受支持。	支持的值： PERCENTAGE

二氧化碳水平

名称	描述性功能	数值功能
支持的值： CarbonDioxideLevel	不受支持。	支持的值： PARTS_PER_MILLION

颗粒物

名称	描述性功能	数值功能
支持的值： PM2.5 PM10	不受支持。	支持的值： MICROGRAMS_PER_CUBIC_METER

挥发性有机化合物

名称	描述性功能	数值功能
支持的值： VolatileOrganicCompounds	不受支持。	支持的值： PARTS_PER_MILLION

设备状态

具有此特征的实体可能会在 QUERY 操作过程中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅 intent 执行方式。

州	类型	说明
currentSensorStateData	数组	必填。 当前传感器状态列表。
[item, ...]	对象	当前的传感器状态。
name	String	必填。 传感器状态名称。匹配 sensorStatesSupported 中的值。
currentSensorState	String	当前的描述性状态值。匹配 sensorStatesSupported 中的值。
rawValue	编号	传感器的当前数值。

如需详细了解此特征支持的不同功能和传感器类型，请参阅支持的传感器。

示例

报告描述性状态值的传感器设备。

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

报告数字状态值的传感器设备。

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

报告描述性和数字状态值的传感器设备。

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

设备命令

无。

设备通知

具有此特征的设备可能会在设备状态发生变化时返回以下通知载荷。如需详细了解如何实现通知，请参阅智能家居 Action 的通知。

字段	类型	说明
SensorState	对象	必填。 通知负载。
priority	整数	必填。 表示通知级别。目前支持的值为 0，表示应大声读出通知。
name	String	必填。 传感器状态名称。请参阅通知支持的传感器类型列表。
currentSensorState	String	必填。 当前的描述性状态值。请参阅通知支持的传感器类型列表。

通知载荷可以包含以下传感器类型：

• AirQuality
• CarbonMonoxideLevel
• SmokeLevel
• FilterCleanliness
• WaterLeak
• RainDetection
• FilterLifeTime

如需详细了解每种传感器类型支持的不同功能，请参阅支持的传感器。

示例

检测到烟雾。

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

设备出错

查看错误和异常的完整列表。