Android 用 Automation API はほとんどのトレイトをサポートしていますが、トレイト内の属性、イベント、コマンドの一部はサポートが制限されている場合があります。
一般的には次のようになります。
- Automation API でアプリで使用する予定のトレイトと型は、初期化時に登録する必要があります。Home インスタンスを作成するをご覧ください。
- 開始条件または条件には任意の属性を使用できます。
- 状態を報告しない Cloud-to-cloud デバイスは、手動または検出によって作成された自動化のトリガーとして使用できません。
デバイスがここに記載されている特性をサポートしていても、状態のレポートの品質しきい値により、Automation API で開始条件またはアクションとして使用できない場合があります。
- レポート状態の成功率が 90% を下回るデバイスは、スターターとして使用できません。
- コマンド実行の成功率が 95% を下回るデバイスは、アクションとして使用できません。
Automations API でサポートされているデバイスモデルの一覧と、それらのモデルがサポートする特定の開始条件とアクションを参照してください。
コマンドはアクションとしてのみ使用できます。
AssistantBroadcastやNotificationなどの一部のトレイトは、Automation API でのみ使用できます。okGoogleコマンドは構造レベルのコマンドで、構造内の任意のデバイスを自動化するために使用できます。ただし、Home APIs アプリはすべてのデバイスにアクセスできるとは限りません。さまざまなケースで権限がどのように適用されるかについては、「OK Google」の権限をご覧ください。一部の特性には前提条件があります。
Time.ScheduledTimeEvent、Time.RecurringClockTimeScheduledEvent、Time.RecurringSolarTimeScheduledEventなどの時間ベースの開始条件を使用するには、自動化が実行される建物に、ローカル タイムゾーンと太陽光計算を特定するための住所が必要です。アドレスは、構造の作成時に指定するか、Google Home app (GHA) で設定できます。Google の自宅住所を変更するでは、ユーザーが GHA で建物住所を入力または更新する方法について説明しています。アドレスが設定されていない場合、createAutomation()はAutomationを保存して返します。ここで、isValid == falseはMissingStructureAddressSetupを含むUnsupportedEntityEvent検証の問題です。- 家族が
Notification.sendNotificationsから通知を受け取るには、GHA をインストールし、通知を有効にする必要があります。通知は GHA を介してメンバーに配信され、サードパーティ製アプリに直接送信することはできません。 AreaPresenceStateまたはAreaAttendanceStateトレイトを使用するには、ユーザーが GHA で在宅確認を設定する必要があります。ObjectDetectionトレイトを使用するには、ユーザーが有効な Google Home Premium サブスクリプションを持っている必要があります。
一部の特性の簡略版は、自動化で使用することもできます。詳しくは、Android の簡素化されたトレイトをご覧ください。