Android での Automation API トレイトのサポート

Android 用 Automation API はほとんどのトレイトをサポートしていますが、トレイト内の属性、イベント、コマンドの一部はサポートが制限されている場合があります。

一般的には次のようになります。

  • Automation API でアプリで使用するトレイトと型は、初期化時に登録する必要があります。Home インスタンスを作成するをご覧ください。
  • 開始条件または条件では、任意の属性を使用できます。
  • 状態をレポートしない Cloud-to-cloud デバイスは、手動または検出によって作成された自動化のトリガーとして使用できません。
  • デバイスがここに記載されているトレイトをサポートしていても、状態のレポートの品質しきい値により、Automation API でスターターまたはアクションとして使用できない場合があります。

    • Report State の成功率が 90% を下回るデバイスは、スターターとして使用できません。
    • コマンド実行の成功率が 95% を下回るデバイスは、アクションとして使用できません。

    Automations API でサポートされているデバイスモデルのリストと、それらがサポートする特定の開始条件とアクションを参照してください。

  • コマンドはアクションとしてのみ使用できます。

  • AssistantBroadcast などの一部の特性は、Automation API でのみ使用できます。

  • okGoogle コマンドは構造レベルのコマンドで、構造内の任意のデバイスを自動化するために使用できます。ただし、Home APIs アプリはすべてのデバイスにアクセスできるとは限りません。さまざまなケースで権限がどのように適用されるかについては、OkGoogle の権限をご覧ください。

  • 一部の特性には前提条件があります。

    • Time.ScheduledTimeEvent を使用するには、自動化が実行される構造に、Google Home app (GHA) で設定された番地が必要です。Google の自宅住所を変更するでは、ユーザーが構造物の住所を入力する方法について説明しています。GHA でアドレスが設定されていない場合、自動化の作成は失敗し、「ScheduledTimeEvent is not supported by the structure.」というメッセージとともにエラーがスローされます。
    • AreaPresenceState または AreaAttendanceState トレイトを使用するには、ユーザーが GHA で在宅確認を設定する必要があります。
    • ObjectDetection トレイトを使用するには、Google Nest Aware の定期購入が有効になっている必要があります。

一部の特性の簡略版は、自動化で使用することもできます。詳しくは、Android の簡素化されたトレイトをご覧ください。