スマートホームの SensorState トレイトのスキーマ

action.devices.traits.SensorState - この特徴は、定量的測定と質的状態の両方を対象としています。

デバイスの属性

この特性を持つデバイスは、SYNC オペレーションの一部として次の属性を報告する可能性があります。SYNC インテントの処理の詳細については、インテント フルフィルメントをご覧ください。

属性	タイプ	説明
sensorStatesSupported	配列	必須。 各オブジェクトは、このデバイスでサポートされているセンサー状態機能を表します。各センサーには、少なくとも説明的または数値的なケーパビリティが必要です。センサーも両方をレポートでき、その場合は数値が優先されます。
[item, ...]	オブジェクト	サポートされているセンサー機能。 少なくとも 1 つのアイテムが必要です。
name	文字列	必須。 サポートされているセンサータイプ。サポートされているセンサーの表をご覧ください。
descriptiveCapabilities	オブジェクト	センサーの機能の説明。
availableStates	配列	必須。 デバイスで使用可能な状態のリスト。センサーが値を返さない場合、「unknown」状態は暗黙的にサポートされます。
[item, ...]	文字列	サポートされている state 値。 少なくとも 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

デバイスのステータス

この特性を持つエンティティは、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	Integer	必須。 通知レベルを表します。現在サポートされている値は 0 で、これは通知が読み上げられることを示します。
name	文字列	必須。 センサーの状態名。通知でサポートされているセンサータイプのリストをご覧ください。
currentSensorState	文字列	必須。 現在の説明状態の値。通知でサポートされているセンサータイプのリストをご覧ください。

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

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

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

例

が煙を検出しました。

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

デバイスエラー

エラーと例外のリストをご覧ください。