スマートホーム RunCycle トレイトのスキーマ
action.devices.traits.RunCycle
- このトレイトは、操作が継続し、クエリできるデバイスを表します。
このようなデバイスでは、動作開始時の合計サイクル数と、デバイスが現在実行中である各サイクルが報告されます。これにより、ユーザーは次のようなクエリを実行できます。
- 乾燥機はどのサイクル?
- 食器洗い機の残りのサイクル数は?
- 乾燥機はいま何をしている?
- 洗濯はいつ終わる?
一部のデバイスでは、非循環形式の継続時間が表示されます。サイクル形式でなくても、一定の時間動作するデバイスは残り時間を報告できます。サイクルが一定でない場合にも対応できます(例: 食器洗い機が必ずしもすべてのサイクルを使用するとは限りません)。たとえば、バキュームの実行時間はどれくらいになるのかを考えて、残りの時間と比例した時間を単位単位で返します。これは上記のデバイスにも適用されます。衣類の乾燥時間はどれくらいですか?は、所要時間を分単位で返します。
デバイスから情報が返されると、アシスタントの TTS レスポンスがそのデータを使用して最適な回答を生成します(例: 食器洗い機は稼働中。あと 20 分ほどで終了します)。
RunCycle は現在読み取り専用のトレイトです。コマンドはなく、照会するステータスのみがあります。将来的には、サイクルの再実行やスキップに対応したメカニズムになる可能性があります(この機能は、スプリンクラーには効果的ですが、洗濯機には不向きかもしれません)。
デバイスの属性
なし
デバイスのステータス
このトレイトを使用するエンティティは、QUERY
オペレーションの一部として次の状態を報告できます。QUERY
インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
currentRunCycle |
配列 |
必須。 サポートされている各言語の現在のサイクルの類義語が含まれます。 |
[item, ...] |
オブジェクト |
サイクルの類義語名。 |
currentCycle |
文字列 |
必須。 現在のサイクル。 |
nextCycle |
文字列 |
(省略可)次のサイクルで実行します。 |
lang |
文字列 |
必須。 特定のサイクル名の言語コード。サポートされている言語をご覧ください。 |
currentTotalRemainingTime |
Integer |
必須。 オペレーションの残り時間(秒)。 |
currentCycleRemainingTime |
Integer |
必須。 現在のサイクルの残り時間(秒)。 |
例
デバイスをさらに 5 分間すすぎ、20 分後に完了します。
{ "currentRunCycle": [ { "currentCycle": "rinse", "lang": "en" } ], "currentTotalRemainingTime": 1200, "currentCycleRemainingTime": 300 }
デバイスはさらに 5 分間すすぎ、その後スピンモードになります。
{ "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 }
デバイスのコマンド
なし
デバイスの通知
このトレイトを持つデバイスは、デバイスの状態の変化に伴って次の通知ペイロードを返すことがあります。通知の実装について詳しくは、スマートホーム アクションの通知をご覧ください。
フィールド | タイプ | 説明 |
---|---|---|
RunCycle |
必須。 通知ペイロード: |
|
次のいずれかをサポートします。 | ||
0
|
オブジェクト |
成功 |
priority |
Integer |
必須。 通知レベルを表します。現在サポートされている値は 0 です。これは、通知を読み上げる必要があることを示します。 |
status |
文字列 |
必須。 オペレーションの結果。 サポートされている値:
|
currentCycleRemainingTime |
Integer |
必須。 現在のサイクルの残り時間(秒)。 |
1
|
オブジェクト |
エラー |
priority |
Integer |
必須。 通知レベルを表します。現在サポートされている値は 0 です。これは、通知を読み上げる必要があることを示します。 |
status |
文字列 |
必須。 オペレーションの結果。 サポートされている値:
|
errorCode |
文字列 |
必須。 値には、このトレイトの任意のエラーコード(例: |
例
デバイスの実行が完了しました。
{ "RunCycle": { "priority": 0, "status": "SUCCESS", "currentCycleRemainingTime": 0 } }
現在のサイクルの完了中にエラーが発生しました。
{ "RunCycle": { "priority": 0, "status": "FAILURE", "errorCode": "deviceStuck" } }