スマートホームの 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 番号

現在の数値センサー値。

このトレイトがサポートするさまざまな機能やセンサータイプについて詳しくは、サポートされているセンサーをご覧ください。

例

記述状態の値を報告するセンサー デバイス。

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

数値の状態値を報告するセンサー デバイス。

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

状態値の説明と数値を報告するセンサー デバイス。

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

デバイスのコマンド

なし。

デバイスの通知

このトレイトを持つデバイスは、デバイスの状態の変化に伴って次の通知ペイロードを返すことがあります。通知の実装について詳しくは、スマートホーム アクションの通知をご覧ください。

フィールド タイプ 説明
SensorState 温度計

必須。

通知ペイロード:

priority Integer

必須。

通知レベルを表します。現在サポートされている値は 0 です。これは、通知を読み上げる必要があることを示します。
name String

必須。

センサーの状態名。通知でサポートされているセンサータイプのリストをご覧ください。
currentSensorState String

必須。

現在の説明状態の値。通知でサポートされているセンサータイプのリストをご覧ください。

通知ペイロードには、次のセンサータイプを含めることができます。

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

各センサータイプでサポートされている機能の詳細については、サポートされているセンサーをご覧ください。

例

煙を検出しました。

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

デバイスエラー

エラーと例外の全一覧をご覧ください。