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

action.devices.traits.RunCycle - このトレイトは、オペレーションの実行時間が継続してクエリ可能であるデバイスを表します。

このようなデバイスは、オペレーションの開始時に総サイクル数を報告します。 実行中のデバイスの現在のサイクルごとに 確認できますこれにより、ユーザーは次のようなクエリを実行できます。

  • 乾燥機はどのサイクル？
  • 食器洗い機の残りのサイクル数は？
  • 乾燥機はいま何をしている？
  • 洗濯はいつ終わる？

一部のデバイスには、非周期的な形式で期間が記録されています。サイクル形式でなくても、一定の時間動作するデバイスは残り時間を報告できます。サイクルが一定でない場合にも対応できます（例: 食器洗い機が必ずしもすべてのサイクルを使用するとは限りません）。たとえば、ユーザーは ] を選択すると、時間はユニットで返されます。 時間は残り時間に比例します。これは、リストに記載されているデバイスにも適用されます。 上記。服が乾くまでの時間は？: 時間は分単位で返されます。

デバイスから情報が返されると、アシスタントの TTS レスポンスがそのデータを使用して最適な回答を生成します（例: 食器洗い機は稼働中。あと 20 分ほどで終了します）。

RunCycle は現在読み取り専用のトレイトです。コマンドはなく、照会するステータスのみがあります。将来的には、サイクルの再実行やスキップに対応したメカニズムになる可能性があります（この機能は、スプリンクラーには効果的ですが、洗濯機には不向きかもしれません）。

デバイスの属性

なし。

デバイスのステータス

このトレイトを持つエンティティは、以下を報告する場合があります。 複数の状態を QUERY オペレーションの一部として呼び出します。学習内容 QUERY インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

州 タイプ 説明
currentRunCycle 配列

必須。

サポートされている各言語での現在のサイクルの同義語が含まれます。
[item, ...] オブジェクト

類義語名を循環させる。
currentCycle String

必須。

現在実行中のサイクル。
nextCycle String

省略可。次に実行するサイクル。
lang String

必須。

指定された生理周期名の言語コード。サポートされている言語をご覧ください。
currentTotalRemainingTime 整数

必須。

オペレーションの残り時間（秒）。
currentCycleRemainingTime 整数

必須。

現在のサイクルの残り時間（秒）。

例

デバイスをさらに 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 整数

必須。

通知レベルを表します。現在サポートされている値は 0 で、通知が読み上げられることを示します。
status String

必須。

オペレーションの結果。

サポートされている値:

SUCCESS
currentCycleRemainingTime 整数

必須。

現在のサイクルの残り時間（秒）。
1 オブジェクト

失敗
priority 整数

必須。

通知レベルを表します。現在サポートされている値は 0 で、通知が読み上げられることを示します。
status String

必須。

オペレーションの結果。

サポートされている値:

FAILURE
errorCode String

必須。

値には、このトレイトの任意のエラーコード（deviceStuck など）を指定できます。

例

デバイスの稼働が完了しました。

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

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

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

デバイスエラー

詳しくは、 エラーと例外をご覧ください。