版本：v1.0 | 创建日期：2026-02-12 适用场景：蓝牙配网、广播隐藏、鸿蒙兼容性、CI-86Z/JX-12F等模组 素材来源：技术交流群案例（2026-02-06）+ SmartPi 官方文档

前言

在语音产品开发过程中，一个常见的需求是： 设备上电后开启蓝牙配对窗口，一段时间后自动隐藏，以平衡用户体验和安全性/功耗。

近期一个案例引发了新的技术问题：厂商实现了"5分钟后隐藏广播"功能，但测试发现 纯血鸿蒙手机始终能搜到设备，而安卓手机5分钟后正确隐藏。

本文将深入分析蓝牙广播隐藏机制的工作原理、鸿蒙与安卓系统的差异、以及针对这种"反向兼容性"问题的解决方案。

一、问题现象与案例

1.1 真实案例还原

用户反馈（智能公元技术交流群，2026-02-06）：

"纯血鸿蒙总是能搜到啊" "我换了安卓就搜不到了" "就是5分钟后" "搜索协议是不是又要改一下"

问题场景：

关键信息：

• 设备类型：智能沙发控制器（CI-86Z模组）
• 功能需求：上电后开启蓝牙配对，5分钟后自动隐藏
• 问题表现：鸿蒙手机无法正确识别"广播隐藏"状态

1.2 问题影响

二、技术背景：广播隐藏机制

2.1 蓝牙广播隐藏的工作原理

┌─────────────────────────────────────────────────────────────┐
│                    蓝牙广播隐藏流程                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   上电启动                                                  │
│      │                                                      │
│      ▼                                                      │
│   开启广播 (可发现状态)                                     │
│      │                                                      │
│      ├───────── 5分钟倒计时 ─────────┐                      │
│      │                                  │                    │
│      ▼                                  ▼                    │
│   [条件检查]                          [蓝牙连接中？]         │
│      │                                  │                    │
│      ├─ 已连接 → 延长10秒检测 ────────┼─ 是 → 继续等待      │
│      │           循环直到断开           │                    │
│      │                                  │                    │
│      └─ 未连接/已断开 → 停止广播 ❌     └─ 否 → 停止广播 ❌ │
│                                                             │
└─────────────────────────────────────────────────────────────┘

2.2 SmartPi平台的广播隐藏实现

平台配置选项：

关键逻辑：

1. 上电开始计时
2. 如果有设备连接，暂停超时计时
3. 连接断开后，继续检测10秒
4. 10秒内无重新连接，停止广播
5. 达到超时时间后，停止广播

三、鸿蒙与安卓系统差异分析

3.1 蓝牙扫描策略差异

3.2 设备缓存问题

核心问题猜测：鸿蒙系统可能存在蓝牙设备缓存机制

标准Android行为：
┌────────────────────────────────┐
│ 设备停止广播                    │
│   ↓                            │
│ 系统立即移除设备                │
│   ↓                            │
│ 搜索结果：设备消失              │
└────────────────────────────────┘
鸿蒙系统可能行为：
┌────────────────────────────────┐
│ 设备停止广播                    │
│   ↓                            │
│ 系统保留缓存（延迟移除）         │
│   ↓                            │
│ 搜索结果：设备仍显示 ❌         │
└────────────────────────────────┘

3.3 广播数据变更检测

另一种可能是：鸿蒙系统对广播数据变化的检测方式不同

四、排查与诊断流程

4.1 确认设备是否真正停止广播

使用专业工具验证：

诊断结论：

• 如果专业工具也搜到 → 设备未停止广播（固件问题）
• 如果专业工具搜不到、鸿蒙搜到 → 鸿蒙缓存问题（本文重点）

4.2 验证固件广播停止功能

串口日志检查：

# 连接串口，监控广播状态日志
# 5分钟后应看到类似输出：
[INFO] BLE broadcast timeout reached
[INFO] Stopping BLE advertising
[INFO] Broadcast stopped

4.3 鸿蒙系统缓存验证

测试步骤：

