智能家居 SensorState Trait 架构

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"
  }
}

设备错误

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