HAGenie - 小爱音箱自定义技能一键批量接入HomeAssistant控制

Yonsm · 发表于 2018-8-28 18:33:12

本帖最后由 Yonsm 于 2018-8-31 22:02 编辑

一、使用方法
和之前 HAGenie 接入天猫精灵一样，不需要搭建任何服务器，HAGenie 网关可以批量驳接所有 HomeAssistant 的设备到由小爱音箱的自定义控制。但和天猫精灵有个区别，小爱智能通过唤醒词来使用，假设唤醒词为“精灵”，如：“小爱同学，[用][精灵][打开][客厅灯]”，说明如下：

1. 用：红色部分是前导助词，可以是“让、用、把、将、问、请、叫”等词语；
2. 精灵：绿色部分是唤醒词，每个人都不一样，大家想一个自己的，顺口且容易识别的；
3. 打开：蓝色部分是意图动词，目前支持打开/开；关闭/关、查询/查三个意图，具体说法也可以自己配置；
4. 客厅灯：紫色部分是HomeAssistant 里面的 friendly_name，支持group名（类别名或房间名，如关闭所有开关，打开客厅）。小爱和天猫精灵不一样是开放的，支持所有自定义名称（但要容易识别）。

另外还有一种用法：“小爱同学，[打开/进入][精灵]”，然后再说指令，比较曲折，不再举例。之前坛里网友（就是唤醒词举例为水滴的那位兄台，感谢前期思路）以为只能直接查询，实际证明是错误的，没有理解和正确配置意图、槽位功能，小爱是可以直接用前导唤醒词一句话处理打开/关闭和其它自定义意图的。

二、配置方法

1. 注册小爱音箱开发者帐号，需要手持身份证拍照，精力门槛不低，不想折腾就不要去搞了，一天左右可以审批，通过后在这里创建新技能：
FireShot Capture 27 - 小爱开放平台-为开发者提供一站式人工智能服务 - https___xiao.png

FireShot Capture 27 - 小爱开放平台-为开发者提供一站式人工智能服务 - https___xiao.png

2. 选择“自定义技能”：
FireShot Capture 28 - 小爱开放平台-为开发者提供一站式人工智能服务 - https___xiao.png

3. 支持设备选择“音箱”、“调用名称”就是唤醒词，特别重要，后面靠这个词唤醒：
FireShot Capture 29 - 小爱开放平台-为开发者提供一站式人工智能服务_ - https___xia.png

4. 添加意图，注意添加三个意图“open”、“close”、“query”：
FireShot Capture 30 - 小爱开放平台-为开发者提供一站式人工智能服务_ - https___xia.png

5. 为上述意图填写语料和槽位，注意上述三个意图都要设置：
FireShot Capture 31 - 小爱开放平台-为开发者提供一站式人工智能服务_ - https___xia.png

6. 填写网关服务器：
FireShot Capture 32 - 小爱开放平台-为开发者提供一站式人工智能服务_ - https___xia.png

https://g.yonsm.net:8122/miai.py?https_xx.xxx.xxx_8123_password

注意：1. https://g.yonsm.net:8122/miai.py这部分可以直接原样用我的（或者自己搭建服务器，参考后文）；
2. https_xx.xxx.xxx_8123_password 换成你自己的 HA 地址，且必须是公网能调用的地址，可以是 HTTP/HTTPS，没有密码可以省略最后一部分；
3. 可以在问号之后把你的调用名称/唤醒词做 url encoding后传入给HAGenie，这样HAGenie可以用自己的做意图分析。如下：

https://g.yonsm.net:8122/miai.py?%e7%b1%b3%e5%ae%b6_https_xxx.xxx.xxx_8123

传入了唤醒词（假设为“皇宫”）的情况下，还可以这么说：““小爱同学，[把/用/请/等等][皇宫][客厅灯][打开/关闭/关掉/关上]””

以上配置后直接可以把小爱和 HA 批量驳接起来了，对了，使用之前，还需要对小爱音箱说一声“小爱同学，进入开发者模式”，然后其它使用方式如上文所述。

三、使用自己的服务器（可选）

注意：以上配置理把所有密码发往我的服务器，如果简单测试可以这么玩玩，如果要长期用建议自己搭建服务器，所有代码在这里，目前不到200行，比之前的网游写得好，哈哈，持续更新完善中：

https://github.com/Yonsm/HAExtra/tree/master/hagenie

1. 服务器环境：其中三个 py 文件即可以在 apache 的 cgi-bin 下跑；也可以用 hagenie.py 作为服务器运行（需要完整的 server.pem，记住是需要 chain.pem cert.pem privkey.pem 合一），hagenie.py可以在树莓派上跑，但响应比较慢控制起来了比较慢也不爽。

2. Python 需求：以上支持 python2 或 python3，自动适应；如果 HA 是 https 的需要安装 requests，否则自动使用 urllib 或 urllib2。