智能油烟机小程序与APP开发

先确认油烟机已经具备哪些联网条件

小程序和APP是用户操作入口，不会让一台普通油烟机自动变成联网设备。开发前要看油烟机使用什么通信模组，固件是否已经定义控制协议，是否有设备云，灶具联动由本机完成还是经过云端，以及硬件团队能否配合修改固件。

常见链路是“油烟机—家庭路由器—设备云—业务服务器—小程序或APP”。蓝牙可以辅助发现设备、传入网络信息，也可以在硬件支持时做近距离控制。无论采用哪种方式，都要把设备唯一身份、首次激活、所有者绑定、家庭成员共享、转让解绑和恢复出厂后的关系处理清楚。

红数科技负责合同内的小程序、APP、业务后台、服务器程序和约定接口。通信模组、主控板、传感器、整机固件、灶具控制器、实验设备、认证测试和量产烧录不会默认包含；确需参与网关、模组或固件开发时，会把工作范围、责任人和费用单独列明。

小程序还是APP，取决于用户怎样使用

小程序适合扫码进入、首次配网、查看设备、做常用设置和申请售后，用户无需另外安装。对单台设备、低频使用或者以微信服务为主的项目，小程序能降低第一次使用的门槛。

APP更适合长期使用、多台厨电管理、复杂蓝牙能力、系统推送、设备日志、原生SDK、稳定OTA和品牌自有账号体系。iOS与Android对后台运行、局域网、蓝牙和通知权限都有各自限制，APP能做得更完整，但也不能绕过手机系统规则。

有些品牌会采用“小程序负责快速服务，APP负责长期管理”的组合。是否需要两套用户端，应根据设备数量、蓝牙依赖、OTA方式、智能家居接入、用户安装意愿和预算决定，不为了显得完整而重复建设。

配网做不好，后面的智能功能几乎用不上

用户通常只看到“长按设备按键、选择网络、输入密码”几步，程序背后要判断设备是否进入配网状态、手机连的是不是2.4GHz网络、蓝牙与定位权限是否可用、凭证有没有传到正确设备、设备是否成功联网，以及云端有没有完成激活。

一套能交付的配网流程应覆盖首次配网、配网超时、密码错误、设备离路由器太远、手机切换网络、设备已被别人绑定、换路由器、账号换手机、设备转让和恢复出厂。页面不能只报“连接失败”，应尽量区分失败发生在发现设备、传递网络信息、连接路由器、接入云端还是账号绑定阶段。

设备身份不能只依赖一个容易猜到的编号。常见做法包括机身二维码、一次性验证码、设备进入可绑定状态后近距离确认，或者由品牌后台预先登记。具体方式要和生产、贴标、售后换机及恢复出厂流程一起确定。

页面上的开关必须对应真实设备能力

同一品牌的油烟机可能有不同档位、照明方式、手势控制、延时关机、自动巡航、热清洗或其他能力。项目会按型号和固件版本建立设备模型，页面只显示当前设备确实支持的功能。

用户点击档位后，小程序或APP先把请求交给服务器，服务器校验账号和设备，再由设备云下发给油烟机。服务器收到请求不代表电机已经换挡，最终状态应以设备回报为准。

每条控制指令应有唯一编号，并记录设备、账号、时间、参数、下发结果、设备回报和耗时。连续点击、网络重试和重复回调不能导致档位被意外多次切换。设备离线时，不应让用户误以为远程操作已经完成。

灶具联动首先是整机控制问题

油烟机与灶具联动可能由射频、蓝牙、有线信号或本地控制器直接完成，也可能经过家庭网络和云端。对点火即开机、火力变化自动调档这类需要及时响应的功能，本地联动通常比依赖互联网更稳。小程序或APP适合配置、查看和记录，不应成为唯一的联动通道。

自动调档依赖油烟、温度、火力或其他传感信息时，阈值、延时和档位关系要由整机与算法团队确认。软件负责执行和展示已经确认的规则，不能替代实验室测试，也不能仅凭一组未经验证的数据声称自动净烟效果。

远程点火、燃气阀控制及其他可能直接影响燃气安全的能力，不属于普通油烟机软件项目的默认范围。确有业务需要时，必须由具备相应能力的硬件、燃气、电气和合规人员进行专项评估，设备端保留最终保护与拒绝能力。

设备断网，本机按键仍要能用

油烟机是家用电器，不能因为路由器、云端或手机不可用就失去基本操作。开关、调档、照明、必要保护和设备端已实现的本地联动，应按整机设计独立运行。云端恢复后，用户端再读取设备真实状态，不把断网前的旧状态继续当成当前状态。

