Home Mobile SDK 佣金

本頁面說明 Google Home Mobile SDK 中特定委託 API 功能的使用方式。

隱藏可佣金探索通知

Android 半頁通知
圖 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 委任。

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

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

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

應用程式挑選器

應用程式挑選器

在委任程序中，應用程式會以兩種方式顯示在應用程式挑選器中：

  1. 在「選擇應用程式」畫面中。
  2. 如果使用者選取「Choose other app」，系統會顯示「Other Installed Apps」畫面。

建議使用的應用程式

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

  • 第一個一律為 Google Home app (GHA)。
  • 第二個是裝置製造商偏好的應用程式，前提是該應用程式已在與裝置 VID 或 PID 相關聯的 Developer Console 專案中定義。裝置製造商偏好的委任者應用程式

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

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