智能家居接入谷歌home/assistant/智能音箱
接入流程
登录谷歌cloud,创建并设置项目
1、登录谷歌cloud
2、创建项目
3、设置项目OAuth2.0鉴权凭证
创建客户端凭证
填写客户端名称(客户端密钥只在首次创建成功页面可以下载,记得下载)
登录开发者控制台,云到云设置
1、登录谷歌开发者控制台Developer
2、添加在google cloud创建的项目
3、云对云设置
云到云–>开发–>创建集成项目
集成名称 :必填
设备类型:必选,选择需要接入的设备类型
应用图标:比上传,分辨率144 x 144 像素
OAuth 客户端 ID :谷歌cloud创建项目客户端凭证的客户端id
客户端密钥:谷歌cloud创建项目客户端凭证的客户端密钥
授权网址:谷歌账号跟halo用户账号关联时,谷歌home App跳转到halo用户授权登录页(如:halo授权登录页,登录成功后就可以访问halo app接口相关接口)
令牌网址:用户刷新halo授权token
云端执行网址:谷歌home执行
sync、query、execute、disconnect意图的入口
halo服务实现OAuth2鉴权
实现OAuth2.0服务器谷歌官方文档
1、在授权代码流程中,需要两个端点
授权端点,用于向尚未登录的用户显示登录界面。授权端点还会创建一个短期授权代码,用于记录用户对所请求访问权限的同意情况。
令牌交换端点,负责处理两种类型的交换:
使用授权代码换取长期刷新令牌和短期访问令牌。当用户完成账号关联流程时,系统会进行此交换。
用长期有效的刷新令牌换取短期有效的访问令牌。 当 Google 需要新的访问令牌(因为之前的令牌已过期)时,就会发生此交换。
2、注意点
在处理授权请求文档中提到,用户从谷歌home App --> 跳转到halo 授权登录页 --> 用户输入halo账号密码 --> 登录 --> 重定向用户浏览器
从文档描述来看,好像是我们接口要重定向,其实,我们授权端点接口只需返回code即可,无需将用户浏览器重定向,返回code后,谷歌会自动处理跳转问题。
{"code":200,"data":{"code":"ad4f10becfe24354a32e504e62b02087"}}实现意图
我们halo服务需要实现谷歌home的sync、query、execute、disconnect意图,详细查看官方文档实现意图。
控制设备:谷歌home --> 谷歌云 --> halo云平台 --> 处理意图(属性转换、控制设备)–> 意图处理结果返回谷歌云 --> 谷歌云返回给谷歌home
主要工作量:
执行意图:谷歌云–>halo云,需要把谷歌云设备类型、设备特性(属性)转换为halo云设备类型、设备特性(属性)
返回意图:halo云–>谷歌云,需要把halo云设备类型、设备特性(属性)转换为姑姑云设备类型、设备特性(属性)
对接属性转换的时候,光看设备属性文档,是很难知道某设备某型号某属性值是什么,值需不需要进行转换数据之类的(比如色温灯的开/关、亮度、色温值属性id分别是什么,值是什么类型),**如何快速高效对接属性:**设备上电重置接入网关–>根据设备id查看该设备属性表device_attrs有哪些属性和值–>MQTTX订阅该网关上/下行消息–>在halo App控制设备–>查看MQTTX订阅消息+设备属性表属性值变化–>快速定位属性和属性值(如设置色温,MQTTX发送什么属性消息给网关,根据该属性id查询属性表该属性值的变化)
例如:设置D628-ZG设备色温,MQTTX订阅可以看到下发给网关的数据,其中属性id:ColTempMir,val:307,根据设备id查找属性表,属性id和值能对应上的,从而快速定位调整色温的属性id和值类型,不用在设备属性文档中低效来回往返查找还不确定是不是这个属性
部署服务
当我们halo云实现了OAuth2.0+意图后,把服务部署到服务器,需要外网能访问,且是https,通过postman或apifox测试接口,没问题接着就是集成测试,测试谷歌home能否控制设备
测试
1、添加测试用户
测试用户添加登录谷歌cloud的账号(我添加其他谷歌账号A,测试时候在谷歌home登录A账号中找不到hzc-halo-dev100项目,不清楚具体什么原因,添加登录谷歌cloud的账号到测试用户组,在谷歌home中也登录谷歌cloud账号,就能找到项目)
2、安装谷歌应用
一台安卓手机,需要连接翻墙网络,安装谷歌play、谷歌浏览器、谷歌home、谷歌assistant助理
3、谷歌home登录谷歌账号
谷歌home登录谷歌账号(账号必须跟登录谷歌cloud创建项目的账号相同且账号已添加到测试用户组中)
4、谷歌home关联应用
谷歌home关联在谷歌cloud创建的项目hzc-halo-dev,同步设备列表、控制设备
5、谷歌Assistant助理App控制设备
手机安装谷歌助理App–>打开谷歌App对谷歌助理进行常规设置–>打开谷歌助理App–>语音或者文字输入–>控制设备
6、谷歌智能音箱控制设备
重置谷歌智能音箱–>谷歌home绑定音箱–>绑定成功–>ok goole唤醒智能音箱–>打开灯–>智能音箱播报执行结果
谷歌home绑定谷歌智能音箱类似于国内智能音箱绑定操作,如米家app绑定小爱智能音箱、天猫精灵app绑定天猫精灵
