Smart Home SensorState 特性結構定義

action.devices.traits.SensorState - 此屬性涵蓋量化測量和定性狀態。

裝置屬性

具有此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求一文。

屬性	類型	說明
sensorStatesSupported	陣列	必填。 每個物件都代表這個裝置支援的感應器狀態功能。每個感應器都必須具有描述性或數值能力。感應器也可以回報這兩種情況，此時系統會優先採用數值。
[item, ...]	物件	支援的感應器功能。 至少要有 1 個項目。
name	字串	必填。 支援的感應器類型。請參閱「支援的感應器」表格。
descriptiveCapabilities	物件	感應器功能的說明。
availableStates	陣列	必填。 裝置的可用狀態清單。當感應器未傳回值時，默示支援「未知」狀態。
[item, ...]	字串	支援描述性狀態值。 至少要有 1 個項目。
numericCapabilities	物件	說明感應器可回報的數值。
rawValueUnit	字串	必填。 支援的數值單位。

請參閱支援的感應器，進一步瞭解這些特性支援的不同功能和感應器類型。

範例

回報描述性狀態值的感應器裝置。

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

裝置狀態：STATE

具有此特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱意圖執行要求一文。

州	類型	說明
currentSensorStateData	陣列	必填。 目前的感應器狀態清單。
[item, ...]	物件	目前的感應器狀態。
name	字串	必填。 感應器狀態名稱。比對 sensorStatesSupported 中的值。
currentSensorState	字串	目前的描述性狀態值。比對 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	字串	必填。 感應器狀態名稱。查看通知支援的感應器類型清單。
currentSensorState	字串	必填。 目前的描述性狀態值。查看通知支援的感應器類型清單。

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

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

如要進一步瞭解各感應器類型支援的不同功能，請參閱支援的感應器。

範例

偵測到煙霧。

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

裝置錯誤：ERRORS

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