1. 等待5分钟后，鸿蒙仍显示设备
2. 在鸿蒙手机上：关闭蓝牙 → 等待5秒 → 重新开启蓝牙
3. 重新扫描设备

结果判断：

五、解决方案

方案一：固件层面彻底停止广播（推荐）

核心思路：确保设备在超时后真正停止发送任何蓝牙广播包

固件代码优化：

// 原代码（可能存在问题）
void ble_broadcast_timeout_handler(void) {
    if (timer_reached_5min()) {
        // 仅停止可发现广播，可能仍在发送其他广播
        ble_adv_set_discoverable(FALSE);
    }
}
// 优化后代码
void ble_broadcast_timeout_handler(void) {
    if (timer_reached_5min()) {
        // 完全停止所有广播
        ble_adv_stop_all();
        // 可选：断开任何现有连接
        ble_disconnect_all();
        // 记录日志
        log_info("BLE broadcast completely stopped");
    }
}

验证方法：

1. 烧录优化后固件
2. 使用nRF Connect等专业工具验证
3. 确认所有类型的广播都已停止

方案二：修改广播名称标识状态

核心思路：即使广播未停止，通过修改广播名称来标识"不可配对"状态

实现方式：

// 配对模式广播
#define DEVICE_NAME_PAIRING    "SmartDevice_ABC123"
// 不可配对模式广播（超时后）
#define DEVICE_NAME_LOCKED     "SmartDevice_[LOCKED]"
void ble_broadcast_timeout_handler(void) {
    if (timer_reached_5min()) {
        // 修改广播名称
        ble_set_device_name(DEVICE_NAME_LOCKED);
        // 可选：停止可发现连接
        ble_adv_set_connectable(FALSE);
    }
}

小程序适配：

// 检测设备名称，过滤已锁定设备
function isDeviceAvailable(device) {
    const name = device.localName || device.name || '';
    // 拒绝已锁定设备
    if (name.includes('[LOCKED]') || name.includes('[LOCKED]')) {
        console.log('设备已锁定，不可配对');
        return false;
    }
    return true;
}
// 过滤设备列表
const availableDevices = devices.filter(isDeviceAvailable);

方案三：主动断开连接+停止广播

核心思路：在超时后主动断开所有连接，确保系统感知到设备离线

void ble_broadcast_timeout_handler(void) {
    if (timer_reached_5min()) {
        // 1. 先断开所有连接
        uint8_t conn_count = ble_get_connection_count();
        for (uint8_t i = 0; i < conn_count; i++) {
            ble_disconnect(i);
        }
        // 2. 延时等待断开完成
        delay_ms(500);
        // 3. 完全停止广播
        ble_adv_stop_all();
    }
}

方案四：小程序端适配（兜底方案）

检测设备真实状态：

class BluetoothDeviceManager {
    constructor() {
        this.systemInfo = wx.getSystemInfoSync()
        this.isHarmonyOS = this.systemInfo.system.includes('HarmonyOS')
    }
    // 尝试连接设备以验证真实状态
    async verifyDeviceState(deviceId) {
        try {
            await wx.createBLEConnection({
                deviceId: deviceId,
                timeout: 3000
            })
            // 能连接说明设备仍在广播
            await wx.closeBLEConnection({ deviceId: deviceId })
            return 'ACTIVE'
        } catch (err) {
            // 连接失败说明设备已停止广播
            if (err.errCode === 10006 || err.errCode === 10012) {
                return 'INACTIVE'
            }
            return 'UNKNOWN'
        }
    }
    // 鸿蒙系统特殊处理
    async handleHarmonyOSDevice(device) {
        const state = await this.verifyDeviceState(device.deviceId)
        if (state === 'INACTIVE') {
            // 设备实际已不可用，从列表移除
            console.log('鸿蒙缓存设备，已不可用')
            return null
        }
        return device
    }
}

六、完整配置示例

6.1 SmartPi平台配置

配对超时配置：

配置路径：固件配置 → 蓝牙配置 → 配对管理
┌─────────────────────────────────────────┐
│ 配对超时设置                             │
├─────────────────────────────────────────┤
│ 配对窗口时长：5 分钟                     │
│ 连接后延长：是                           │
│ 断开后保持：10 秒                        │
│ 超时后行为：完全停止广播                  │
└─────────────────────────────────────────┘

