Home Mobile SDK のコミッショニング

このページでは、 Google Home Mobile SDK の一部のコミッショニング API 機能の使用方法について説明します。

コミッショニング可能なデバイスの検出通知を抑制する

Android ハーフシート通知
図 1: Android のハーフシート通知の例

デフォルトでは、Google Play services は Android を使用します モバイル デバイスの画面の下半分を覆う「ハーフシート」通知を使用して、コミッショニング可能な Matter デバイスが近くにあることをユーザーに積極的に示します。

アプリがフォアグラウンドで動作しているときに中断されないようにするには、 これらの通知を suppressHalfSheetNotification() メソッドを呼び出して抑制します。Mobile SDK詳しくは、API ドキュメントをご覧ください。

この API によって有効になる抑制は、アプリが 15 分以上フォアグラウンドで動作しているとタイムアウトします。タイムアウト後に抑制を再度有効にするには、suppressHalfSheetNotification() を再度呼び出します。呼び出さないと、ハーフシート通知が表示されます。

この API の実装は、 Google Home Sample App for Matter にあります。詳しくは、 HalfSheetSuppressionObserver.kt をご覧ください。

Matter コミッショニングのサポートを示す

Mobile SDK を使用してコミッショニングを行う場合は、Google Home Developer Console でアプリ パッケージ名を追加し、Matter API を実装して、ACTION_COMMISSION_DEVICE インテントを処理することで、アプリが Matter コミッショニングをサポートしていることを示す必要があります。

AndroidManifest.xml ファイル内の application 宣言に次の intent-filter を追加します。

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

リファレンスについては、 サンプルアプリのマニフェスト をご覧ください。

アプリ選択ツール

アプリ選択ツール

コミッショニング プロセス中にアプリ選択ツールにアプリが表示される方法は 2 つあります。

  1. [アプリを選択] 画面に表示されます。
  2. ユーザーが [他のアプリを選択] を選択すると、[インストールされている他のアプリ] 画面に表示されます。

候補アプリ

アプリ選択ツールには、2 つの候補アプリが表示されます。

  • 1 つ目は常に Google Home app (GHA) です。
  • 2 つ目は、デバイスの VID または PID に関連付けられた Developer Consoleプロジェクトで定義されている場合、 デバイス メーカーの推奨アプリです。デバイス メーカーの優先コミッショナー アプリ

アプリが [アプリを選択] 画面に表示されるシナリオは 2 つあります。

  1. インストール済み - Play services アプリケーションが ACTION_COMMISSION_DEVICE インテント フィルタをサポートしていることを確認します。インテント フィルタがない場合、ユーザーは Play ストアにリダイレクトされ、アプリのアップデートを促されます。
  2. 未インストール - ユーザーは Play ストアにリダイレクトされ、続行する前にアプリをインストールします 。