Ru果你曾经在调试蓝牙功Neng时被「找不到设备」或「配对弹窗不弹」弄得抓狂，那么答案hen可Neng就藏在 GAP这张「社交名片」里。它不负责真正的数据搬运，却决定了两台设备Neng否相互认识、握手并建立安全通道。

GAP 是蓝牙栈Zui外层的约定，它规定了：

设备Ke以扮演哪几种角色。

什么时候该发广播，什么时候该去监听。

配对时需要走哪些流程、怎样确认身份。

简而言之，GAP 就像是两个人第一次见面时的自我介绍环节：先把名字、兴趣抛出来再决定要不要进一步交流。没有这一步，后面的数据交换根本无从谈起。

每个蓝牙终端在任意时刻只Neng以一种身份出现，但Ke以随时切换。例如手机既Neng打开 BLE 广播让手环发现，也Neng主动去扫描耳机的信号。

广播——把自己包装成一个可被发现的信号。

扫描——搜寻周围的广播包并提取信息。

配对——完成身份校验与加密密钥协商。

连接管理——维持或恢复链路，为 GATT 打底。

下面我们把每一块拆开来用 iOS、Flutter 与 Android三套代码演示，让你“一kan即会”。所有示例均为Zui小可运行版，可直接粘进项目中调试。

// 初始化 PeripheralManager
self.peripheralMgr =  initWithDelegate:self queue:nil options:nil];
// 状态就绪后发送广播
- peripheralManagerDidUpdateState:pm {
    if  {
        NSDictionary *adv = @{
            CBAdvertisementDataLocalNameKey : @"GAP-iOS",
            CBAdvertisementDataServiceUUIDsKey : @]
        };
        ;
        NSLog;
    }
}

// 创建 Central Manager
self.centralMgr =  initWithDelegate:self queue:nil];
// 状态 OK 后开始扫描
- centralManagerDidUpdateState:cm {
    if  {
        ;
        NSLog;
    }
}
// 发现目标后停止扫描并尝试连接
- centralManager:cm didDiscoverPeripheral:peripheral advertisementData:adv RSSI:rssi {
    NSString *name = adv ?: @"未知";
    if  {
        NSLog;
        ;
        self.targetPeripheral = peripheral;
        ;
    }
}

// 连接成功后系统会自动弹出配对框
- centralManager:cm didConnectPeripheral:peripheral {
    NSLog;
    // 此处即可开始 GATT 探索
}

Future startGapAdvertise async {
  // 检查并打开蓝牙
  if  await FlutterBluePlus.turnOn;
  final adv = {
    'localName': 'GAP-Flutter',
    'serviceUuids': ,
  };
  try {
    await FlutterBluePlus.startAdvertising;
    print;
  } catch  {
    print;
  }
}

Future startGapScan async {
  if  await FlutterBluePlus.turnOn;
  FlutterBluePlus.startScan);
  print;
  FlutterBluePlus.scanResults.listen {
    for  {
      final name = r.device.name.isEmpty ? '未知' : r.device.name;
      if  {
        print');
        FlutterBluePlus.stopScan;
        // 发起连接并自动触发配对
        r.device.connect;
      }
    }
  });
}

void monitorConnection {
  dev.connectionState.listen {
   if  {
     print;
   } else if  {
     print;
   }
 });
}

public void startGapAdvertise {
   BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter;
   if ) { System.out.println; return; }
   BluetoothLeAdvertiser advertiser = adapter.getBluetoothLeAdvertiser;
   AdvertiseSettings settings = new AdvertiseSettings.Builder
           .setAdvertiseMode
           .setTxPowerLevel
           .setConnectable
           .build;
   AdvertiseData data = new AdvertiseData.Builder
           .setIncludeDeviceName
           .addServiceUuid))
           .build;
   advertiser.startAdvertising {
       @Override public void onStartSuccess {
           System.out.println;
       }
       @Override public void onStartFailure { System.out.println; }
   });
}

public void startGapScan {
   BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter;
   if ) { System.out.println; return; }
   BluetoothLeScanner scanner = adapter.getBluetoothLeScanner;
   scanner.startScan {
       @Override public void onScanResult {
           String name = result.getDevice.getName;
           if ) { // 换成你想找的名字
               System.out.println;
               scanner.stopScan;
               connectAndPair);
           }
       }
   });
}

private void connectAndPair {
   device.createBond; // 主动触发经典配对流程
   device.connectGatt {
       @Override public void onConnectionStateChange {
           if  {
               System.out.println);
               gatt.discoverServices; // 探索服务，间接验证配对成功
           } else if {
               System.out.println;
           }
       }
       @Override public void onServicesDiscovered{
            if{
                System.out.println;
            }else{
                System.out.println;
            }
       }
   });
}

SIG 通道规范：PDU 在三个广告信道轮询发送，Ru果你的硬件不支持全部信道，就会导致“搜不到”。确保手机/开发板开启了全部频段。

I/O 权限：AOSP 上需要在 Manifest 中声明 BLUETOOTH_SCAN / BLUETOOTH_CONNECT 等运行时权限，否则 API 会悄悄失效。

PANIC 时刻：A/B 测试中常见 “Yi经配过但仍弹框” 的原因是系统缓存被清理，需要手动调用 retrieveConnectedPeripherals 或 getBondedDevices 来判断Yi有配对状态。

TIPS：#iOS 必须先让 Peripheral Manager 启动再去扫描，否则会出现 “central not ready” 的异常；#Android 在低功耗模式下可Neng会被系统强制暂停扫描，请适当设置 ScanSettings#setReportDelay 来降低功耗冲突。