很多开发者接入鸿蒙智联,上来就写代码,结果后面返工。正确的第一步是产品定义:你的设备是什么类型、有哪些功能、怎么被控制。设备模型想清楚,开发才有方向。
产品类型
在开发者平台创建产品时,先从标准类型里选:灯、插座、窗帘、空调、传感器、摄像头……平台维护了一套标准产品库,选对类型能继承大部分默认配置。
标准库没有的类型,可以创建自定义类型,但要确保协议符合规范。

功能属性
每个设备由一组功能属性描述:开关(布尔)、亮度(数值+范围)、模式(枚举)、状态(只读上报)。属性定义影响 App 端显示和控制方式。
功能定义三原则:够用(满足核心场景)、标准(优先用标准属性)、可扩展(为后续版本预留)。别堆砌用不上的功能。
服务与联动
设备不只是“被控制”,还要“参与场景”:作为执行器(开灯)、作为触发器(传感器检测到人)。定义时考虑设备在场景中的角色。
联动场景要测试:多设备联动、定时任务、条件触发,确保状态同步准确。

命名与文案
设备名称、功能名称、提示文案,用户会在 App 和语音里看到听到:命名要直观(“卧室灯”而不是“LED_LIGHT_01”),文案要友好(“正在连接…”而不是报错码)。
多语言支持也要规划:面向海外市场,文案需要翻译和本地化。
产品定义的产出
产品定义阶段的产出:产品类型、功能属性表、控制逻辑说明、场景设计。这些文档是固件开发、App 开发和测试验收的共同依据。
产品定义看似“不写代码”,却决定了后面所有工作的质量。花一天想清楚,省一个月返工。