建立開發人員專案

開發人員專案 (包括 Matter 整合) 會在 Google Home Developer Console 上管理。本頁面說明如何在 Developer Console 上設定新的開發人員專案。

限制

為專案命名

命名專案時,建議您遵循以下最佳做法:

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

有意義的名稱很重要。project-gamma-798 等通用名稱會有效地「偽裝」,不會在其他通用名稱專案清單中顯眼。

命名專案時,請考量下列指南:

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

例如 acme-smarthomeacme-lighting 都是清楚且不重複的專案名稱。

建立專案

開發人員專案代表一或多個整合項目。擁有者可以與開發團隊成員共用專案,允許其他使用者管理專案中的所有整合作業。

使用 Developer Console 管理 Google 智慧型住宅生態系統整合。

建議您只為所有 Matter 整合作業 (包括測試和正式版) 建立一個專案,特別是為了避免在測試 Matter 的測試供應商 ID 和產品 ID 時發生問題。

方法 1:建立新專案

前往 Developer Console

前往開發人員控制台

  1. 在「管理專案」頁面中,按一下「建立專案」
  2. 在「開始使用」頁面中,按一下「建立專案」
  3. 輸入專案名稱,並遵守專案命名規範
  4. 按一下「建立新專案」

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

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

如果您需要為現有的 Cloud-to-cloudLocal Home SDK 整合新增 Matter 支援功能,現有的 Actions on Google 專案可能會匯入至新的 Developer Console

以下限制適用於此方法:

  • 這項匯入作業僅為單向作業。這項操作無法復原。
  • 只有專案擁有者可以匯入現有的 Actions on Google 專案。專案擁有者是建立專案的使用者,您可以透過成員連結查看。
  • 匯入專案的公司簡介只能在 Google 控制台的「動作」中編輯。變更內容會顯示在 Google Home 開發人員控制台。

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

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

前往開發人員控制台

  1. 按一下「建立專案」
  2. 輸入現有的 Actions 專案名稱,或從下拉式清單中選取專案 (例如,在下方螢幕截圖中,專案名稱為「我的 Matter 專案」)。
  3. 按一下「Import project」

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

Google Home 開發人員中心:開始使用

設定記錄層級

根據預設,專案中每個整合項目只會將錯誤記錄檔儲存至 Google Cloud

如要為每個整合項目將所有記錄檔儲存至 Google Cloud,請在「記錄等級控制項:錯誤記錄檔」部分選取「所有記錄檔」

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

這項設定適用於專案中的所有整合。這項屬性只能針對 Cloud-to-cloud 整合作業覆寫。如果記錄儲存空間用量超出,將所有記錄儲存至 Google Cloud 可能會產生額外費用。

如要進一步瞭解記錄,請參閱「Matter 的 Cloud Logging 」。

分享開發人員專案

您可以使用 預先定義的角色,在團隊使用者之間新增或移除專案存取權。

  1. Developer Console 的「Home」頁面中,按一下「Members」,即可前往 Google Cloud Console 的「IAM & Admin」 >「IAM」頁面。

    或者,按一下「專案詳細資料」,然後點選底部的「成員」部分中的「在 GCP 中管理成員」

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

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

加入使用者名單後,使用者就能在 Developer Console 中查看專案和任何整合項目。

根據貴機構的設定,您在嘗試建立開發人員專案時,可能會發生權限錯誤。如果是這樣,請與Google Cloud管理員聯絡,要求為您的帳戶提供專案創作者權限