Files
xiaomihome/xiaomi/examples/14_business_scenario/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

186 lines
4.8 KiB
Go

// 示例 14:多用户业务场景
//
// 场景:管理后台控制空调 → 状态变化 → 存数据库 → 推 WebSocket
// 核心展示 bridge.Pool 用法,DB/WS 只是桩方法。
package main
import (
"context"
"encoding/json"
"fmt"
"log"
"os"
"os/signal"
"time"
"xiaomihome/bridge"
"xiaomihome/xiaomi"
"xiaomihome/xiaomi/devices"
)
// ── 业务桩方法:type-switch 拿到类型化字段(类型来自 bridge 包) ──
func saveToDB(id int64, did, deviceType, changed string, state interface{}) {
// 用 devices 包的常量判断变更字段,deviceType 区分设备类型
var propLabel string
switch changed {
case devices.PropTargetTemperature:
propLabel = "目标温度"
case devices.PropTemperature:
propLabel = "当前温度"
case devices.PropBrightness:
propLabel = "亮度"
default:
propLabel = changed
}
if propLabel != "" {
log.Printf("[DB] %s changed=%s(%s)", did, propLabel, changed)
}
// 同类化 state 拿到完整 State 结构体
switch s := state.(type) {
case bridge.ACProps:
log.Printf("[DB] 空调 %d/%s changed=%s: on=%v mode=%s target=%.1f current=%.1f",
id, did, changed, s.On, s.Mode, s.TargetTemperature, s.Temperature)
case bridge.LightProps:
log.Printf("[DB] 灯 %d/%s changed=%s: on=%v brightness=%d colorTemp=%d",
id, did, changed, s.On, s.Brightness, s.ColorTemperature)
default:
log.Printf("[DB] %d/%s changed=%s: %+v", id, did, changed, s)
}
}
func pushWS(id int64, did, deviceType, changed string, state interface{}) {
switch s := state.(type) {
case bridge.ACProps:
log.Printf("[WS→%d] 空调 %s changed=%s: on=%v mode=%s target=%.1f current=%.1f",
id, did, changed, s.On, s.Mode, s.TargetTemperature, s.Temperature)
case bridge.LightProps:
log.Printf("[WS→%d] 灯 %s changed=%s: on=%v brightness=%d",
id, did, changed, s.On, s.Brightness)
default:
log.Printf("[WS→%d] %s changed=%s: %+v", id, did, changed, s)
}
}
// ── 用户配置 ──
type UserCfg struct {
UID int64 `json:"uid,string"`
UUID string `json:"uuid"`
Auth xiaomi.AuthInfo `json:"auth"`
DataDir string `json:"data_dir"`
HomeIDs []int64 `json:"home_ids,omitempty"`
}
func loadUsers(path string) ([]UserCfg, error) {
data, _ := os.ReadFile(path)
var users []UserCfg
if err := json.Unmarshal(data, &users); err != nil {
return nil, err
}
return users, nil
}
// ── 业务初始化 ──
func initBridge(ctx context.Context, pool *bridge.Pool, cfg UserCfg) error {
b, err := pool.Add(ctx, cfg.UID, cfg.UUID, cfg.Auth, cfg.DataDir, cfg.HomeIDs)
if err != nil {
return err
}
// 注册回调:MQTT 推送 → DB + WS
b.OnPropsChanged(func(id int64, did, deviceType, changed string, state interface{}) {
saveToDB(id, did, deviceType, changed, state)
pushWS(id, did, deviceType, changed, state)
})
b.StartReceiving()
log.Printf("[Init] %d: %d 台设备", cfg.UID, len(b.Devices()))
return nil
}
// ── 业务操作 ──
func controlAC(ctx context.Context, pool *bridge.Pool, id int64, did string) error {
b, ok := pool.Get(id)
if !ok {
return fmt.Errorf("id %d 不存在", id)
}
ac, err := b.AC(did)
if err != nil {
return err
}
// 读缓存
state := ac.GetProps()
fmt.Printf("\n空调 %s:", did)
fmt.Printf(" on=%v mode=%s target=%.1f current=%.1f\n",
state.On, state.Mode, state.TargetTemperature, state.Temperature)
// 云端刷新
if s, err := ac.FetchProps(ctx); err == nil {
fmt.Printf(" 云端: on=%v mode=%s target=%.1f current=%.1f\n",
s.On, s.Mode, s.TargetTemperature, s.Temperature)
}
// 控制
fmt.Println("\n管理后台操作:开机制冷 26°C")
ac.TurnOn(ctx)
time.Sleep(300 * time.Millisecond)
ac.SetMode(ctx, devices.ACModeCool)
ac.SetTargetTemp(ctx, 26)
time.Sleep(1 * time.Second)
// 最终状态
final := ac.GetProps()
fmt.Printf("操作后: on=%v mode=%s target=%.1f current=%.1f\n",
final.On, final.Mode, final.TargetTemperature, final.Temperature)
return nil
}
// ── 主流程 ──
func main() {
allUsers, err := loadUsers("users.json")
if err != nil || len(allUsers) == 0 {
log.Fatalf("请创建 users.json: %v", err)
}
ctx := context.Background()
pool := bridge.NewPool()
for _, u := range allUsers {
if err := initBridge(ctx, pool, u); err != nil {
log.Printf("id %d 失败: %v", u.UID, err)
}
}
log.Printf("\n%d 个就绪\n", len(allUsers))
// 找第一台空调演示
id := allUsers[0].UID
b, ok := pool.Get(id)
if !ok || b == nil {
log.Fatal("没有设备初始化成功")
}
var targetDID string
for did, typ := range b.Devices() {
if typ == "air_conditioner" {
targetDID = did
break
}
}
if targetDID != "" {
controlAC(ctx, pool, id, targetDID)
}
fmt.Println("\nCtrl+C 退出...")
ch := make(chan os.Signal, 1)
signal.Notify(ch, os.Interrupt)
<-ch
}