智慧型住宅 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"
  }
}

裝置 ERRORS

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