目录

开发指引

业务流程

[h2]设备间数据传输

整体流程可以划分为4个阶段。

  1. 广播扫描:
    1. 广播端调用startBroadcasting(String, String, ConnectCallback, BroadcastOption)启动广播。
    2. 发现端调用startScan(String, ScanEndpointCallback, ScanOption)启动扫描以发现附近的设备。
    3. 由onFound(String, ScanEndpointInfo)方法通知扫描结果。
  2. 建立连接:
    1. 发现端调用requestConnectEx(String, String, ConnectCallback, ConnectOption)向广播端发起连接请求。
    2. 两端由onEstablish(String, ConnectInfo)通知连接启动后,均可以调用acceptConnect(String, DataCallback)接受连接或调用rejectConnect(String)拒绝连接。
    3. 两端由onResult(String, ConnectResult)通知连接结果。仅当两端都接受连接时,连接才能建立。
  3. 传输数据:
    1. 连接建立后,两端均可以调用sendData(String, Data)发送数据给对端。
    2. 接收数据的一端由onReceived(String, Data)通知接收到数据;两端由onTransferUpdate(String, TransferStateUpdate)通知当前的传输状态。
  4. 断开连接:

    主动断开连接的一端调用disconnect(String)断开连接,对端由onDisconnected(String)通知连接断开。

  • Nearby Connection服务只在处理业务时,才使用对端设备的蓝牙标识符,且不会在磁盘中存储。
  • 持续蓝牙广播,扫描会引起2.4GHz频段发送bytes耗时明显增加,建链成功之后建议关闭广播、扫描。
  • Nearby Connection服务在数据传输过程中,建议保持设备屏幕处于亮屏状态,避免数据传输失败。