智慧型住宅感應器狀態特徵

action.devices.traits.SensorState - 這種特徵同時涵蓋定量評估和定性狀態。

裝置屬性

具備這項特徵的裝置可能會回報下列資料： 在 SYNC 作業中使用屬性變更。學習 如要進一步瞭解如何處理 SYNC 意圖，請參閱 意圖執行要求。

屬性	類型	說明
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 意圖，請參閱 意圖執行要求。

州	類型	說明
currentSensorStateData	陣列	必要。 目前感應器狀態的清單。
[item, ...]	物件	目前的感應器狀態。
name	String	必要。 感應器狀態名稱。比對 sensorStatesSupported 的值。
currentSensorState	String	目前的描述性狀態值。比對 sensorStatesSupported 的值。
rawValue	Number	目前的數值感應器值。

請參閱「支援的感應器」一文，進一步瞭解 以及這個特徵支援的功能和感應器類型

範例

可回報說明狀態值的感應器裝置。

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

回報數字狀態值的感應器裝置。

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

可回報描述性和數字狀態值的感應器裝置。

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

裝置指令

無。

裝置通知

具備這種特徵的裝置可能會傳回下列項目 通知酬載，做為裝置狀態變更的一部分。學習 如要進一步瞭解如何實作通知，請參閱 智慧型住宅動作的通知。

欄位	類型	說明
SensorState	物件	必要。 通知酬載。
priority	整數	必要。 代表通知層級。目前支援的值為 0，表示系統應朗讀通知。
name	String	必要。 感應器狀態名稱。查看通知支援的感應器類型清單。
currentSensorState	String	必要。 目前的描述性狀態值。查看通知支援的感應器類型清單。

通知酬載可包含下列感應器類型：

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

請參閱「支援的感應器」一文，進一步瞭解 以及每種感應器類型支援的功能

範例

偵測煙霧。

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

裝置錯誤

查看完整清單 錯誤和例外狀況。