智慧型住宅 SensorState 特徵結構定義

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

裝置錯誤

請參閱錯誤和例外狀況的完整清單。