本文档介绍如何接入Google Home语音平台,并配置指令映射来实现指令的完整执行。
Google Home
Google三方语音接入主要由两部分组成:
1、通过在Google控制台和飞燕平台的配置将账户接入;
2、通过配置指令映射来实现指令的完整执行。
Google三方语音接入配置流程图(建议参考流程图来进行配置,流程具体节点内容可在文档中查阅):
一、厂商账号/资源准备
google控制台账号:https://console.actions.google.com/
控制台前期准备:参考文档 自有App定制Google Assistant技能(购买并开通Google Assistant服务)。
飞燕控制台申请的appKey:android
、ios
。
app英文名:厂商app英文名如Cloud Intelligent
。
app icon图标链接:矢量图,需提供图标URL链接,如无法提供请联系阿里同学--同alexa icon图标。
厂商三方账号:厂商app的登录账号、密码,在测试阶段需要关联google home测试,厂商提供的账号需要绑定设备用于测试。
二、console控制台填写
1、创建项目
单击Start Building,完成项目创建。
2、项目基本信息填写
选择Develop
页签:
(1)Invocation:填写项目名称,如Cloud Intelligent
。
(2)Actions:
Fulfillment URL 填写: https://open-living.iot.aliyun.com/one/voice/interaction/support/GoogleActions/v1
(3) Account linking: 填写clientId、client secret、Authorization RUL、Token RUL(和alexa一样参数填写)。
Use your app for account linking(optional)这个可以不填,直接点next。
Configure your client(optional),Scopes填一个自己的scope。
三、飞燕平台功能配置(请联系阿里同学完成)
填写完上述参数之后还需要联系阿里同学完成飞燕平台的功能配置
请提供上述"厂商账号/资源准备"中的内容以及google action的项目名(例如:smart-home-cdbc7)给阿里同学完成账号关联回调地址配置
1. 添加google账号关联的回调地址
请联系阿里同学进行配置。
2. 将aliyun-iot的服务账号添加到项目的IAM权限
如下图登录https://console.cloud.google.com/iam-admin/iam?project=XXXX (其中XXXX为项目名
将 homegraph@aliyun-iot.iam.gserviceaccount.com
这个阿里账号添加为授权账号角色为 Service Account Token Creator
3. 创建服务账号提交给阿里飞燕同学配置
如上图,在左边展示栏服务账号中,添加创建一个权限为 Service Account Token Creator 的服务账号,如 xxxx@********.iam.gserviceaccount.com将其交给飞燕同学配置。
四、购买并开通Google Assistant服务
详情请参见公版App使用Google Home音箱控制设备,如果是云智能App单击使用公版App控制产品并且开通Google Assistant服务,若是自有品牌App则只需开通Google Assistant服务即可。
五、联系阿里同学配置属性映射
联系阿里同学完成属性映射的配置。
六、测试验证
使用谷歌开发者账号登录GoogleHome App ,单击左上角+号,单击Add devices中添加“Smart Home”。找到按照文本创建的action,添加并使用自有品牌app的账号授权登录,获取自有品牌app账号下面的设备开始调试,操作步骤如下:
准备一台接入Link Living 国际站的设备,使用厂家自有品牌App,绑定该设备。
用户拥有一台Google Home音箱,下载 Google Home(或 Google Assistant)客户端并绑定该音箱。
在Google Home客户端中单击Home control,Add devices中添加“Smart Home”。
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."
七、生成Test Suite报告(提交审核的时候需要)
使用开发者账号登录GoogleHome(APP),绑定到自己app账号,然后同步自己有app账号下的设备。然后在进行Test suite。
入口链接:https://console.actions.google.com/project/smart-home-cdbc7/testsuite/
这里可以只勾选第一个(Test Request Sync),进行Test Run,保证所有google要求的case全部通过,才能生成结果文件。如下图(所有的case都跑通过):
如果有case没跑通过,要根据日志和提示排查原因,最终保证所有的case全部通过才能生成结果报告。
八、提交审核
1. 填写表单
按照google的要求提交表单,提交有问题,google会给反馈,然后修改。Test suite 的报告单,需要在提交表单的时候上传。
总共11页的表单,按照要求填写。
2. 发布提交审核
下面有审核状态,如果有问题,会邮件通知修改。