如果您的自有App使用了内置账号体系,我们提供了一套解决方案,让您可以零代码实现,自有App中绑定的设备同时被Google Assistant语音控制。

概览

自有App对接Google Assistant的总体步骤如下。

  1. 生活物联网平台(国际站)创建一个项目,并在该项目中创建产品和自有App。
  2. 登录Google Action根据步骤完成配置。
  3. 登录Google Cloud,开启HomeGraph API 调用权限。
  4. 完成配置,测试您的设备。
说明
  • Google Assistant中创建Action是免费的。此外,生活物联网平台已经整合打包了阿里云的函数计算等多个服务,用于支撑两个平台间的数据流转。
  • 对接Amazon Alexa时,仅支持在生活物联网平台(国际站)创建项目、产品和App。

架构图

业务架构图如下所示。
对接Google Assistant业务架构图

准备工作

您会在3个平台中将信息互相填写。请在开始前,先前往Google Action,并打开Google Cloud,打开生活物联网平台(国际站),开始按照下面步骤完成配置。

操作步骤

  1. Google Action中,新建一个Project。

    新建project
  2. 选择Smart Home

    选择模板
  3. 填写以下内容的信息。
    1. 设置Action名称。
      设置action名称
    2. 为您的Action起一个便于用户搜索的名称。

      显示的名称
    3. 在Fulfillment中,粘贴以下链接地址。

      https://open-living-sg.aliyuncs.com/voice/interaction/support/GoogleActions/v1


      配置链接
    4. 按照下图配置Linking Type。

      配置Linking Type
    5. 配置对接信息。
      我们推荐您的自有App直接使用内置账号体系,即可实现零代码对接Google Assistant。
      1. 请在生活物联网平台(国际站)自有品牌App-用户账号中,单击查看对接信息,获取相关内容,如下图所示。
        查看对接信息
        对接信息
      2. 将生活物联网平台中的对接信息粘贴到Google Action的如下字段中。
        填写信息
        以下内容可不填。
        参数
      3. 在Google Action Console中,找到projectID,例如下图链接中所示。
        projectID
      4. 将ProjectID复制到生活物联网平台(国际站)的自有品牌App-用户账号的Google Assistant中的回调地址内。
        回调地址
  4. 在Google Cloud开启和授权API。
    1. 登录Google Cloud,选择API和服务 > 信息中心

      信息中心
    2. 单击启用API和服务

      启用API和服务
    3. 搜索“HomeGraph API”,单击启用

      API库
      搜索API库

      启用成功后,启用按钮会变成管理,且页面提示“API已启用”。


      启用服务
    4. 选择IAM和管理 > 服务账号

      服务账号
    5. 创建服务账号。
      • 服务账号名称:自定义一个名称,如“your_push_state_proxy”。
      • 服务账号ID:自动生成后,复制这个邮箱格式的服务账号ID,通过工单联系生活物联网平台的技术支持人员。

      创建服务账号
    6. 单击生活物联网平台主页面右上角的工单,将以下两个信息,发给我们的技术支持人员。
      “请帮我完成Google Home语音平台对接的配置,以下是我的配置信息。
      • 您在生活物联网平台中创建的项目ID(如下图,在项目名称旁)
      • 在Google Cloud Platform自动生成的服务账号ID(上一步复制的Google Cloud的邮箱格式的服务账号)”

      工单
    7. 创建工单。
      选择提交工单 > 对接智能音箱 > 创建工单
      创建工单
    8. 授权阿里云账号对项目进行访问。
      如下图找到IAM-添加成员,示例如下。
      • 新成员:填写生活物联网平台提供的官方账号homegraph@aliyun-iot.iam.gserviceaccount.com
      • 角色:搜索Service Account Toke Creator

      添加授权
    9. 保存,配置完成。

语音控制设备

完成配置后,您就可以使用Alexa 控制您自有App的设备了,请根据以下步骤尝试语音控制。

  1. 准备一台Google Home音箱,下载Google Home或者 Google AssistantApp,安装并绑定到您的音箱。
    说明 iOS系统用户请至美国区App Store搜索Google Home下载,Android用户请至Google Play搜索Google Home下载。

    谷歌助手
  2. 准备一台设备,使用您的自有品牌App进行配网绑定。
  3. 在Google Home客户端中添加设备,找到您创建的Google Action。输入您自有品牌App登录的账号和密码,完成添加您的智能设备。

    绑定设备
  4. 您可以通过下列指令控制您的设备(如Light)。
    • Hey Google, turn on/off the light. (开关设备)
    • Hey Google, brighten/dim the light. (灯亮度增强/减弱)
    • Hey Google, set the light to yellow.(灯颜色调节)
    • Hey Google, set the light to warm white.(灯色温调节)

发布Google Action

完成开发后,就可以发布您的Google Action了。

说明 根据Google Actions的官方要求,提交Action的发布信息后,需要根据引导将真实设备邮寄提供给Google Actions,Google的审核人员进行测试使用后,才会发布您的Action。