Home Mobile SDK 佣金

本頁面說明 Google Home Mobile SDK 中特定調試 API 功能的用法。

隱藏可委託進行的探索通知

Android Halfsheet 通知
圖 1：Android 半頁通知範例

根據預設，Android 上的 Google Play services 會使用「半頁」通知，遮住行動裝置螢幕的下半部，為使用者提供主動指示，指出可綁定的 Matter 裝置在附近。

為避免應用程式在前景運作時受到干擾，您可以在 Mobile SDK 中呼叫 suppressHalfSheetNotification() 方法，以隱藏這些通知。詳情請參閱 API 說明文件。

如果應用程式在前景運作超過 15 分鐘，這個 API 啟用的抑制功能就會逾時。如要在逾時後重新啟用隱藏功能，請再次呼叫 suppressHalfSheetNotification()，否則會開始顯示半頁通知。

您可以在 Google Home Sample App for Matter 中找到這個 API 的實作方式。詳情請參閱 HalfSheetSuppressionObserver.kt。

表示支援 Matter 調試

如果您要使用 Mobile SDK 進行佣金，必須在 Google Home Developer Console 中新增應用程式套件名稱、實作 Matter API，並透過處理 ACTION_COMMISSION_DEVICE 意圖指出應用程式支援 Matter 執行程序。

將下列 intent-filter 新增至 AndroidManifest.xml 檔案的 application 宣告中：

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

詳情請參閱範例應用程式的資訊清單。

應用程式挑選器

應用程式挑選器

在調解程序期間，應用程式會在應用程式挑選器中顯示以下兩種：

  1. 在「選擇應用程式」畫面中。
  2. 如果使用者選取「選擇其他應用程式」，應用程式就會顯示在「其他已安裝的應用程式」畫面中。

推薦的應用程式

應用程式挑選器會顯示兩個建議的應用程式。

  • 第一個值一律為 Google Home app (GHA)。
  • 第二個程式碼則適用於裝置製造商的偏好應用程式 (如裝置 VID 或 PID 關聯的 Developer Console 專案中定義了該應用程式)。裝置製造商的首選佣金應用程式

應用程式顯示在「選擇應用程式」畫面有兩種情況。

  1. 已安裝 - Play services 檢查應用程式是否支援 ACTION_COMMISSION_DEVICE 意圖篩選器。如果缺少意圖篩選器，系統會將使用者導向至 Play 商店以更新應用程式。
  2. 未安裝 - 系統會引導使用者前往 Play 商店安裝應用程式，然後再繼續操作。