-
一个适用于 Yunzai 系列机器人框架 的米家插件,在任何地方控制家中米家生态设备
-
用奇怪的方式,让你在聊天框中控制米家设备,或者让群友控制你的米家设备(雾)
-
使用中遇到问题请加 QQ 群咨询:707331865
Tip
最近把家里的一些家具接入了米家,我也能享受智能家庭啦!闲的没事找了下米家的 API,就写了这个插件。(其实也没太大用处对叭)
git clone https://github.com/CikeyQi/mijia-plugin.git ./plugins/mijia-plugin
Note
如果你的网络环境较差,无法连接到 Github,可以使用 GitHub Proxy 提供的文件代理加速下载服务
git clone https://mirror.ghproxy.com/https://github.com/CikeyQi/mijia-plugin.git ./plugins/mijia-plugin
pnpm install --filter=mijia-plugin
Caution
本插件已兼容 Guoba-plugin ,你可以在锅巴插件中设置允许他人查看/控制你的智能设备,但这是很危险的操作,我们默认关闭了非主人控制,我们非常不建议你打开它。如果你误操作导致任何财产损失,我们概不负责!
登录小米账号
安装插件后,发送 #米家登录
或者 #米家扫码登录
,根据提示登录即可
自己写适配器
🌟 由于米家设备数量大,种类复杂,作者无法做到全部适配,但是写适配器非常简单,所以建议自己配置,如果看完本教程实在是不会可以加群 707331865 或者在 issue 留下你的设备型号,我会尽量给大家适配
适配器文件保存在插件根目录下的 /adapter 文件夹,适配器文件的文件名为设备型号(可发送 #米家设备 查看你所拥有的设备型号),一个型号对应一个适配器
接下来打开网站 小米/米家产品库,在搜索框直接搜索设备型号,找到自己的设备型号,点击 规格,选择最新的 released,进入开发文档
看到图中,SIID 是功能分类 ID,里面有很多设备属性 ID,就是 PIID,一个 SIID 加上一个 PIID 即可定位到一个属性,可以看到图中,当 SIID 为 2,PIID 为 1 时,控制的就是灯的开关
以下是插件自带的适配器示例 yeelink.light.lamp1.yaml,actionable 部分是 写,viewable 部分是 读
actionable: # 权限"写"接口
- name: ["开关"] # 操作名称
desc: "台灯开关,可用值:开、关" # 操作描述与值范围提示,操作设备时会提示
siid: 2 # 功能分类ID
piid: 1 # 设备属性ID
value_regexp: '/(开|关)/g' # 值的正则表达式,避免用户传入不符合规范的值
- name: ["亮度"]
desc: "调整台灯亮度,可用值:1-100"
siid: 2
piid: 2
value_regexp: '/([1-9]|[1-9][0-9]|100)/g'
- name: ["色温"]
desc: "调整台灯色温,可用值:2700-6500"
siid: 2
piid: 3
value_regexp: '/(27[0-9]{2}|6[0-4][0-9]{2}|6500)/g'
- name: ["模式"]
desc: "调整台灯模式,可用值:0 - 阅读 / 1 - 计算机 / 2 - 夜读 / 3 - 防蓝光 / 4 - 有效工作 / 5 - 蜡烛 / 6 - 闪烁"
siid: 2
piid: 4
value_regexp: '/(0|1|2|3|4|5|6)/g'
viewable: # 权限"读"接口
- name: '灯泡状态' # 展示名称
siid: 2 # 功能分类ID
piid: 1 # 设备属性ID
unit: '' # 值的单位,可不填
- name: '灯泡亮度'
siid: 2
piid: 2
unit: '%'
- name: '灯泡色温'
siid: 2
piid: 3
unit: 'K'
开
与 关
对应值 true
与 false
,已经做了内置处理,其他的值需要完全对应产品库中的值
如何控制设备
以操作 台灯 为例,使用命令 #米家台灯状态 即可查看台灯状态。使用 #米家控制台灯 即可控制台灯,修改相关值。使用 #米家设备 即可列出所有设备
- 密码 / 扫码的登陆
- 查看设备状态
- 控制设备
- 查看房间
- 插件安全吗?
- 插件只与米家 API 交互,插件本身不会收集你任何信息也不会主动控制你的设备
- 不确保插件被滥用,建议使用时小心谨慎,不要被有心群友使用
如果你喜欢这个项目,请不妨点个 Star🌟,这是对开发者最大的动力, 当然,你可以对我 爱发电 赞助,呜咪~❤️
有意见或者建议也欢迎提交 Issues 和 Pull requests。
本项目使用 GNU AGPLv3 作为开源许可证。