スマートホームの 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 整数

必須。

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

必須。

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

必須。

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

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

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

各種センサーについて詳しくは、サポートされているセンサーをご覧ください。 機能もサポートしています。

例

が煙を検出しました。

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

デバイスエラー

詳しくは、 エラーと例外をご覧ください。