このページは Cloud Translation API によって翻訳されました。

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

このページでは、Google Home Mobile SDK で特定の Commissioning API 機能を使用する方法について説明します。

コミッション対象の検出通知を抑制する

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

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

アプリがフォアグラウンドで動作しているときに中断を防ぐには、Mobile SDK で suppressHalfSheetNotification() メソッドを呼び出して、これらの通知を抑制できます。詳細については、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 つあります。

[アプリを選択] 画面で、
ユーザーが [別のアプリを選択] を選択すると、[インストール済みの他のアプリ] 画面が表示されます。

候補アプリ

アプリ選択ツールに 2 つのおすすめアプリが表示されます。

最初の値は常に Google Home app (GHA) です。
2 つ目は、デバイスの VID または PID に関連付けられた Developer Console プロジェクトで定義されている場合、デバイスメーカーの推奨アプリ用です。

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

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