【品牌APP】接入Google Assistant教程

更新时间:2019-01-07 18:44:50

*由于Google Home修改了对接的协议方案,我们正在准备重新提交申请,可能对您的调试和开发有所影响。您可以通过工单联系我们的技术支持人员,了解我们的进展。


厂家自有品牌App控制的设备,如果也希望被Google Home音箱控制,需要开发者自己去Google 开发者平台中创建一个Google Action,并和自己的品牌App进行对接开发。Google Assistant的对接是完全免费的,以下是开发者如何对接Google Assistant的教程:

1. 架构图

业务架构图:

image.png | left | 605x460

核心流程链路图:

image.png | left | 747x662

2. Smart Home Action开发流程

2.1 注册谷歌开发者账号

开发者需要前往谷歌开发者平台,注册一个亚马逊开发者账号。

2.2 创建Smart Home Action

console中,新建一个Project,并选择智能家居模板“Home Control”。

image.png | left | 747x445

image.png | left | 747x461

2.3 填写基本信息

根据以下步骤,完成Google Action信息的填写。

2.3.1 填写信息

给Action起一个用户便于搜索的名称,并填写Action的后端服务地址(和Amazon Alexa Skill要求一定要购买AWS Lambda不一样,Google Action不要求使用指定云产品;我们推荐阿里云的函数计算产品,搭配阿里云IoT使用,性能更佳)

image.png | left | 747x485

image.png | left | 747x477

2.3.2 Account Linking信息填写(oauth2.0协议

若使用平台内置账号体系,则由阿里云提供本步骤的信息。如果使用厂家自有账号体系,则有开发者自行完善该步骤信息。
若使用平台内置账号体系,请在平台-自有品牌APP-用户账号-查看对接信息,获取相关内容,如下图所示:

image | left

image | left

将平台中的信息复制到Google Action的如下字段中:

image.png | left | 747x531

2.4 购买函数计算产品,配置Smart Home Action后端服务代码

我们推荐阿里云函数计算搭配Api网关产品,搭配阿里云IoT使用,性能更佳。
示例脚本可以从飞燕产品的Google Assistant配置中获取(示例代码使用到的api)

2.4.1 创建函数计算服务和函数

image.png | left | 747x395

image.png | left | 747x417

2.4.2 配置函数

20180828192937.png | center | 747x416

image.png | left | 747x511

2.4.3 配置Api

image.png | left | 747x468

image.png | left | 747x467

image.png | left | 747x452

2.4.4 把配置好的api回填到google smart home action的后端服务

image.png | left | 747x477

2.5 下载Google Home App,调试Action

使用谷歌开发者账号登陆GoogleHome App,点击Home control,Add devices中添加“Smart Home”。找到按照文本创建的action,添加并使用自有品牌app的账号授权登陆,获取自有品牌app账号下面的设备开始调试
1、准备一台接入Link Living 国际站的设备,使用厂家自有品牌App,绑定该设备。

2、用户拥有一台Google Home音箱,下载 Google Home(或 Google Assistant)客户端并绑定该音箱。
(iOS用户请至美国区App Store搜索“Google Home”下载,Android客户请至Google Play搜索“Google Home”下载)

3、在Google Home客户端中点击Home control,Add devices中添加“Smart Home”。

image | left

4、输入您自有品牌品牌App登录的账号和密码,完成添加您的智能设备。(如果在您自己的App中修改了设备昵称,音箱必须重新发现设备,否则不能对设备进行控制)

5、完成以上步骤后,您可以通过下列指令控制您的设备了(如My Light):

  • "OK, Google, turn on/off my lights."

  • Dim smart lights: "OK, Google, dim my lights to fifty percent."

  • Change smart bulb colors: "OK, Google, turn my lights [color]."

  • Control August Smart Lock: "OK, Google, lock the front door."

  • Customize trigger phrases for IFTTT. For example: "OK, Google, let's get this party started."

2.6 正式发布你的Google Action

完成开发后,你就可以发布你的Google Action了!
注意:根据Google Actions的官方要求,提交Action的发布信息后,将真实设备邮寄提供给Google Actions,审核人员进行测试使用后,才会发布你的Action。

results matching ""

    No results matching ""