Files
xiaomihome/xiaomi/examples/05_ac_control/main.go
T
4566704 04333750ab feat: State→Props 命名统一 + 新增 Plug/Gateway 设备 + 分类系统重构
**命名统一(State → Props)**
- 所有设备类型:XxxState → XxxProps,GetState() → GetProps(),FetchState() → FetchProps()
- 回调接口:OnStateChanged → OnPropsChanged
- Bridge 层类型别名、示例代码、文档同步更名

**新增设备类型**
- KindPlug + Plug 驱动:智能插座/插头(TurnOn/TurnOff/IsOn/OnPropsChanged)
- KindGateway + Gateway 驱动:网关设备类型识别
- KindOccupancySensor 从 KindSensor 独立,添加 OccupancyProps

**设备分类系统改进**
- classifyByModel 改为按 key 长度降序匹配(防止 sensor 先于 sensor-occupy)
- 新增下划线变体识别(sensor_occupy、sensor_temp 等)
- outlet 重新归类为 Plug(非 Switch)
- 新增 Or() 组合过滤器

**连接桥增强**
- 设备创建成功后自动订阅属性变更
- 新增 nil 防护检查
- 支持 Plug/Speaker/Gateway/Occupancy 类型的 FetchProps 刷新
- 日志级别 Info → Debug

**AC 驱动增强**
- 新增 HasPower()、GetElectricPower()、GetPowerConsumption() 功率接口
- ACProps 新增 ElectricPower、PowerConsumption 字段
- valMapper:Desc 为空时 fallback 用 Name,key 统一小写

**MIoT 核心**
- 设备列表刷新改用 reflect.DeepEqual 全字段变更检测
- 移除 BLE/代理设备默认在线 hack
- RefreshDeviceAllProps 增加离线检查
- 新增 miot_errors.go:MIoT 错误码定义
- 全局日志级别 Info→Debug/Warn(降低噪音)

**示例与文档**
- 所有示例代码同步 API 变更
- 传感器示例改用 Or 组合过滤器
- ARCH_PLAN 等迁移文档同步更新
2026-08-05 17:54:08 +08:00

117 lines
3.4 KiB
Go

// Package main demonstrates full air conditioner control.
// 运行前提:已配置环境变量 XIAOMI_CLIENT_ID / XIAOMI_CLIENT_SECRET / XIAOMI_ACCESS_TOKEN。
package main
import (
"context"
"log"
"time"
"xiaomihome/xiaomi"
"xiaomihome/xiaomi/devices"
miotconfig "xiaomihome/miot/examples/config"
)
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
cfg, err := miotconfig.LoadConfig("../../../miot/examples/config.json")
if err != nil {
log.Fatal("请先运行 miot/examples/cloud_oauth 获取 token:", err)
}
client, err := xiaomi.NewClient(ctx, xiaomi.Config{
AuthInfo: xiaomi.AuthInfo{
AccessToken: cfg.AuthInfo.AccessToken,
RefreshToken: cfg.AuthInfo.RefreshToken,
ExpiresIn: int32(cfg.AuthInfo.ExpiresIn),
ExpiresTS: cfg.AuthInfo.ExpiresTS,
},
DataDir: "./data",
UUID: cfg.UUID,
UID: cfg.UID,
})
if err != nil {
log.Fatal(err)
}
defer client.Close()
const targetDID = "2053225728"
info, err := client.GetDevice(ctx, targetDID)
if err != nil {
log.Fatalf("获取设备 %s 失败: %v", targetDID, err)
}
ac, err := devices.NewAirConditioner(client, info)
if err != nil {
log.Fatalf("创建 AirConditioner 失败: %v", err)
}
log.Printf("空调: %s (DID: %s, 型号: %s)", info.Name, info.DID, info.Model)
on, _ := ac.IsOn(ctx)
modeName, _ := ac.GetMode(ctx)
targetTemp, _ := ac.GetTargetTemp(ctx)
currentTemp, _ := ac.GetCurrentTemp(ctx)
fanName, _ := ac.GetFanSpeed(ctx)
swingName, _ := ac.GetSwing(ctx)
log.Printf("当前状态: on=%v mode=%s target=%.1f current=%.1f fan=%s swing=%s",
on, modeName, targetTemp, currentTemp, fanName, swingName)
log.Println("=== 执行控制: 开 -> 制冷 -> 26度 -> 自动风速 -> 垂直摆风 ===")
if !on {
log.Println(" 开启空调...")
ac.TurnOn(ctx)
time.Sleep(500 * time.Millisecond)
}
log.Println(" 设置制冷模式...")
ac.SetMode(ctx, devices.ACModeCool)
log.Println(" 设置目标温度 26度...")
ac.SetTargetTemp(ctx, 26.0)
log.Println(" 设置自动风速...")
ac.SetFanSpeed(ctx, devices.ACFanAuto)
log.Println(" 设置垂直摆风...")
ac.SetSwing(ctx, devices.ACSwingVertical)
time.Sleep(1 * time.Second)
modeName, _ = ac.GetMode(ctx)
targetTemp, _ = ac.GetTargetTemp(ctx)
currentTemp, _ = ac.GetCurrentTemp(ctx)
fanName, _ = ac.GetFanSpeed(ctx)
swingName, _ = ac.GetSwing(ctx)
log.Printf("更新后状态: mode=%s target=%.1f current=%.1f fan=%s swing=%s",
modeName, targetTemp, currentTemp, fanName, swingName)
log.Println("设置目标湿度 50...")
if err := ac.SetTargetHumidity(ctx, 50); err != nil {
log.Printf(" 设置湿度失败(可能不支持): %v", err)
} else {
humidity, _ := ac.GetTargetHumidity(ctx)
curHumidity, _ := ac.GetCurrentHumidity(ctx)
log.Printf(" 湿度: target=%d current=%d", humidity, curHumidity)
}
log.Println("关闭电辅热...")
ac.SetAuxHeat(ctx, false)
log.Println("开启节能模式...")
ac.SetEco(ctx, true)
subID, err := ac.OnPropsChanged(func(props devices.ACProps, changed string) {
log.Printf("空调状态变化: %s → on=%v mode=%s target=%.1f current=%.1f fan=%s swing=%s",
changed, props.On, props.Mode, props.TargetTemperature, props.Temperature,
props.FanLevel, props.Swing)
})
if err != nil {
log.Printf("订阅状态失败: %v", err)
} else {
log.Printf("已订阅空调状态: subID=%s", subID)
}
log.Println("空调控制演示完毕")
}