Управление подключениями

Как установить подключение

Когда устройства поблизости найдены, обнаруживающее устройство может инициировать подключение. В следующем примере запрашивается подключение к устройству, как только оно будет обнаружено.

Swift

extension Example: DiscovererDelegate {
  func discoverer(
    _ discoverer: Discoverer, didFind endpointID: EndpointID, with context: Data) {
    // An endpoint was found. We request a connection to it. The endpoint info can be used
    // to provide arbitrary information to the discovering device (e.g. device name or type).
    discoverer.requestConnection(to: endpointID, using: "My Device".data(using: .utf8)!)
  }

  func discoverer(_ discoverer: Discoverer, didLose endpointID: EndpointID) {
    // A previously discovered endpoint has gone away.
  }
}

В зависимости от вашего варианта использования вы можете вместо этого отобразить пользователю список обнаруженных устройств, позволяя ему выбрать, к каким устройствам подключаться.

Как принять или отклонить запрос на подключение

После того как обнаруживающее устройство запросит подключение к рекламодателю, рекламодатель получит уведомление о запросе на подключение через метод делегата advertiser(_:didReceiveConnectionRequestFrom:with:connectionRequestHandler:).

Swift

extension Example: AdvertiserDelegate {
  func advertiser(
    _ advertiser: Advertiser, didReceiveConnectionRequestFrom endpointID: EndpointID,
    with context: Data, connectionRequestHandler: @escaping (Bool) -> Void) {
    // Call with `true` to accept or `false` to reject the incoming connection request.
    connectionRequestHandler(true)
  }
}

После того как рекламодатель примет приглашение, обе стороны получат уведомление и должны будут подтвердить связь с помощью метода connectionManager(_:didReceive:from:verificationHandler:).

Рекомендуется, чтобы приложение проверяло подключение с помощью кода подтверждения, предоставленного методом делегата. Это позволяет пользователям убедиться, что они подключаются к нужному устройству. Оба устройства получают один и тот же код, который представляет собой короткую случайную строку. Вы сами решаете, как его проверить. Обычно для этого токен показывается на обоих устройствах, и пользователям предлагается вручную сравнить и подтвердить его, как в диалоговом окне сопряжения Bluetooth.

Swift

extension Example: ConnectionManagerDelegate {
  func connectionManager(
    _ connectionManager: ConnectionManager, didReceive verificationCode: String,
    from endpointID: EndpointID, verificationHandler: @escaping (Bool) -> Void) {
    // Optionally show the user the verification code. Your app should call this handler
    // with a value of `true` if the nearby endpoint should be trusted, or `false`
    // otherwise.
    verificationHandler(true)
  }
}

Подключение будет установлено, только когда оба пользователя примут его. Если один или оба отклонят, связь будет отменена.

В предыдущем примере показано, как соединение автоматически принимается обеими сторонами, но в зависимости от вашего варианта использования вы можете захотеть каким-то образом представить этот выбор пользователю.