首次配对灯具：为什么设备列表一直是空的
配对顺利时大约只要二十秒。配对失败时，App 不会给出任何错误提示——设备列表只是一直空着。这看起来和灯坏了一模一样，但几乎从来不是灯坏了。
核心要点
- 列表为空，绝大多数是选错 App 或蓝牙权限被拒绝，而不是灯具故障。
- 我们的大多数控制器一次只连一部手机；请关闭所有配对过的手机上的 App。
- 配对时距离灯具一两米以内，灯具出现在列表里之后再走远。
- 配对后颜色不对是通道顺序问题，在 App 的 Modify Pin Sequence 里修正。
- 恢复出厂设置只对手机丢失或模块更换有用，对权限问题没有帮助。
开始前的三项检查
先做完这三项，大多数“无法连接”都不会变成一张工单。
- 确认使用的是正确 App。我们的每款 App 只使用一种控制协议，彼此不能通用。协议不匹配的 App 无论扫描多久都不会列出你的设备——看起来和灯具损坏完全一样。请先查看你的灯具需要哪款 App；选错 App 是最常见的一个原因。
- 确保没有其他手机占用连接。我们的大多数控制器一次只接受一个连接。曾经配对过的手机只要进入范围，就会在没有任何提示的情况下重新连上灯具。如果家里其他人用过这盏灯，请关闭其手机上的 App。
- 检查 App 的蓝牙权限。较新的 Android 和 iOS 版本必须获得“附近设备”或位置权限才能扫描。权限被拒绝时，App 只显示空列表，不会报错。请到手机的应用设置里检查，而不是在 App 内找——下表写明了位置。
配对时距离灯具一两米以内。初始握手是整个过程中对距离最敏感的环节。灯具出现在列表里并且调亮度有反应之后，再回到你平时坐的位置。
每款 App 的实际操作流程
每段视频都是对应 App 的连接教程，取自其自身文档，长度约八秒。有些 App 打开后自动扫描，另一些则有明确的添加设备步骤。
手机要的到底是哪项权限
“列表为空”在每部手机上看起来都一样，背后要的权限却不一样。
| 手机 | App 需要什么 | 在哪里开启 |
|---|---|---|
| iPhone 和 iPad | 该 App 的蓝牙权限，首次启动时只问一次 | 设置 > 隐私与安全性 > 蓝牙 > 该 App |
| Android 12 及以后 | “附近设备”权限 | 设置 > 应用 > 该 App > 权限 |
| Android 6 到 11 | 位置权限，并且手机的位置开关要打开 | 设置 > 应用 > 该 App > 权限，外加快捷面板里的位置开关 |
如果首次启动时点了“不允许”，iOS 之后不会再问，需要手动到设置里开启。Android 6 到 11 要求位置权限，这是操作系统的规定，不是我们设的：App 从不读取你的位置，但没有这项权限系统就不会返回任何蓝牙扫描结果。Android 12 起改为单独的“附近设备”权限。无论哪个版本，App 内看到的现象都一样——扫描在跑，什么也找不到。
解读失败现象
| 发生的情况 | 通常代表什么 |
|---|---|
| 设备列表一直完全为空 | App 不正确，或蓝牙权限被拒绝。先检查这两项，再做别的。 |
| 灯具出现后又从列表中消失 | 扫描过程中被另一部手机连上，或者灯具处于连接范围边缘。 |
| 连接成功，但几秒后断开 | 有其他手机在争连接，或距离过远。站到灯具旁边测试。 |
| 连接成功，但任何操作都没有响应 | 连接正常，控制器没有驱动灯带。检查控制器与灯具之间的接头。 |
| 亮度调节有响应，但颜色不正确 | 配对正常——问题在通道顺序。在 App 中修正。 |
| 列表中出现多个相同名称 | 范围内有多个控制器。只给目标控制器通电，其余断电；或者逐个连接并重命名。 |
| 大多数时候连接正常，偶尔在厨房附近失败 | 2.4GHz 干扰，常见于微波炉运行时。等微波炉停止后重试，或配对时靠近灯具。 |
| App 中显示一个已不存在的设备 | 已更换或移除的控制器留下的残留条目。在 App 的设备列表中删除它；App 删不掉时，对模块执行恢复出厂设置。 |
为什么首次连接比蓝牙耳机更敏感
蓝牙耳机配对一次后能连续几个月自动重连，人们也就这样期待灯具。配对完成之后，灯控设备的表现确实大致如此。难的是首次握手：App 要先弄清控制器有哪些通道和灯效，然后才能驱动它们，这一步交换的余量比单纯的音频链路小。
低功耗蓝牙（BLE）还与 Wi-Fi 共用 2.4GHz 频段，在厨房里还要加上正在运行的微波炉。BLE 的广播数据包很短，在这种噪声里很容易丢失。表现出来就是：灯具平时配对都正常，微波炉运行时要试第二次，或者在一个已经连着十几个蓝牙配件的房间里也会这样。这些都不是灯具的故障。配对时站在灯具旁边，握手的余量会大得多，这就是上面那条提示的全部理由。
网状网络 App 特意多了一步
使用蓝牙 App 时，连上一盏灯就能控制它。使用 iMeshting 时，你还要先指定添加的是哪种设备、属于哪个房间，之后它才会作为可控设备出现。
只装一盏灯时，这确实是额外工作。装到第四、第五盏时它就有了回报：“客厅里的所有灯”变成一个动作，而不是五个要分别管理的连接。如果以后还会加灯——比如一盏吊扇灯加上周围的灯带——请从第一盏就分配房间，不要等到后面再把所有设备重新添加一遍。吊扇灯为什么用网状网络一文写明了房间分组能带来什么。
恢复出厂设置：什么时候才该做
恢复出厂设置会彻底清除控制器保存的配对信息。它只在两种情况下有用：
- 配对过这盏灯的手机已丢失、售出或不在身边，无法解除配对。否则灯具会一直为一台永远不会释放的设备保留连接位。
- 控制模块曾在不同灯具之间移动，或在保修时被更换，而 App 里仍显示指向旧硬件的设备条目。
它对权限问题、选错 App 的问题，或灯具处于范围边缘的情况没有帮助。灯具本身不是原因时，重置它只会在原有问题之上再添一个新问题。
我们的大多数控制器用短时间内的通断电模式（关、开、关、开）触发重置，而不是按键，因为模块装好之后没有外露的重置开关。具体模式因灯具而异。在多灯安装环境里，对错误的回路做了错误的操作，会重置一盏你并不想动的灯，所以请先联系我们确认你这款灯具对应的方式。
配对完成后要看一次的两项设置
这两项都在设置弹窗里，不在主控制界面上，所以经常被漏掉。请在固定安装之前完成。
- Pixels（像素数），用于可寻址照明——灯带上有多少个可寻址点。设得太少，灯效只在最前面一段跑，不会铺满整条灯带。
- Modify Pin Sequence（修改引脚顺序），用于颜色显示不对的情况——用软件重新映射通道顺序，不用重新接线。查看操作指南。
为什么别家的配对流程不一样
上文"列表是空的"这个问题来自一个设计选择：蓝牙本身就是控制通道，没有第二步。主流方案各自都多了一步。
| 方案 | 第一次连接 | 之后发生什么 | 卡在哪里 |
|---|---|---|---|
| Philips Hue | 蓝牙直连，每部手机最多 10 盏、约 10 m；或经 Hue Bridge 走 Zigbee，最多 50 盏 | 蓝牙模式没有自动化和远程控制，Bridge 补上这两样 | 第 11 盏灯就意味着要买 Bridge |
| Govee | 先蓝牙连上，App 再把你的 2.4 GHz Wi-Fi 密码交给设备 | 此后设备通过 Govee 的云受控，需要 Govee 账号 | 2.4 GHz 与 5 GHz 合并的网络：Govee 官方建议拆分频段并用 WPA2；"卡在蓝牙模式"的设备要删掉重新添加 |
| Matter | 设备通过蓝牙广播存在，你扫二维码或输入 11 位配对码 | 需要一个 Matter 控制器（HomePod、Nest、Echo、Home Assistant）以及 Wi-Fi 或 Thread | 配对码被拒绝的情况多到有专门的排障页面 |
| 我们的 | 蓝牙直连，1–2 m 内，同一时间一部手机 | 蓝牙始终是控制通道：没有路由器这一步，没有账号 | App 选错（列表为空）、某项权限，或上一部手机还连着 |
实际结果是，表里那些 2.4 GHz、5 GHz、WPA3 的问题在这里都不会发生，换路由器之后也没有东西要重新添加。代价是距离：控制范围是蓝牙范围，不是互联网；离线要放弃什么说明了这对全屋场景意味着什么。
来源：Philips Hue 常见问题：不用 Bridge 连接；Govee 连接常见问题；连接标准联盟 Matter 常见问题。
仍然无法连接？
请告诉我们你使用哪款 App、灯具是否曾出现在列表中，以及调节亮度时发生了什么。有了这三个答案，就能立即缩小问题范围。联系我们。