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账号下面的设备开始调试，操作步骤如下：

1. 准备一台接入Link Living 国际站的设备，使用厂家自有品牌App，绑定该设备。

2. 用户拥有一台Google Home音箱，下载 Google Home（或 Google Assistant）客户端并绑定该音箱。

3. 在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. 发布提交审核

下面有审核状态，如果有问题，会邮件通知修改。