Mengelola koneksi

Memulai koneksi

Saat perangkat di sekitar ditemukan, penemu dapat memulai koneksi. Contoh berikut meminta koneksi dengan perangkat segera setelah perangkat ditemukan.

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.
  }
}

Bergantung pada kasus penggunaan, Anda mungkin ingin menampilkan daftar perangkat yang ditemukan kepada pengguna, sehingga mereka dapat memilih perangkat yang akan dihubungkan.

Menerima atau menolak koneksi

Setelah penemu meminta koneksi ke pengiklan, pengiklan akan diberi tahu tentang permintaan koneksi melalui metode delegasi 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)
  }
}

Setelah pengiklan menyetujui, kedua belah pihak akan diberi tahu dan harus memverifikasi koneksi melalui metode delegasi connectionManager(_:didReceive:from:verificationHandler:).

Sebaiknya aplikasi Anda memverifikasi koneksi menggunakan kode verifikasi yang disediakan oleh metode delegasi. Hal ini memberikan cara untuk memungkinkan pengguna mengonfirmasi bahwa mereka terhubung ke perangkat yang diinginkan. Kedua perangkat diberi kode yang sama, yang merupakan string acak pendek; terserah Anda untuk memutuskan cara memverifikasinya. Biasanya, hal ini melibatkan menampilkan token di kedua perangkat dan meminta pengguna untuk membandingkan dan mengonfirmasi secara manual, mirip dengan dialog penyambungan 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)
  }
}

Koneksi akan sepenuhnya dibuat hanya jika kedua belah pihak telah menyetujui. Jika salah satu atau keduanya menolak, koneksi akan dihapus.

Contoh sebelumnya menunjukkan koneksi yang otomatis diterima oleh kedua pihak, tetapi bergantung pada kasus penggunaan, Anda mungkin ingin menampilkan pilihan ini kepada pengguna dengan cara tertentu.