歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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