Mengelola koneksi

Memulai koneksi

Saat perangkat di sekitar ditemukan, penemu dapat memulai koneksi. Contoh berikut meminta koneksi dengan perangkat segera setelah 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 disambungkan.

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 menerima, kedua pihak akan diberi tahu dan harus memverifikasi koneksi melalui metode delegasi connectionManager(_:didReceive:from:verificationHandler:).

Sebaiknya aplikasi Anda memverifikasi koneksi menggunakan kode verifikasi yang diberikan oleh metode delegasi. Hal ini memberikan cara untuk memungkinkan pengguna mengonfirmasi bahwa mereka terhubung ke perangkat yang dimaksud. Kedua perangkat diberi kode yang sama, yang merupakan string acak pendek; Anda yang memutuskan cara memverifikasinya. Biasanya, hal ini melibatkan penayangan 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 sisi telah menerima. Jika salah satu atau keduanya menolak, koneksi akan dibatalkan.

Contoh di atas menunjukkan koneksi yang diterima secara otomatis oleh kedua belah pihak, tetapi bergantung pada kasus penggunaan, Anda mungkin ingin menyajikan pilihan ini kepada pengguna dengan cara tertentu.