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

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

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

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

    • Report State の成功率が 90% 未満のデバイスは、開始条件として使用できません。
    • コマンド実行の成功率が 95% 未満のデバイスは、アクションとして使用できなくなります。

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

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

  • AssistantBroadcast や Notification などの一部のトレイトは、Automation API でのみ使用できます。

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

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

    • Time.ScheduledTimeEvent、Time.RecurringClockTimeScheduledEvent、Time.RecurringSolarTimeScheduledEvent などの時間ベースの開始条件を使用するには、自動化が実行されるストラクチャに、ローカル タイムゾーンと太陽の計算を決定するための番地が必要です。住所は、ストラクチャの作成時に指定するか、Google Home app (GHA) で設定できます。Google の自宅の住所を変更するでは、ユーザーが GHA でストラクチャの住所を入力または更新する方法について説明しています。アドレスが設定されていない場合、createAutomation() は isValid == false の Automation を保存して返します。UnsupportedEntityEvent の検証の問題には MissingStructureAddressSetup が含まれます。
    • 家のメンバーが Notification.sendNotifications から通知を受け取るには、GHA をインストールして通知を有効にする必要があります。通知は GHA を通じてメンバーに配信され、サードパーティ製アプリに直接送信することはできません。
    • AreaPresenceState トレイトまたは AreaAttendanceState トレイトを使用するには、ユーザーが GHA で在宅確認を設定する必要があります。
    • ObjectDetection トレイトを使用するには、ユーザーが有効な Google Home Premium サブスクリプションを所有している必要があります。

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