スマートホームの 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" ] } } ] }
サポートされているセンサー
次の表に、サポートされているセンサータイプとそれに関連する機能を示します。
大気質
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされている値:
|
サポートされている値:
|
一酸化炭素
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされている値:
|
サポートされている値:
|
煙濃度
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされている値:
|
サポートされている値:
|
フィルター清浄度
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされている値:
|
サポートされていません。 |
水漏れ
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされている値:
|
サポートされていません。 |
雨センサー
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされている値:
|
サポートされていません。 |
フィルタの存続期間
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされている値:
|
サポートされている値:
|
計算フィルタ ライフタイム
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされていません。 | サポートされている値:
|
二酸化炭素濃度
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされていません。 | サポートされている値:
|
粒子状物質
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされていません。 | サポートされている値:
|
揮発性有機化合物
氏名 | 記述的機能 | 数値的機能 |
---|---|---|
サポートされている値:
|
サポートされていません。 | サポートされている値:
|
デバイスのステータス
この特性を持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
currentSensorStateData |
配列 |
必須。 現在のセンサーの状態のリスト。 |
[item, ...] |
オブジェクト |
現在のセンサーの状態。 |
name |
文字列 |
必須。 センサーの状態名。 |
currentSensorState |
文字列 |
現在の説明状態の値。 |
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" } }