6.2 固件行为验证

测试流程：

测试准备：
1. 准备3台设备：纯血鸿蒙手机 ×1，安卓手机 ×2
2. 准备nRF Connect等调试工具
3. 准备串口监控工具
测试步骤：
步骤1：设备上电，所有手机开始计时
步骤2：0-5分钟内，所有手机都能搜到设备 ✓
步骤3：5分钟时，记录各手机状态
步骤4：使用nRF Connect验证设备广播状态
步骤5：分析结果，定位问题

预期结果：

结论：鸿蒙手机存在缓存/显示问题

七、预防措施与最佳实践

7.1 固件开发规范

7.2 测试验证规范

多系统兼容性测试：

7.3 小程序开发建议

兼容性处理：

// 1. 系统检测
function getSystemType() {
    const info = wx.getSystemInfoSync()
    if (info.system.includes('HarmonyOS') || info.brand === 'HUAWEI') {
        return 'HARMONYOS'
    }
    return 'STANDARD'
}
// 2. 根据系统调整策略
const deviceFilter = getSystemType() === 'HARMONYOS'
    ? harmonizeDeviceFilter  // 鸿蒙专用过滤器
    : standardDeviceFilter   // 标准过滤器
// 3. 定期刷新设备列表
setInterval(() => {
    if (getSystemType() === 'HARMONYOS') {
        refreshDeviceList()  // 更频繁刷新
    }
}, 5000)

八、常见问题FAQ

Q1：为什么鸿蒙手机会显示已停止广播的设备？

A：可能原因：

1. 系统级蓝牙设备缓存，未及时更新
2. 扫描API返回的是历史缓存数据
3. 广播停止方式不彻底，仍有残留广播包

建议先用nRF Connect等专业工具确认设备广播状态。

Q2：如何彻底停止蓝牙广播？

A：确保调用以下函数：

1. ble_adv_stop_all() - 停止所有广播
2. ble_set_adv_enabled(FALSE) - 禁用广播功能
3. ble_disconnect_all() - 断开所有连接

不要仅设置"不可发现"标志，要完全停止广播功能。

Q3：小程序能否检测到设备的真实状态？

A：可以尝试：

1. 尝试连接设备（ createBLEConnection）
2. 连接失败且错误码为10006/10012说明设备已不可用
3. 将这些设备从列表中移除

Q4：是否需要针对鸿蒙做特殊处理？

A：建议：

1. 固件层面确保广播完全停止（优先）
2. 小程序层面增加设备状态验证（兜底）
3. 向用户提示"设备配对窗口已关闭"

Q5：5分钟超时时间可以修改吗？

A：可以，在平台配置中：

• 0表示不自动隐藏（一直可配对）
• 1-60分钟范围可调
• 建议根据产品特点选择合适时长

九、总结

蓝牙广播5分钟后隐藏功能在不同手机系统上的兼容性问题，核心解决思路是：

1. 固件优先：确保设备真正停止所有广播，不依赖系统清理
2. 状态标识：通过广播名称变化明确标识设备状态
3. 主动断开：超时前主动断开所有连接
4. 小程序适配：增加设备状态验证作为兜底
5. 充分测试：多系统、多场景验证兼容性

关键要点：

• 完全停止广播 > 仅设置不可发现
• 鸿蒙系统可能有缓存延迟
• 专业工具验证是问题定位的基础
• 小程序端可做适配但不是根本解决方案

参考资料

• SmartPi 官方文档《CI-86Z 产品文档》
• SmartPi 官方文档《蓝牙配对配置说明》
• 蓝牙SIG核心规范 5.0
• HarmonyOS 蓝牙开发指南
• 微信小程序蓝牙API文档
• 技术交流群案例（2026-02-06：鸿蒙蓝牙广播隐藏问题）

关键词：蓝牙广播、配对超时、鸿蒙兼容性、CI-86Z、广播隐藏、缓存问题、多系统兼容