【插件】智能音箱接入Home Assistant整合

您所在的位置:网站首页 叮咚音响怎么连接网络 【插件】智能音箱接入Home Assistant整合

【插件】智能音箱接入Home Assistant整合

2024-07-06 23:25| 来源: 网络整理| 查看: 265

前情回顾:年前折腾的通用智能音箱接入平台因音箱技能类型限制不过审翻车了,然后将项目成果整理做了个智能音箱mqtt代理转发插件。考虑到易用性,趁着过年闲着,于是折腾了下各个平台的智能家居类型技能对接,最终成果就是这么一个整合版插件了。

0.更新

新版本插件已发布并更名为havcs(传送门),主要变更了设备配置方式,其它部分内容基本仍适用,建议先粗略观看完此版本内容再移步观看新版本。

1.插件说明

本插件实际上由两大功能模块组成:

MQTT对接服务

配合本人搭建的mqtt中转服务,可以将音箱云平台的音箱命令消息、oauth消息转发到无公网环境下家中的Home Assistant。

音箱组件

即智能音箱本地网关插件,对音箱云平台的音箱命令消息进行解析、处理,可以初始化为HTTP网关服务与音箱云平台直接对接。

有三种使用模式,适合不同场景的接入:

模式一 http模式

生成音箱http网关,通过自建测试技能接入 适合家庭宽带有公网ip或已实现内网穿透场景下使用 建议有条件都用这个,留服务资源给有需要的人

模式二 http proxy模式

生成音箱http网关,同时使用mqtt代理穿透内网访问,通过自建测试技能接入 适合家庭宽带无公网ip场景下使用 临时提供,视服务资源情况会停止

模式三 skill模式

通过官方音箱APP技能接入,目前技能已暂未上线 (也许没法上线) 适合无公网、省事场景使用 服务资源有限不能保证稳定

各模式难度指数

模式一:★★★★☆

模式二:★★☆☆☆

模式三:★☆☆☆☆

配置方法

不同模式的配置方法见3.3HA插件配置章节。

智能音箱组件说明

天猫精灵插件基于瀚思彼岸论坛@feversky的插件修改 小度音箱插件基于瀚思彼岸论坛@zhkufish的插件修改 叮咚音箱插件参考前两个插件编写

aihomeHAVCS线上服务劝退警告

aihomeHAVCS线上服务(指模式二、三的mqtt中转服务及APP技能)可以实现叮咚音箱、天猫精灵、小度音箱接入Home Assistant(免公网IP),语音控制家中设备。线上服务主要目的在于测试、学习、交流,受限于个人能力,无法保证提供完善服务,并且使用线上服务有一定的风险,介意者建议另行部署自用的环境对接智能音箱平台。 隐私安全 为解决无公网IP的家庭宽带环境下使用的痛点,线上服务采用mqtt中转的技术方案,该方案下控制消息需经个人服务器转发,存在被本人监控、冒充控制消息的风险。 mqtt中转模式下已采用了消息隔离、消息加密、设备entity_id加密等方式对用户的控制消息进行安全保障,但仍可能存在本人没考虑全面的安全风险。 服务质量 只能尽个人最大能力保证,毕竟存在不可抗力自然因素、断电、断网、服务器宕机、本人偷懒等诸多不可控风险。 如果不幸本人跑路,因为相关设备信息(设备个性化配置)只保留在本地,你仍可以自行部署自用环境对接智能音箱平台继续使用。 服务支持 本服务实质上只提供便捷接入途径,后续仍要对设备信息进行个性化配置,需要对各家音箱平台的控制指令有一定了解。 使用本服务上手有一定难度,建议心平气和慢慢熟悉,遇到问题可加QQ群寻求帮助。 因个人时间有限,只侧重支撑解决使用mqtt中转服务和使用插件遇到的问题;部署自用环境对接方面问题请自行查阅厂家技能开放平台文档。 2.完成度

控制指令

灯、开关类型设备的开/关(小度音箱可延时) 电源状态、温度、湿度等状态查询

支持指令

能用的控制指令实际上与各智能音箱组件对音箱平台预设功能指令的支持度有关,因各个音箱平台有差异,无法一一描述,只能先列举叮咚音箱组件下目前个人已测试的功能。

平台适配进展

天猫精灵:支持,音箱APP已上线技能(“aihome智能HAVCS”) 小度:支持,音箱APP已上线技能(“aihomeHAVCS”) 叮咚:支持,音箱APP已上线技能(“aihomeHAVCS”) echo:看情况(等支持中文。。。) 小爱:计划外(手持身份证验证+商用要求劝退) 有其它音箱接入需求可以反馈我研究下

高能提醒

设备配置各个音箱平台会有一些出入,需要一定耐心熟悉上手 多用户使用场景没有条件测试,估计有不少bug 多用户并发下服务器处理性能及带宽可能有瓶颈问题 3.使用说明3.0.准备 下载插件:aihome(新版本插件名称已更名为havcs,旧版本在github项目release页面下载) 确认采取哪种模式接入 3.1.获取账号

注:模式一跳过此步骤

打开账号获取页面,获取AppKey和AppSecret

注册

模式三需要注册用户登陆;模式二可以不登陆(暂时)。

3.2.音箱技能平台配置

注:模式三跳过此步骤启用模式一或模式二,会生成服务网关(不分音箱平台),访问uri为/aihome_service。

模式一1234567891011#前往厂家的音箱技能平台进行设置#授权地址https://{你的域名}/auth/authorize#Client_Id,回调地址域名那一串即可小度:https://xiaodu.baidu.com天猫:https://open.bot.tmall.com#Token地址https://{你的域名}/aihome_auth#WebService(服务网关)地址https://{你的域名}/aihome_service

注意

需要自己解决域名访问问题,建议观看天猫精灵、小度音箱原版插件的教程。

模式二1234567891011#前往厂家的音箱技能平台进行设置#授权地址(授权操作只能使用本地电脑)https://{本地HA访问地址}/auth/authorize#Client_Id,回调地址域名那一串即可小度:https://xiaodu.baidu.com天猫:https://open.bot.tmall.com#Token地址(代理地址)https://ai-home.ljr.im/h2m2h/{app_key}/aihome_auth#WebService(服务网关)地址(代理地址)https://ai-home.ljr.im/h2m2h/{app_key}/aihome_service

注意

{本地HA访问地址}、{app_key}替换成相应的字符串。

目前叮咚技能需要联系工作人员审核后才能绑定到指定音箱,另外client_id格式不能填写"https://"(HA的oauth格式要求),需要自行修改HA对应组件代码解决。

3.3.HA插件配置12345678910111213141516171819202122232425#{HA配置目录}/configuration.yaml aihome: # 启用音箱平台,至少启用一个 platform: - aligenie # 天猫精灵 - dueros # 小度 - jdwhale # 叮咚 # http服务网关,>>模式一、模式二启用模式二启用模式三启用


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3