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