米家空调 · 中文控制面板
约 1226 字大约 4 分钟
2026-11-12
这套面板面向已经通过米家云接入联犀的 xiaomi.aircondition.m9 空调。它使用现有产品的物模型,不创建新产品、不重命名米家字段,也不会改变产品 ID。

下载完整面板 ZIP(在新窗口打开) · 下载包版本与 SHA-256(在新窗口打开) · 米家接入教程
支持哪些能力
| 界面 | 米家物模型标识符 | 说明 |
|---|---|---|
| 电源 | air-conditioner_on | 显示设备实际上报的开关状态 |
| 设定温度 | air-conditioner_target-temperature | 当前型号为 16–31°C、0.5°C 步进;控制范围读取实际物模型 |
| 运行模式 | air-conditioner_mode | 数值 2/3/4/5 分别显示制冷、除湿、送风、制热 |
| 风机档位 | fan-control_fan-level | 数值 0 为自动,1–8 显示一级风至八级风 |
| 室温 / 湿度 | environment_temperature / environment_relative-humidity | 可选只读信息,字段缺失时隐藏 |
| 滤芯寿命 | filter2_filter-life-level | 可选,只展示实际值;具体含义以设备说明为准 |
| 上下摆风 | fan-control_vertical-swing | 可选,权限不足或离线时只读 |
中文模式与风速属于界面翻译。ZIP 中保留米家原始英文枚举标签,使绑定校验与真实模型一致。不要为了显示中文去改产品物模型的协议字段。
当前仅适配上述型号的这组能力;同样名为“米家空调”的其他型号,需要重新核对标识符、类型、单位、枚举及读写能力。Web 桌面和手机浏览器为本次验收范围,未验收原生 App。
导入与绑定
- 先按米家云教程授权账号,在已有产品 → 设备接入选择账号和型号,再同步设备。
- 在产品的物模型页确认已同步所需字段。面板 ZIP 中附带的是适配说明用模型,请勿覆盖已有产品的完整物模型。
- 进入设备接入 → 面板管理,点击导入面板,选择下载的 ZIP,填写名称并导入。
- 先用面板的查看 / 模拟检查中文文案与布局。模拟器不会调用米家设备,也不能证明真实空调可控。
- 在产品详情 → 设备面板选择自定义面板并保存。核对兼容性结果;不兼容时先比较物模型,不强行跳过检查。
- 打开该产品下的设备详情 → 设备面板,核对真实状态。设备自身的显式绑定优先于产品绑定,有旧覆盖时需先核对继承设置。
- 在允许控制设备的时间做一次小幅调温,核对回执与属性更新,再恢复原温度。
绑定只改变界面选择。原有产品 ID、设备归属、协议账号和物模型保持不变;需要撤回时,将产品面板恢复为之前的继承或系统面板设置。
怎样判断控制是否成功
“设置已受理”仅表示请求进入平台;“设备已确认,状态尚未同步”表示收到成功回执,但界面没有收到对应属性更新;收到匹配的新属性后才显示“设备已确认,状态已同步”。超时属于结果未知,面板不会自动重发。
即使回执与属性更新均成功,也不等同于现场有人确认了压缩机或风机的物理动作。现场动作需要另外核验。
验证记录
2026-11-12,在隔离 KVM 完成 ZIP 导入、与已有产品绑定、兼容性检查,以及真实设备详情页的桌面和手机布局检查。绑定前后产品 ID 与完整物模型保持不变;320px、393px 和桌面宽度均无横向溢出。截图为真实面板中的最近上报值,不是设备当前在线的证明。
本轮尝试把设定温度从 28°C 调至 28.5°C。平台接受了请求,但小米返回 -704042011(设备离线),面板显示执行失败;用户也确认设备离线。没有获得本轮成功控制回执和新属性上报,在线控制及恢复闭环仍待设备上线后复验。为保留原设置,截图后恢复了产品原面板绑定,新资产保留供后续复验。

小米官方集成也将这个错误码用于设备离线处理,参见官方实现。本次没有修改生产设备数据,也没有验证实体空调动作。
