- Notifications
You must be signed in to change notification settings - Fork5
CikeyQi/mijia-plugin
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
一个适用于Yunzai 系列机器人框架 的米家插件，在任何地方控制家中米家生态设备
用奇怪的方式，让你在聊天框中控制米家设备，或者让群友控制你的米家设备（雾）
使用中遇到问题请加 QQ 群咨询：707331865
Tip
最近把家里的一些家具接入了米家，我也能享受智能家庭啦！闲的没事找了下米家的 API，就写了这个插件。（其实也没太大用处对叭）
git clone https://github.com/CikeyQi/mijia-plugin.git ./plugins/mijia-pluginNote
如果你的网络环境较差，无法连接到 Github，可以使用GitHub Proxy 提供的文件代理加速下载服务
git clone https://ghfast.top/https://github.com/CikeyQi/mijia-plugin.git ./plugins/mijia-pluginpnpm install --filter=mijia-pluginCaution
本插件已兼容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 作为开源许可证。
About
基于 Yunzai 的小米智能家居控制插件