Mac下CoreBluetooth外设服务UUID未纳入广播数据咨询

我开发的macOS应用通过CoreBluetooth搭建蓝牙服务，服务与特征已正确添加，但服务UUID未出现在广播数据中。在iOS端运行相同代码时，服务UUID可正常显示在广播数据内。调用self.peripheralManager?.startAdvertising([CBAdvertisementDataServiceUUIDsKey: [serviceUUID]])传入的数据在macOS上似乎被忽略，文档中未找到相关说明，请问macOS下服务UUID是否应纳入广播数据？

测试代码如下：

class BluetoothController: NSObject, CBPeripheralManagerDelegate {
    private var peripheralManager: CBPeripheralManager?
    private var cyclingPowerService: CBMutableService?
    private var cyclingPowerCharacteristic: CBMutableCharacteristic?

    override init() {
        super.init()

        self.peripheralManager = CBPeripheralManager(delegate: self, queue: nil)
    }

    func peripheralManagerDidUpdateState(_ peripheral: CBPeripheralManager) {
        if (peripheral.state == .poweredOn) {
            // UUIDs for the service and characteristic
            let serviceUUID = CBUUID(string: "1818")
            let characteristicUUID = CBUUID(string: "2A63")
            
            // Create a characteristic
            self.cyclingPowerCharacteristic = CBMutableCharacteristic(type: characteristicUUID, properties: .read, value: nil, permissions: .readable)
            
            // Create a service
            self.cyclingPowerService = CBMutableService(type: serviceUUID, primary: true)
            
            // Add the characteristic to the service
            self.cyclingPowerService?.characteristics = [self.cyclingPowerCharacteristic!]
            
            // Add the service to the peripheral manager
            self.peripheralManager?.add(self.cyclingPowerService!)
            
            // Start advertising
            self.peripheralManager?.startAdvertising([CBAdvertisementDataServiceUUIDsKey: [serviceUUID]])
        }
        else {
            self.peripheralManager?.remove(self.cyclingPowerService!)
        }
    }
}

macOS下CoreBluetooth完全支持在广播数据中包含服务UUID，你的问题主要出在操作时机和系统细节限制上，以下是针对性解决方法：

• 等待服务添加完成后再启动广播
  当前代码在调用add(_:)后立刻启动广播，但add(_:)是异步操作，服务尚未完成系统注册就开始广播，会导致UUID无法被正确纳入广播数据。必须在peripheralManager(_:didAdd:error:)代理方法中确认服务添加成功后，再执行广播操作：

  func peripheralManager(_ peripheral: CBPeripheralManager, didAdd service: CBService, error: Error?) {
      guard error == nil else {
          print("添加服务失败: \(error!)")
          return
      }
      // 服务注册完成后启动广播
      let serviceUUID = CBUUID(string: "1818")
      peripheral.startAdvertising([CBAdvertisementDataServiceUUIDsKey: [serviceUUID]])
  }
  

• 注意macOS对广播数据的长度限制
  虽然iOS和macOS都遵循BLE广播数据最大31字节的标准，但macOS在处理UUID广播时的空间占用计算更严格。如果你的广播数据还包含本地名称等其他字段，可能会挤占UUID的空间。建议先只广播UUID进行测试，确认正常后再逐步添加其他字段。

• 检查蓝牙权限配置
  macOS 10.13及以上版本，必须在Info.plist中添加NSBluetoothAlwaysUsageDescription或NSBluetoothPeripheralUsageDescription权限描述，否则蓝牙功能会被系统限制，导致广播数据异常。

• 用专业工具验证广播数据
  避免依赖第三方扫描工具的显示误差，建议使用Apple官方的Bluetooth Explorer工具（需在开发者网站下载额外开发者工具包）查看真实的广播数据，或者用CoreBluetooth自己的扫描代码验证结果。

内容的提问来源于stack exchange，提问作者Niklas Berglund