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 授權。

請將下列 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. 「Installed」：Play services 會檢查應用程式是否支援 ACTION_COMMISSION_DEVICE 意圖篩選器。如果缺少意圖篩選器，系統會將使用者導向 Play 商店更新應用程式。
2. 未安裝：系統會將使用者導向 Play 商店，要求他們安裝應用程式才能繼續操作。