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

このページでは、Google Home Mobile SDK の選択されたコミッショニング API 機能の使用について説明します。

コミッションによる検出通知の抑制

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

デフォルトでは、AndroidGoogle Play services は、モバイル デバイスの画面下半分に表示される「ハーフシート」通知を使用して、コミッション可能な Matter デバイスが近くにあることを事前に通知します。

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

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

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

Matter のコミッショニングがサポートされていることを示す

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

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 プロジェクトで定義されている場合、デバイス メーカーの優先アプリ用です。デバイス メーカー優先コミッショナー アプリ

[Choose an app] 画面が表示されているシナリオは 2 つあります。

  1. インストール済み - アプリが ACTION_COMMISSION_DEVICE インテント フィルタをサポートしていることを Play services がチェックします。インテント フィルタがない場合、ユーザーは Play ストアにリダイレクトされ、アプリの更新を促されます。
  2. インストールされていません - ユーザーは Play ストアにリダイレクトされ、続行する前にアプリをインストールするよう求められます。