Home Mobile SDK 佣金

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

停用可賺取佣金的探索通知

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

根據預設，Android 上的 Google Play services 會使用「半頁」通知，涵蓋行動裝置螢幕的下半部，主動向使用者指出附近有可賺取佣金的Matter裝置。

為避免應用程式在前台執行時受到干擾，您可以呼叫 Mobile SDK 中的 suppressHalfSheetNotification() 方法，禁止顯示這些通知。詳情請參閱 API 說明文件。

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

這個 API 的實作項目位於 Google Home Sample App for Matter。詳情請參閱 HalfSheetSuppressionObserver.kt。

指出支援 Matter 委派

如果您使用 Mobile SDK 委派，則必須在 Google Home Developer Console 中新增應用程式套件名稱、實作 Matter API，並處理 ACTION_COMMISSION_DEVICE intent，指出應用程式支援 Matter 委派。

在 AndroidManifest.xml 檔案中，將下列 intent-filter 新增至 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 商店安裝應用程式，才能繼續。