Home Mobile SDK 佣金

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

抑制可收取佣金的發現通知

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

預設情況下，Google Play services on Android 使用「半頁」通知，覆蓋行動裝置螢幕的下半部分，主動向使用者指示附近有可佣金的 Matter 裝置。

為防止應用程式在前台執行時受到干擾，您可以透過在 Mobile SDK 中呼叫 suppressHalfSheetNotification() 方法來抑制這些通知。詳情請參閱 API 說明文件。

如果您的應用程式在前台運行超過 15 分鐘，則此 API 啟用的抑制功能將逾時。逾時後，若要重新啟用抑制功能，請再次呼叫 suppressHalfSheetNotification()，否則半頁通知將開始出現。

該 API 的實作可以在 Google Home Sample App for Matter 中找到。詳情請參閱 HalfSheetSuppressionObserver.kt。

表示支持事項委託

如果您正在使用Mobile SDK要獲得委託，您必須新增應用程式包名在Google Home Developer Console實施我們的MatterAPI，並表明您的應用程式支援Matter透過處理進行調試ACTION_COMMISSION_DEVICE意圖。

在您的 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 商店安裝應用程式，才能繼續操作。