跳到主要内容

简介

本节将详细说明在 RainMaker 中设置 Alexa skill 和 Google Action 所需的前提条件与配置步骤。请按照说明操作，以从 AWS 获取所需的端点、ARN 和凭据，并将其配置到 Alexa 开发者控制台和 Google Action 控制台中。此外，本文还说明了可选的认证流程、事件通知以及高级账号关联功能。

在按照本节内容操作之前，请确保已按照部署语音助手集成中的说明部署 3p-integration 堆栈。

配置 Alexa skill 和 Google Action 控制台的前提条件​

获取已部署 Google Action 的 API 终端节点​

  • 前往 AWS 控制台，打开 CloudFormation 并启用 View nested 选项。

  • 搜索 "espgva"。

  • 选择堆栈名并打开 Outputs 窗格。

  • 记下 GoogleSmartHome 键对应的值，在 Google Action 控制台中填写 Fulfillment URL 时需要用到该值。

    GVA handler Endpoint CFN

获取已部署 Alexa skill 的 Lambda ARNs​

  • 前往 AWS 控制台，打开 CloudFormation 并启用 View nested 选项。

  • 搜索 "espavs"。

  • 选择该堆栈并打开 Outputs 窗格。

  • 记下 AlexaSmartHome 键对应的值。

  • 针对 US East 1 (N. California)、US West 2 (Oregon) 和 EU West 1 (Ireland) 区域分别执行上述步骤。

  • 这些值将成为 Smart Home 服务的终端节点，并被添加至 Alexa 开发者控制台中创建的 Alexa skill 中。

    Alexa lambda ARN CFN

获取域名 URL​

  • 前往 AWS 控制台，打开 Cognito 服务页面，点击 rainmaker-user-pool。
  • 在 App Integration 下，点击 Domain。
  • 复制域名的完整 URL。
  • 记下该值，后续步骤中需要使用。

为 Alexa Skill 和 Google Action 获取客户端 ID 和密钥​

标准 RainMaker 或 OAuth-only RainMaker

适用于标准 RainMaker​

  • 在 AWS 搜索栏搜索 "Cognito"。

    Cognito Search

  • 在 User pools 界面，点击 rainmaker-user-email-mobile-pool.

    Rainmaker Userpool

  • 在 rainmaker-user-email-mobile-pool 中，点击 App integration，下滑查看应用客户端列表。

    App Clients

    App Clients1

点击 rainmaker-user-email-mobile-pool-client 后，记下应用的 Client ID 和 Client Secret。

适用于 OAuth-only RainMaker​

开发者控制配置​

完成上述所有步骤并记下所有需要的值后，你就可以在 Alexa 和谷歌语音助手开发者控制台中继续进行配置。

后续的配置步骤，请参考：

Alexa skill 后续操作​

Skill 认证与发布​

Skill 认证与发布的具体步骤，可参考 Alexa skill 官方文档 skill 认证。认证成功后，你的 skill 将按照地区被列入 Skills Store。

App-to-App 账号关联功能（可选）​

获取 Works With Alexa (WWA) 认证需要启用 App-to-App 账号关联功能。具体步骤可参考此文档。

启用 RainMaker 事件通知（可选）​

如需对产品进行 WWA 认证，则必须在以下情况下向 Alexa 发送通知：设备被添加或移除、设备状态发生变化，或设备连接/断开连接。skill 的 Lambda 程序将处理这些 RainMaker 事件并将改动通知到 Alexa，因此你需要启用以下事件：

  • 添加用户节点
  • 删除用户节点
  • 节点断开连接
  • 节点已连接
  • 节点参数变更
  • 节点共享给用户

启用 RainMaker webhook 事件的具体步骤，请参考启用通知推送。

Works with Alexa 认证（可选）​

想在产品包装和智能家居商店上展示 Works with Alexa (WWA) 徽章，需确保你的 skill 已通过 WWA 认证。更多细节，请查看 WWA 文档。

在发布 Alexa skill 并启用 App-to-App 账号关联功能和 RainMaker 事件通知功能后，你可以为该 skill 申请 WWA 认证。

Google Action 后续操作​

启用 RainMaker 事件通知​

发布 Google Action 需要确保将事件报告给 Google Home Graph。Google Action 的 Lambda 程序将处理这些 RainMaker 事件并将改动通知到 Google Home Graph，因此你需要启用以下事件：

  • 添加用户节点
  • 删除用户节点
  • 节点断开连接
  • 节点已连接
  • 节点参数变更
  • 节点共享给用户

启用 RainMaker webhook 事件的具体步骤，请参考启用通知推送。

Action 认证与发布​

  • 确认你的 Action 与固件兼容后，你可以对其进行认证。
  • 认证成功后，你的 Action 将按照地区被列入 Actions Store。

On this page