远程控制与本机按键同时发生时，要确定以设备最终状态为准，还是按指令时间排序；进入清洗、维修、故障保护或其他特殊状态时，哪些远程指令必须拒绝，也要由设备回报清楚原因。

提醒要有依据，不能只推一条消息

滤网清洁提醒可以按运行时长、风机档位、传感器或设备算法触发。采用哪一种方式，必须与整机说明一致。用户完成清洁后，是否允许在手机端重置、是否需要设备确认，以及换机后怎样保留记录，都应提前约定。

故障提醒需要包含设备、时间、故障码、当前状态和用户可以做的安全操作。涉及电机、温度、电源或其他整机保护时，用户端只展示设备提供的结果，不越过说明书给出未经确认的维修指令。

小程序订阅消息需要用户主动同意，并受模板和发送条件限制；APP通知也可能被用户关闭或被手机系统限制。重要的整机安全保护必须由设备端完成，手机消息只作为辅助提示，不能作为唯一保护手段。

OTA升级要考虑断电、断网和版本不匹配

油烟机固件升级前应核对产品型号、硬件版本、当前版本、电源状态和升级包，下载后校验文件完整性。传输或安装过程中断时，设备能否续传、回滚或进入恢复模式，取决于通信模组、主控和Bootloader能力。

后台应管理固件版本、适用型号、升级说明、发布范围和结果，支持先对少量测试设备发布，再逐步扩大。升级完成不能只看进度条到达百分之百，还要重新读取设备版本和关键状态。失败记录要能查到设备、原版本、目标版本、APP版本、失败阶段和错误码。

固件文件、签名、版本跨度、低版本兼容和失败恢复规则应由硬件或固件团队提供。软件可以完成发布、传输、状态和记录，不能补上设备端没有设计的安全升级能力。

家庭共享与售后后台要分开授权

一台油烟机通常属于一个家庭，但不等于每个家庭成员都能移交设备、删除记录或修改高级参数。家庭所有者可以邀请成员，成员按授权查看和操作；房屋出售、出租结束、设备换新和账号注销时，要有移交或解绑路径。

设备后台通常包括产品型号、设备批次、账号绑定、家庭关系、在线状态、固件版本、指令记录、故障事件、OTA任务、售后工单和必要的接口运行情况。不同品牌、渠道和家庭数据应隔离，设备密钥、云端密钥和第三方接口密钥不能放在小程序或APP前端代码中。

配网可能涉及蓝牙、附近设备、局域网或位置相关权限，具体申请应按目标平台现行规则和实际功能确定。只收集完成配网、账号和售后所需的信息，说明用途、保存时间和共享对象，并提供账号注销、关系解除及合同约定的数据处理方式。

开发前要准备的资料

• 可正常工作的油烟机样机，建议至少准备两台同型号和一台不同型号或版本；
• 通信模组、设备云、主控板和灶具联动的责任单位及技术联系人；
• 设备配网、身份、属性、指令、事件、故障码和回报协议；
• 各型号支持的档位、照明、延时、清洁、传感与联动能力；
• 本机按键、远程控制、自动模式和故障保护之间的优先关系；
• 网络断开、设备离线、云端异常和恢复后的设备行为；
• 固件包、版本规则、校验方式、升级条件和失败恢复说明；
• 家庭所有者、成员、客服、售后和管理员的权限范围；
• 小程序或APP主体、开发者账号、发布地区和目标手机范围；
• 品牌素材、产品说明书、隐私材料、售后流程和应用市场资料；
• 是否接入语音助手、全屋智能平台、客服、工单或现有会员系统；
• 服务器部署、数据保存、日志期限、源码和第三方服务边界。

协议文档至少应说明认证、设备身份、字段单位、读写方向、参数范围、应答、超时、错误码、版本差异和测试环境。只有几张APP截图或云平台账号，通常不足以准确评估设备对接工作。

项目怎么推进

1. 设备调研：确认型号、通信方式、固件、设备云、灶具联动和目标市场。
2. 协议预研：用真实样机验证配网、绑定、状态、常用指令、事件和升级可行性。
3. 范围确认：确定小程序、APP、后台、角色、接口、兼容手机和交付边界。
4. 原型设计：走通首次配网、日常控制、家庭共享、故障提示、售后和OTA。
5. 视觉设计：按品牌和厨电使用场景完成用户端与管理端主要界面。
6. 程序开发：开发用户端、后台、服务器、数据库和合同约定的设备接口。
7. 软硬件联调：连接真实油烟机，核对字段、指令、回报、故障和版本差异。
8. 异常测试：覆盖断网、断电、拒绝权限、重复指令、设备离线和升级中断。
9. 发布准备：配置主体、备案、隐私说明、证书、截图和应用市场所需材料。
10. 培训交接：完成账号、代码、文档、测试记录、后台培训和维护边界确认。

