Home Mobile SDK 佣金

本頁面說明如何在 Google Home Mobile SDK 中使用特定的委派 API 功能。

隱藏可收佣金的探索功能通知

根據預設，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 檔案的 application 宣告中加入下列 intent-filter：

<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 商店，要求他們安裝應用程式才能繼續操作。