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:
@@ -503,7 +503,7 @@ type AirConditioner interface {
|
||||
GetEco(ctx context.Context) (bool, error)
|
||||
|
||||
// 订阅(不需要 ctx,订阅是本地注册操作)
|
||||
OnStateChanged(handler func(state ACState)) (subID string, err error)
|
||||
OnPropsChanged(handler func(state ACState)) (subID string, err error)
|
||||
}
|
||||
|
||||
// ACMode 空调模式
|
||||
@@ -581,7 +581,7 @@ type Light interface {
|
||||
SetColor(ctx context.Context, r, g, b int) error // 0-255
|
||||
GetColor(ctx context.Context) (r, g, b int, error)
|
||||
|
||||
OnStateChanged(handler func(state LightState)) (subID string, err error)
|
||||
OnPropsChanged(handler func(state LightState)) (subID string, err error)
|
||||
}
|
||||
|
||||
type LightState struct {
|
||||
@@ -606,7 +606,7 @@ type Switch interface {
|
||||
Toggle(ctx context.Context) error
|
||||
IsOn(ctx context.Context) (bool, error)
|
||||
|
||||
OnStateChanged(handler func(on bool)) (subID string, err error)
|
||||
OnPropsChanged(handler func(on bool)) (subID string, err error)
|
||||
}
|
||||
```
|
||||
|
||||
@@ -1059,7 +1059,7 @@ func main() {
|
||||
d.SetTargetTemp(ctx, 26)
|
||||
d.SetFanSpeed(ctx, devices.SpeedAuto)
|
||||
// 订阅状态变化
|
||||
d.OnStateChanged(func(state devices.ACState) {
|
||||
d.OnPropsChanged(func(state devices.ACState) {
|
||||
fmt.Printf("空调 %s: 模式=%s 温度=%.1f°C\n",
|
||||
dev.Name(), state.Mode, state.TargetTemp)
|
||||
})
|
||||
|
||||
@@ -32,7 +32,7 @@
|
||||
|
||||
**不修改的方法**(纯本地操作):
|
||||
- SubProp / UnsubProp / SubEvent / UnsubEvent / SubDeviceState / UnsubDeviceState
|
||||
- OnStateChanged
|
||||
- OnPropsChanged
|
||||
- NewClient / NewDevice 等工厂方法
|
||||
|
||||
---
|
||||
@@ -229,9 +229,9 @@ func (m *PropertyMapper) ToRaw(enum string) (interface{}, bool)
|
||||
|
||||
---
|
||||
|
||||
### #9 各设备接口 OnStateChanged 返回值不统一
|
||||
### #9 各设备接口 OnPropsChanged 返回值不统一
|
||||
|
||||
**问题**:OnStateChanged 返回 `(string, error)`,但 SubProp/SubEvent 返回 `(string, error)` — 这里它们是统一的。但缺少对 subID 语义的说明。
|
||||
**问题**:OnPropsChanged 返回 `(string, error)`,但 SubProp/SubEvent 返回 `(string, error)` — 这里它们是统一的。但缺少对 subID 语义的说明。
|
||||
|
||||
**修复方案**:注释统一说明 subID 是订阅标识符,可用于取消。
|
||||
|
||||
@@ -276,7 +276,7 @@ func (m *PropertyMapper) ToRaw(enum string) (interface{}, bool)
|
||||
| 5 | P1 | types.go | HomeInfo 加 CityID/Longitude/Latitude/Address |
|
||||
| 6 | P1 | client.go | Client 去掉 homes 缓存字段 |
|
||||
| 7 | P1 | specs/mapper.go(新) | PropertyMapper 双向值映射 |
|
||||
| 9 | P2 | devices/*.go | OnStateChanged 统一命名返回值 subID |
|
||||
| 9 | P2 | devices/*.go | OnPropsChanged 统一命名返回值 subID |
|
||||
| 11 | P2 | ARCH_PLAN.md 使用示例 | 更新为 ctx + factory + type switch 模式 |
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user