开发中增加新型号、改换通信模组、调整设备协议、加入新的智能家居平台或改变OTA机制，会影响原有程序和测试范围，需要重新确认排期和费用。

开发周期与设备成熟度直接相关

周期从样机、协议、设备云、账号和需求基本具备后计算。硬件打样、模具、整机测试、固件长期未完成、认证检测、应用市场等待以及客户未提供测试条件的时间，不计入常规软件排期。小程序和应用市场由相应平台审核，开发方可以协助准备与整改，不能承诺固定通过日期。

服务费用怎样核算

以上用于前期选型，不是固定报价。正式报价会列明目标平台、油烟机型号、设备属性与指令、配网方式、设备云接口、灶具联动、OTA、账号家庭、后台、第三方接口、兼容手机、测试样机、发布地区、源码、维护期限和新增需求计费方式。

通信模组、控制板、传感器、样机、固件、设备云年费、服务器、短信与推送、开发者账号、软件著作权、测试手机、第三方SDK、智能家居平台认证、整机检测和合规咨询等费用，应按实际项目逐项说明。

哪些客户更适合建设这套软件

• 已有联网油烟机样机和稳定协议，希望建立自有品牌用户端；
• 已有设备云，但现有通用APP无法体现品牌和售后服务；
• 同一品牌有多个厨电型号，需要统一账号、家庭和设备后台；
• 需要把配网、控制、滤网提醒、故障与售后记录放在同一入口；
• 准备接入灶具、语音助手或全屋智能平台，并能提供对应技术资料；
• 有硬件与固件团队参与联调，愿意用真实设备覆盖异常测试；
• 重视长期版本维护，不把软件当成只演示一次的页面。

如果油烟机尚未选定通信模组，固件协议仍在频繁变化，也没有可配合的硬件人员，建议先做范围明确的技术预研。平台选型和页面设计可以先准备，但不能在设备能力不确定时承诺全部控制和升级功能。

项目交付应能对应真实产品

• 经确认的设备型号、配网、属性、指令、事件、故障、角色和接口清单；
• 小程序、APP和后台合同范围内的原型与视觉设计稿；
• 可测试及提交审核的微信小程序、iOS与Android程序；
• 账号、家庭、设备、控制、提醒、故障、OTA和售后等约定功能；
• 业务服务器、数据库、管理后台及合同约定的设备云接口；
• 代表型号油烟机的配网、控制、断网、故障和升级联调记录；
• 功能、接口、权限、隐私、真机、兼容和异常测试记录；
• 部署配置、管理账号、操作手册、接口说明、培训和维护说明；
• 合同约定的自研源码、设计源文件及第三方授权说明；
• 小程序备案、应用证书、隐私材料、审核和发布的约定协助。

整机固件、通信模组SDK、主控程序、设备云和第三方智能家居平台的源码或使用权，以实际权属和合同为准。签约前应分别说明哪些由客户提供、哪些由红数科技开发、哪些只能获得接口使用权。

验收必须使用真实油烟机

验收至少准备两台同型号设备和一台不同型号或固件版本设备，并覆盖家庭路由器更换、手机拒绝权限、设备离线、设备本机操作、连续控制、云端超时、异常恢复和OTA中断。只有模拟数据或页面动画正常，不能证明真实油烟机可用。

上线后，软件维护与整机售后各有责任

红数科技按合同负责需求、设计、用户端与后台开发、约定接口联调、测试、部署、发布协助、培训以及维护期内的程序故障处理。客户及硬件供应商负责整机、电气安全、传感器、通信模组、固件、设备协议、产品说明、认证、生产质量和实际售后，也负责提供真实样机和技术人员配合排查。

手机系统、微信规则、应用市场和第三方智能家居平台会持续变化；油烟机也可能更换主控、模组和固件。新增设备型号、接入新平台、调整协议、提高日志范围或改变升级方式，属于后续版本工作，需要根据影响另行评估。

智能油烟机软件真正要解决的，不只是用户能在手机上换一个档位。第一次配网能不能顺利完成，页面状态是不是设备真实结果，断网后本机还能不能正常使用，固件升级失败有没有恢复办法，售后能不能找到设备和错误阶段，这些细节才决定软件交付后是否经得住日常使用。