建立開發人員專案

包含 Matter 整合功能的開發人員專案是由 Google Home Developer Console 管理。本頁面說明如何在 Developer Console 上設定新的開發人員專案。

限制

無法將 Cloud-to-cloudLocal Home SDK 功能新增至 Developer Console 中的專案。如要在現有的 Cloud-to-cloudLocal Home 整合項目中加入 Matter 功能,您必須先匯入現有的 Actions on Google 專案

為專案命名

為專案命名時,建議您設定一個符合以下條件的名稱:

  • 包含專案的部分基本資訊。
  • 不會輕易與其他專案混淆。
  • 可代表專案中的所有 integration。

有意義的名稱相當重要。一般名稱 (例如 project-gamma-798) 在這方面實際上會「偽裝」,不會在其他一般名稱的專案清單中脫穎而出。

為專案命名時,請參考下列指引:

  • 使用貴公司名稱
  • 在名稱中使用專案或動作的類型
  • 請勿在專案名稱中使用「test」

舉例來說,acme-smarthomeacme-lighting 是清楚且不重複的專案名稱。

建立專案

開發人員專案代表一或多個 integration。藉由與開發團隊成員共用專案,擁有者就能允許其他使用者管理專案中的所有 integration。

Google 智慧型住宅生態系統 integration是使用新的 Developer Console 管理。在 Developer Console 中設定專案有兩種方法:

  1. 建立新專案
  2. 從 Actions on Google 控制台匯入現有專案

建議您只針對所有測試和正式版 Matter 整合建立一個專案,特別是為了避免使用 Matter 的測試供應商 ID 和產品 ID 進行測試。

方法 1:建立新專案

前往 Developer Console

前往 Play 管理中心

  1. 在「管理專案」頁面中,按一下「建立專案」
  2. 在「開始使用」頁面中,按一下「建立專案」
  3. 輸入專案名稱,該名稱應遵循專案命名規範
  4. 按一下「Create New Project」(建立新專案)

系統會將您重新導向回新專案的「首頁」頁面。

方法 2:從 Actions on Google 主控台匯入現有專案

如果您需要將 Matter 支援新增至現有的 Cloud-to-cloudLocal Home 整合作業,則可將現有的 Actions on Google 專案匯入至新的 Developer Console

這個方法具有以下限制:

  • 這個匯入項目僅限單向匯入,請注意,這項操作無法復原。
  • 只有專案擁有者才能匯入現有的 Actions on Google 專案。擁有者即為專案擁有者。如要查看專案,請點選「成員」連結
  • 您只能在 Actions on Google 控制台中編輯匯入專案的公司設定檔。Google Home 開發人員控制台會反映這些變更。

匯入後,您還是可以使用原本的 Actions on Google 專案管理現有的整合項目 (例如 Cloud-to-cloudLocal HomeApp Discovery)。

如要從 Actions on Google Console 匯入現有專案,請前往 Developer Console

前往 Play 管理中心

  1. 按一下「Create a Project」(建立專案)
  2. 輸入現有的動作專案名稱,或從下拉式清單中選取專案 (例如在下方螢幕截圖中,專案名稱為「My Matter 專案」)。
  3. 按一下「匯入專案」

系統會將您重新導向回 Developer Console 中現有專案的詳細資料。

Google Home 開發人員中心入門指南

設定記錄層級

根據預設,針對專案的每項整合作業,Google Cloud只會儲存錯誤記錄。

如要將每次整合的所有記錄檔儲存至 Google Cloud,請在「Log level Control: Error logs」(記錄層級控制:錯誤記錄) 專區中選取「All logs」(所有記錄檔)

Google Home 開發人員中心專案記錄層級

這項設定適用於專案中所有整合項目。無法針對每次整合設定。如果超出記錄檔儲存空間,將所有記錄檔儲存至 Google Cloud 可能會產生額外費用。

如要進一步瞭解記錄檔,請參閱 Matter 適用的 Cloud Logging 一文。

分享開發人員專案

您可以使用 預先定義的角色,新增或移除團隊成員對專案的存取權。

  1. Developer Console 的「首頁」上,按一下「成員」,即可前往 Google Cloud Console 的「IAM 與管理」>「身分與存取權管理」頁面。

    您也可以按一下 [專案詳細資料],然後在底部的「成員」部分按一下 [在 GCP 中管理成員]

  2. 使用 Google Cloud Console 資訊主頁進行必要變更。

如需修改專案存取權的操作說明,請參閱「使用 IAM 對專案進行存取權控管」一文。

將使用者新增至使用者名單後,使用者就能在 Developer Console 中查看專案和所有整合作業。

根據您的機構設定,在嘗試建立開發人員專案時可能會遇到權限錯誤。如果發生這種情況,請與您的 Google Cloud 管理員聯絡,並為您的帳戶要求專案建立者權限