Android 專用的 Home Mobile SDK

為了協助您建構可與 Matter 裝置互動的 Android 應用程式,Google 開發了 Google Home Mobile SDKMobile SDK 包含兩個核心 API,可讓應用程式與 Google 架構合作並共用裝置。

裝置加入 Google 結構體後,使用者就能透過 Google Home app (GHA)、Android 電源控制選項、語音和 Nest 觸控螢幕裝置控制裝置。

Mobile SDK 還可讓您定義自訂委派服務,用於將裝置委派至其他 Matter 生態系統。

將 Mobile SDK 整合至 Android 應用程式

如要開始使用,請完成下列步驟:

  1. 請按照「設定 Google Play services」一節中的說明操作。

  2. Play services 依附元件新增至 build.gradle 檔案:

    implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
    

確保模組可順利傳送

Play services home 模組為選用模組,因此只有在裝置上的應用程式在 AndroidManifest.xml 檔案中指定適當的 Play services 模組依附元件時,Matter 功能才會出現在使用者的裝置上。

GHAGoogle Home Sample App for Matter 都會在資訊清單中加入這個模組依附元件。如果您將 Mobile SDK 整合至 Android 應用程式,為確保應用程式使用者可享有 Matter 支援,請在 AndroidManifest.xml 檔案的 application 宣告中加入下列 service 區塊:

<service android:name="com.google.android.gms.metadata.ModuleDependencies"
    android:enabled="false"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
    </intent-filter>

    <meta-data android:name="home:0:preferred" android:value=""/>
</service>

這項功能僅支援搭載 Play services 22.50.14 以上版本的 Android 裝置。

如需實作範例,請參閱 Sample App for Matter 的資訊清單

您可以使用 ModuleInstallClient 在執行階段檢查 Google Home 模組的可用性。詳情請參閱「透過 ModuleInstallClient 確保 API 可用性」一文。

呼叫其他 Android 應用程式

如果您使用的是 Android 11 以上版本,就必須在 AndroidManifest.xml 中加入下列 queries 區塊,讓應用程式能夠呼叫其他應用程式。

<queries>
    <!-- For GMS Core/Play service -->
        <package android:name="com.google.android.gms" />
        <package android:name="com.android.vending" />
    <!-- End of GMS Core/Play service-->
</queries>

詳情請參閱「在 Android 上篩選套件瀏覽權限」一文。

使用 Matter 適用的 Google Home 範例應用程式

如要瞭解 Mobile SDK 如何在 Android 應用程式中運作,請試試我們的 Sample App for Matter

試試看 Sample App for Matter

自行建構應用程式

為了協助您快速上手,我們已將 Sample App for Matter 開放原始碼,並提供配套程式碼研究室,讓您為自己的 Android 專案自訂範例程式碼。

前往 Sample App for Matter 程式碼研究室

資源

如要進一步瞭解 Mobile SDK,請參閱 API 參考資料

如要瞭解這個 SDK 如何處理使用者資料,請參閱 Home Mobile SDK Google Play 資料安全性專區