iOS平台Google Nearby Connections仅支持WiFi连接问题求助

• 确认权限配置完整性

  • 除NSBluetoothAlwaysUsageDescription、NSBluetoothPeripheralUsageDescription外，iOS 13+需额外添加NSLocalNetworkUsageDescription到Info.plist，且填写合理的权限说明文本——Nearby Connections即使优先蓝牙，也依赖本地网络权限完成设备扫描初始化。
  • 务必在调用广播/发现接口之前发起权限请求，确保用户授权后再初始化Nearby服务。

• 强制指定通信介质

  • 默认策略可能优先WiFi LAN，可手动指定介质组合或仅蓝牙：

    let options = NearbyConnections.Options()
    // 启用蓝牙+WiFi Direct的点对点策略
    options.strategy = .pointToPoint
    // 或强制仅使用蓝牙
    // options.allowedMedium = .bluetooth
    
    NearbyConnections.startAdvertising(endpointName, options: options) { endpoint, info in
        // 处理设备发现回调
    }
    

• 验证蓝牙硬件状态

  • 添加蓝牙状态监听，确保设备蓝牙处于开启状态：

    import CoreBluetooth
    let centralManager = CBCentralManager(delegate: self, queue: nil)
    
    func centralManagerDidUpdateState(_ central: CBCentralManager) {
        switch central.state {
        case .poweredOn:
            // 蓝牙就绪，初始化Nearby Connections
            break
        case .poweredOff:
            // 提示用户开启蓝牙
            break
        default:
            // 处理未授权、硬件不支持等异常状态
            break
        }
    }
    

• 检查SDK版本

  • 确保集成的是最新版Google Nearby Connections SDK，旧版本可能存在iOS蓝牙适配bug，可通过CocoaPods或Swift Package Manager完成版本更新。

• 测试环境规范

  • 必须使用真实iOS设备测试，模拟器不支持蓝牙功能；尽量保持两台测试设备的iOS版本一致，避免版本兼容性问题。

内容的提问来源于stack exchange，提问作者Niccolò Caselli