客厅小程序开发注意事项:踩过5个坑之后的实战复盘
去年年底我接了个客厅场景的小程序项目,说白就是手机当遥控器、客厅大屏当显示器,控制灯光、空调、投影这一套。上线三个月,日活稳定在四千出头,中间踩的坑一点不少。今天把客厅小程序开发里最容易被忽略的几点写出来,给准备做这类项目的人省点时间。
客厅里的用户是坐着的,不是戳屏幕的
手机小程序可以让人低头点点点,客厅不行。人窝在沙发上,离屏幕两米五到三米,手里可能还端着水杯。我第一次做原型的时候按手机端的习惯排了六七个按钮,测试当天就有人反馈点不准。

后面改了三版,我的结论是:

- 大屏端最小字号不低于 32px,按钮高度至少 80px,别心疼留白
- 交互以遥控焦点移动为主,方向键要能走完全流程,不能依赖触摸
- 语音做兜底,"打开客厅灯"这类指令响应控制在 1.5 秒内
- 主流程压在三步以内,实测每多一步,流失大概掉 15%

还有个细节,客厅经常是多人场景,老人小孩都在。颜色对比度、图标含义得一眼看懂,别用那种需要解释的抽象符号,解释成本最后都会变成客服工单。
设备适配和权限才是真正的深水区
客厅小程序绕不开硬件。蓝牙、局域网、投屏协议,每一个都能让你加班。微信小程序的蓝牙接口在 iOS 和安卓上行为不一样,安卓部分机型搜设备要十几秒,iOS 反而快得多。我们最早想做局域网直连,用 mDNS 发现设备,后来发现小程序里根本玩不转,最后老老实实走云端 MQTT,延迟从 200ms 涨到 600ms 左右,但稳定性上来了,用户反而没抱怨。
权限这块要提前写清用途。蓝牙权限、位置权限(安卓搜蓝牙需要位置权限)被拒之后必须有引导页,不能白屏。iOS 切后台连接会断,用户从微信切出去接个电话回来,遥控就失灵——这个重连逻辑我们写了三轮才顺。
审核也别大意。类目选"智能家居"要提供硬件相关资质说明,小程序里带视频内容的话版权材料也得备着。我们第一次提交被驳回,理由是"功能与类目不符",改完类目两天过审。
包体控制在 2M 以内是常识,但客厅场景更麻烦的是弱网。很多家庭的客厅 Wi-Fi 信号一般,尤其隔了一堵墙的路由器。首屏加载我们压到 1.2 秒,靠接口合并加本地缓存设备列表。图片统一转 webp,大屏 1080p 的展示位别直接扔 4K 原图上去,加载慢还费流量。
说实话,客厅小程序不是把手机端放大就完事。它更像做一个小型的、有人情味的遥控器,想清楚谁在用、在什么状态下用,比堆功能重要得多。如果让我重做一次,我会先把遥控焦点逻辑和弱网降级方案定死,再动界面,顺序反过来至少多花一个月。