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。

請將下列 intent-filter 加入 AndroidManifest.xml 檔案的 application 宣告中：

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

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

應用程式挑選器

應用程式挑選器

在調控程序中，應用程式會透過以下兩種方式顯示在應用程式挑選器中：

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

推薦應用程式

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

  • 第一個值一律為 Google Home app (GHA)。
  • 第二種用於裝置製造商的偏好應用程式 (如果在與裝置 VID 或 PID 相關聯的 Developer Console 專案中定義的話)。裝置製造商慣用的 Agenter 應用程式

應用程式會顯示在「選擇應用程式」畫面中。

  1. 「Installed」：Play services 會檢查應用程式是否支援 ACTION_COMMISSION_DEVICE 意圖篩選器。如果缺少意圖篩選器，系統會將使用者導向 Play 商店，讓他們更新應用程式。
  2. 「Not Installed」：引導使用者前往 Play 商店安裝應用程式，然後再繼續操作。