このページでは、Google Home Mobile SDK で一部のコミッショニング API 機能の使用について説明します。
紹介料の受け取りを抑制する
![Android ハーフシートの通知](https://developers.home.google.com/static/matter/apis/images/android-halfsheet-notification.png?hl=ja)
デフォルトでは、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>
参考までに、サンプルアプリのマニフェストをご覧ください。
アプリ選択ツール
![アプリ選択ツール](https://developers.home.google.com/static/matter/apis/images/app-picker.png?hl=ja)
コミッショニング プロセス中にアプリがアプリ選択ツールに表示される方法は 2 つあります。
- [アプリを選択] 画面で次のように操作します。
- ユーザーが [他のアプリを選択] を選択すると、[その他のインストール済みアプリ] 画面に表示されます。
おすすめのアプリ
アプリ選択ツールにおすすめのアプリが 2 つ表示されます。
- 最初の値は常に Google Home app (GHA) です。
- 2 つ目は、デバイス メーカーの優先アプリ用です(デバイスの VID または PID に関連付けられた Developer Console プロジェクトで定義されている場合)。
アプリが [アプリを選択] 画面に表示されている状況は 2 つあります。
- インストール済み - Play services は、アプリが
ACTION_COMMISSION_DEVICE
インテント フィルタをサポートしていることを確認します。インテント フィルタがない場合、ユーザーは Google Play ストアにリダイレクトされ、アプリを更新できます。 - Not Installed - ユーザーは、続行する前にアプリをインストールするため Play ストアに誘導されます。