スマートホーム 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	文字列	必須。 オペレーションの結果。 サポートされている値: SUCCESS
currentCycleRemainingTime	Integer	必須。 現在のサイクルの残り時間（秒）。
1	オブジェクト	エラー
priority	Integer	必須。 通知レベルを表します。現在サポートされている値は 0 です。これは、通知を読み上げる必要があることを示します。
status	文字列	必須。 オペレーションの結果。 サポートされている値: FAILURE
errorCode	文字列	必須。 値には、このトレイトの任意のエラーコード（例: deviceStuck）を使用できます。

例

デバイスの実行が完了しました。

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

現在のサイクルの完了中にエラーが発生しました。

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

デバイスエラー

エラーと例外の全一覧をご覧ください。