创建开发者项目

开发者项目(包括 Matter 集成)在 Google Home Developer Console 上进行管理。本页介绍了如何在 Developer Console 上设置新的开发者项目。

为项目命名

为项目命名时,最好使用以下名称:

  • 包含有关项目的一些基本信息。
  • 不会轻易与其他项目的名称混淆。
  • 可以表示项目中的所有 integration。

有意义的名称非常重要。project-gamma-798 等通用名称实际上是“伪装”起来的,在其他通用名称的项目列表中不会显得突出。

在为项目命名时,请考虑以下指导原则:

  • 使用公司名称
  • 在名称中使用项目或操作类型
  • 请勿在项目名称中使用“test”

例如,acme-smarthomeacme-lighting 是清晰且唯一的项目名称。

创建项目

开发者项目表示一项或多项集成。 通过与开发团队的成员共享项目,所有者可以允许其他用户管理项目中的所有集成。

Google 智能家居生态系统集成通过 Developer Console 进行管理。

我们建议您仅为所有 Matter 集成(包括测试和生产)创建一个项目,尤其是在使用测试供应商 ID 和产品 ID 测试 Matter 时,这样可以避免出现问题。

方法 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 项目。所有者是创建项目的人员,可通过“成员”链接查看。
  • 导入项目的公司资料只能在 Actions on Google 控制台中进行修改。您在该处所做的更改将反映在 Google Home 开发者控制台中。

导入后,原始 Actions on Google 项目仍可用于管理现有集成(例如 Cloud-to-cloudLocal HomeApp Discovery)。

如需从 Actions on Google Console 导入现有项目,请前往 Developer Console

前往开发者控制台

  1. 点击创建项目
  2. 输入现有 Actions 项目名称,或从下拉列表中选择一个项目(例如,在以下屏幕截图中,项目名称为“My matter project”)。
  3. 点击导入项目

您会被重定向回 Developer Console 中的现有项目详情。

Google Home 开发者中心使用入门

设置日志级别

默认情况下,系统只会将项目中每个集成的错误日志保存到 Google Cloud

如需将所有日志保存到 Google Cloud,请在日志级别控制:错误日志部分中选择所有日志

Google Home 开发者中心项目日志级别

此设置适用于项目中的所有集成。只能针对 Cloud-to-cloud 集成替换此值。如果超出日志存储空间,将所有日志保存到 Google Cloud 可能会产生额外的费用。

如需详细了解日志,请参阅 Matter 的 Cloud Logging

共享开发者项目

您可以使用 预定义角色,为团队中的用户添加或移除项目访问权限。

  1. Developer Console首页上,点击成员,系统会将您带到 Google Cloud Console 上的 IAM 和管理 > IAM 页面。

    或者,点击项目详情,然后在底部的成员部分中点击在 GCP 中管理成员

  2. 使用 Google Cloud Console 信息中心根据需要进行更改。

如需了解如何修改对项目的访问权限,请参阅使用 IAM 对项目进行访问权限控制

添加到用户列表后,用户可以在 Developer Console 中查看项目和所有集成。

根据您的组织设置,您在尝试创建开发者项目时可能会遇到权限错误。如果是,请与您的Google Cloud管理员联系,为您的账号申请项目创建者权限