Home API Android 範例應用程式

這個範例應用程式會展示 Android 版 Google Home API 的基本功能。

必要條件

如要建構、安裝及測試應用程式，必須符合下列幾項必要條件：

  • 2024.2.1 版 (「Ladybug」) 以上版本。 Android Studio請注意，如果使用舊版，可能無法正常使用 Home API SDK。

    下載 Android Studio

  • Android 偵錯工具 (adb)。

    安裝 adb。

    您可以使用 SDK 管理工具完成這項操作。

如要測試 Home API，您需要：

  • 搭載 Android 10 以上版本的 Android 裝置，並使用您打算用於開發的 Google 帳戶設定裝置。請確認已安裝最新版本的 Android Studio，並使用這個開發帳戶登入。
  • Wi-Fi 網路。
  • 如要存取及控制Matter裝置，你還需要支援 Home API 的 Google 中樞裝置。詳情請參閱「Android 上的連線 」。

  • 住家中至少有一部支援的裝置。如果這個裝置 (或任何你想測試的裝置) 使用 Thread，中樞也必須是 Thread 邊界路由器。Android 範例應用程式支援下列裝置類型和特徵：

    • 色溫燈 (開啟和關閉、亮度)
    • 接觸感應器 (布林值狀態)
    • 可調光燈 (開關、亮度)
    • 擴展色光 (開啟和關閉、亮度)
    • 一般切換器
    • 活動情形感應器 (活動情形偵測)
    • 開燈/關燈 (開關、亮度)
    • 開關
    • 開啟/關閉外掛程式單元 (開啟和關閉)
    • 開關感應器

下載原始碼

您可以在 GitHub 上找到範例應用程式的原始碼。

前往要儲存專案的位置，然後複製專案：

git clone https://github.com/google-home/google-home-api-sample-app-android.git

設定 SDK

這個開放 Beta 版的 Android 專用 Home API，目前還不屬於 Google 提供的標準開發程式庫。如要使用 Home API 開發 Android 應用程式，您必須在本機下載及代管程式庫。

如要下載 Home API Android SDK，請先登入 Google Home 開發人員帳戶。

立即登入！

建構應用程式

  1. 開啟 Android Studio，然後開啟已複製到本機的 google-home-api-sample-app-android 專案資料夾。

  2. 首次設定時，Android Studio 可能需要最多 10 分鐘才能下載所有專案依附元件，並完成 Gradle 建構。

  3. 使用 USB 傳輸線將電腦連接至實體 Android 手機，並在開發人員選項中啟用 ADB。 確認 Android Studio 可以透過 ADB 連線至 Android 手機。

  4. 將範例應用程式的套件名稱變更為先前未註冊的新名稱，例如以貴機構名稱為基礎的名稱：

    1. 開啟專案。
    2. 展開來源階層。
    3. 選取要變更的套裝組合部分，也就是 com.example。
    4. 在套件上按一下滑鼠右鍵，然後依序選取「Refactor」>「Rename...」 「重構」>「重新命名」選單
    5. 輸入新名稱，然後按一下「重構」。
    6. 編輯 build.gradle.kts 檔案，將 android namespace 和 applicationId 改為新的套件名稱。

  5. 下載所有必要程式庫並完成 Gradle 同步處理後，請按一下「Run」按鈕，建構及執行應用程式。應用程式在手機上順利執行後，您會看到「Sample App」主頁面。

建立簽署憑證

在 Android Studio 中執行或偵錯應用程式時，系統會自動產生用於開發和偵錯的偵錯憑證。如需完整說明，請參閱「Android Studio：簽署偵錯版本」。

  1. 在 Android Studio 中執行應用程式，產生偵錯應用程式簽署憑證。在 Android Studio 中執行或偵錯應用程式時，Android Studio 會自動產生應用程式簽署憑證，供開發及偵錯使用。如需完整說明，請參閱「Android Studio：簽署偵錯版本」。

    將行動裝置連上本機。 Android Studio會依型號列出已連線的裝置。從清單中選取裝置，然後按一下「執行專案」。這會在行動裝置上建構及安裝範例應用程式。

    如需更詳細的說明，請參閱 Android 開發人員網站上的「在硬體裝置上執行應用程式」。

    現在停止執行中的應用程式。

  2. 按照 Google Cloud 控制台說明網站上「管理 OAuth 用戶端 / 應用程式類型 / 原生應用程式 / Android」一文中的詳細說明，取得偵錯憑證的 SHA-1 指紋。

  1. 在 Google Cloud 控制台中，前往專案選取器資訊主頁，然後選取要用來建立 OAuth 憑證的專案。
  2. 前往「API 和服務」頁面，然後按一下導覽選單中的「憑證」。

  3. 如果您尚未為這個 Google Cloud 專案設定同意畫面，系統會顯示「設定同意畫面」按鈕。在這種情況下，請按照下列程序設定同意畫面。如果沒有，請繼續下一個章節。

    1. 按一下「設定同意畫面」。系統會顯示「OAuth 同意畫面」頁面。
    2. 視用途選取「內部」或「外部」，然後按一下「建立」。系統會顯示「OAuth 同意畫面」窗格。
    3. 按照畫面上的指示，在「應用程式資訊」頁面輸入資訊，然後按一下「儲存並繼續」。系統隨即會顯示「範圍」窗格。
    4. 您不需要新增任何範圍，因此請按一下「儲存並繼續」。「測試使用者」窗格隨即顯示。
    5. 按一下「目標對象」，然後點選「+ 新增使用者」按鈕。
    6. 輸入測試使用者的電子郵件地址，然後按一下「儲存」按鈕。
    7. 按一下「儲存並繼續」。系統會顯示「摘要」窗格。
    8. 檢查 OAuth 同意畫面資訊，然後按一下「Back to dashboard」(返回資訊主頁)。

如需完整詳細資料，請參閱 Google Cloud 控制台說明網站上的「設定 OAuth 同意畫面」。請務必先新增至少一位測試使用者，再繼續操作。

設定 OAuth 憑證

  1. 按照「設定 OAuth 2.0」一文中的操作說明，為 OAuth 2.0 註冊範例應用程式，並建立 OAuth 憑證。
    1. 指出應用程式類型，即「原生/Android 應用程式」。
    2. 請按照 Google Cloud 控制台說明網站上「設定 OAuth 2.0 / 原生應用程式 / Android」的指示，將 SHA-1 指紋新增至 OAuth 用戶端。在整個開發過程中，您應從預設的 Android Studio 金鑰產生 SHA-1 金鑰。

執行應用程式

  1. 將行動裝置連線至本機電腦，然後再次點選「Run project」(執行專案)，在行動裝置上執行範例應用程式。

安裝完成後，行動裝置上會顯示「Home API Sample App」。