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 等迁移文档同步更新
This commit is contained in:
@@ -85,13 +85,13 @@ xiaomi/examples/
|
||||
**覆盖 API**:
|
||||
- `devices.Create(client, info)` 工厂 → `Switch`
|
||||
- `Switch.{TurnOn, TurnOff, Toggle, IsOn}(ctx)`
|
||||
- `Switch.OnStateChanged(handler)` 状态订阅
|
||||
- `Switch.OnPropsChanged(handler)` 状态订阅
|
||||
|
||||
**演示重点**:
|
||||
- 工厂创建单设备
|
||||
- TurnOn/TurnOff/Toggle 完整链路
|
||||
- IsOn 状态查询
|
||||
- OnStateChanged 回调演示
|
||||
- OnPropsChanged 回调演示
|
||||
|
||||
---
|
||||
|
||||
@@ -102,7 +102,7 @@ xiaomi/examples/
|
||||
- `Light.{SetBrightness, GetBrightness}(ctx, pct)`
|
||||
- `Light.{SetColorTemp, GetColorTemp}(ctx, kelvin)`
|
||||
- `Light.{SetColor, GetColor}(ctx, r, g, b)`
|
||||
- `Light.OnStateChanged(handler)`
|
||||
- `Light.OnPropsChanged(handler)`
|
||||
|
||||
**演示重点**:
|
||||
- 亮度 0-100 调节
|
||||
@@ -123,11 +123,11 @@ xiaomi/examples/
|
||||
- `SetTargetHumidity(ctx, pct)` / `GetTargetHumidity(ctx)` / `GetCurrentHumidity(ctx)`
|
||||
- `SetAuxHeat(ctx, on)` / `GetAuxHeat(ctx)`
|
||||
- `SetEco(ctx, on)` / `GetEco(ctx)`
|
||||
- `OnStateChanged(handler)` → `ACState`
|
||||
- `OnPropsChanged(handler)` → `ACState`
|
||||
|
||||
**演示重点**:
|
||||
- 完整空调控制链路(开→设制冷→设26°C→自动风速→垂直摆风)
|
||||
- OnStateChanged 实时状态回调
|
||||
- OnPropsChanged 实时状态回调
|
||||
- 不支持的功能优雅降级(如无湿度传感器,跳过湿度设置)
|
||||
|
||||
---
|
||||
@@ -281,7 +281,7 @@ func main() {
|
||||
|-------------------|---------|
|
||||
| 用户/家庭/房间信息(GetUserInfo / GetHomeList) | 01_user_home |
|
||||
| 设备列表 + Filter | 02_device_list |
|
||||
| Switch 控制 + OnStateChanged | 03_switch_control |
|
||||
| Switch 控制 + OnPropsChanged | 03_switch_control |
|
||||
| Light 控制 | 04_light_control |
|
||||
| AirConditioner 完整控制 | 05_ac_control |
|
||||
| Fan / Cover 控制 | 06_fan_cover |
|
||||
|
||||
Reference in New Issue
Block a user