创建开发者项目

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

限制

无法将 Cloud-to-cloudLocal Home SDK 功能添加到 Developer Console 中的项目。如果您希望将 Matter 功能添加到现有的 Cloud-to-cloudLocal Home 集成中,则必须先导入现有的 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. 点击创建新项目

系统会将您重定向回新项目的首页

方法 2:从 Actions on Google 控制台导入现有项目

如果您需要向现有的 Cloud-to-cloudLocal Home 集成添加 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

前往 Play 管理中心

  1. 点击 Create a Project
  2. 输入现有的 Actions 项目名称,或从下拉列表中选择一个项目(例如,在下面的屏幕截图中,项目名称为“My Matter 项目”)。
  3. 点击 Import project

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

Google Home 开发者中心使用入门

设置日志级别

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

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

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

此设置适用于项目中的所有集成。不能按集成进行设置。如果超出日志存储空间,则将所有日志保存到 Google Cloud 可能会产生额外费用。

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

共享开发者项目

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

  1. Developer Console首页上,点击成员,然后您会进入 Google Cloud Console 上的 IAM 和管理 > IAM 页面。

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

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

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

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

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