【品牌APP】接入Google Assistant教程
更新时间：2019-09-07 00:33:31
| 更新日期 | 更新内容 |
|---|---|
| 2019-08 | 接入Google Assistant方案升级到2.0版本，和1.0相比，无需再写一行代码，仅需简单配置，即可实现自有APP接入Google Assistant |
| 2018-08 | 1.0版本 |
1. 概览
如果您的自有APP使用了内置账号体系，我们提供了一套解决方案，让您零代码就可以实现，自有App中绑定的设备也可以被Google Assistant语音控制。以下是自有APP如何对接Google Assistant的大致步骤：
- 在生活物联网平台（国际站）创建一个项目，在该项目中创建一个自有APP；
- 登录Google Action，创建一个Action，并将生活物联网平台中的信息互相填入，根据步骤完成配置；
- 登录Google Cloud ，开启HomeGraph API 调用权限；
- 完成配置，测试您的设备。
注意：Google Assistant中创建Action是免费的。此外，生活物联网平台已经整合打包了阿里云的函数计算等多个服务，用于支撑两个平台间的数据流转。
2. 架构图
3. 详细步骤
3.1 准备工作
过程中，您会在3个平台中将信息互相填写。请在开始前，先前往Google Action，注册一个Google开发者账号，并打开Google Cloud，打开生活物联网平台（国际站），开始按照下方步骤完成配置。
3.2 创建Google Action
在Google Action中，新建一个Project：
选择Cloud Intelligence：
根据以下步骤，完成Google Action信息的填写：
为你的Action起一个便于用户搜索的名称：
在Fulfillment中，将这个链接复制进去：
https://open-living-sg.aliyuncs.com/voice/interaction/support/GoogleActions/v1
Linking Type按照如下选择：
我们推荐您的自有APP直接使用内置账号体系，即可实现零代码，完成Google Assistant对接。请在生活物联网平台（国际站）-自有APP-用户账号-查看对接信息，获取相关内容，如下图所示：
将上图中的4条信息复制到Google Action的如下4个字段中：
以下内容可不填：
在Google Action Console中，找到projectID，例如链接中：
将ProjectID 复制到生活物联网平台（国际站）-自有APP-用户账号-Google Assistant中的回调地址中：
3.3 在Google Cloud开启和授权API
3.3.4 登录Google Cloud，打开API和服务 - 信息中心：
启用API和服务 - 搜索“HomeGraph API”
找到“HomeGraph API”，点击启用：
找到IAM和管理-服务账号：
创建服务账号：
服务账号名称：自定义一个名称,如“your_push_state_proxy”
服务账号ID：自动生成后，复制这个邮箱格式的服务账号ID，通过工单联系生活物联网平台的技术支持人员。
在生活物联网平台右上角，找到工单入口，将以下2个信息，发给我们的技术支持人员：
“请帮我完成Google Home语音平台对接的配置，以下是我的配置信息：
- 您在生活物联网平台中创建的项目ID（如下图，在项目名称旁）
- 在Google Cloud Platform自动生成的服务账号ID（上一步复制的Google Cloud的邮箱格式的服务账号）”
工单-对接智能音箱-创建工单：
最后一步，需要添加授权，授权阿里云账号对项目进行进行授权访问。如下图找到IAM-添加成员：
新成员：填写生活物联网平台提供的官方账号 homegraph@aliyun-iot.iam.gserviceaccount.com
角色：搜索 Service Account Toke Creator
完成后保存。
保存后，配置完成。
4. 语音控制
完成配置后，您就可以使用Alexa 控制您自有APP的设备了，请根据以下步骤尝试语音控制：
1、准备一台Google Home音箱，下载 Google Home（或 Google Assistant）客户端并安装绑定您的音箱。
（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.”（灯色温调节）
5. 正式发布你的Google Action
完成开发后，你就可以发布你的Google Action了！
注意：根据Google Actions的官方要求，提交Action的发布信息后，需要根据引导将真实设备邮寄提供给Google Actions，Google的审核人员进行测试使用后，才会发布你的Action。