Ringkasan

Nearby Connections adalah API jaringan peer-to-peer yang memungkinkan aplikasi menemukan, menghubungkan, dan bertukar data dengan mudah di perangkat di sekitar secara real-time, terlepas dari konektivitas jaringan.

Beberapa contoh kasus penggunaan:

  • Papan tulis kolaboratif: Catat ide dengan peserta di sekitar papan tulis virtual bersama.
  • Game multiplayer lokal: Siapkan game multiplayer dan undang pengguna lain di sekitar untuk bergabung.
  • Game multilayar: Gunakan ponsel atau tablet sebagai pengontrol game untuk memainkan game yang ditampilkan pada perangkat Android layar besar di sekitar, seperti Android TV.
  • Transfer file offline: Membagikan foto, video, atau jenis data lainnya dengan cepat dan tanpa memerlukan koneksi jaringan.

Pengantar

Nearby Connections memungkinkan iklan, penemuan, dan koneksi antar-perangkat di sekitar dengan cara peer-to-peer yang sepenuhnya offline. Koneksi antar-perangkat memiliki bandwidth tinggi, latensi rendah, dan dienkripsi sepenuhnya untuk memungkinkan transfer data yang cepat dan aman.

Tujuan utama API ini adalah untuk menyediakan platform yang sederhana, andal, dan berperforma tinggi. Di balik layar, API menggunakan kombinasi teknologi Bluetooth, BLE, dan Wi-Fi, yang memanfaatkan kekuatan masing-masing API dengan menghindari kelemahannya masing-masing. Ini secara efektif memisahkan kelancaran Bluetooth dan Wi-Fi di berbagai platform dan versi OS, sehingga developer dapat berfokus pada fitur yang penting bagi pengguna.

Ringkasan API

Penggunaan API dibagi menjadi dua fase: pra-koneksi, dan pasca-koneksi.

Pada fase pra-koneksi, Pengiklan mengiklankan dirinya sendiri, sementara Discoverers menemukan Pengiklan di sekitar dan mengirim permintaan koneksi. Permintaan koneksi dari Discoverer ke Pengiklan memulai alur autentikasi simetris yang menyebabkan kedua belah pihak menerima (atau menolak) permintaan koneksi secara independen.

Setelah permintaan koneksi disetujui oleh kedua belah pihak, koneksi dianggap telah terbentuk dan perangkat memasuki fase pasca-koneksi, yang selama itu kedua belah pihak dapat bertukar data.

Iklan dan penemuan

Pengiklan akan terlihat oleh penemuan lain dan penemu akan diberi tahu saat pengiklan baru ditemukan atau telah hilang.

Membuat sambungan

Saat penemu ingin terhubung ke pengiklan di sekitar, penemunya dapat meminta koneksi.

Kedua belah pihak akan diberi tahu tentang proses inisiasi koneksi dan keduanya akan memiliki kesempatan untuk menerima atau menolak koneksi.

Setelah kedua pihak merespons, masing-masing akan diberi tahu hasilnya. Jika kedua sisi menerima koneksi, koneksi dianggap sudah stabil, dan transfer data dapat dimulai.

Bertukar data

Setelah koneksi dibuat, penggunaan API lebih lanjut bersifat simetris, sehingga tidak ada lagi perbedaan antara Pengiklan dan Discoverer.

Kedua belah pihak kini dapat bertukar data. Ada 3 jenis Payload yang didukung:

  • Byte: Array byte dibatasi hingga 32 ribu; ini bagus untuk mengirim berbagai hal seperti metadata atau pesan kontrol.
  • File: File dalam berbagai ukuran; file ini ditransfer dari aplikasi ke antarmuka jaringan dengan penyalinan minimal ke seluruh batas proses.
  • Aliran: Aliran data yang dihasilkan dengan cepat, seperti dalam audio/video yang direkam, tanpa ukuran akhir yang diketahui sebelumnya.

Penerima akan diberi tahu tentang data baru yang masuk dan setiap pembaruan progres, pembatalan, atau kegagalan.

Koneksi yang terbentuk bersifat full-duplex, artinya pengiklan dan penemu dapat mengirim dan menerima data secara bersamaan.

Pengumpulan Data

Saat menggunakan SDK Langsung layanan Google Play, analisis penggunaan akan dikumpulkan untuk meningkatkan pengalaman Anda.

  • Metrik performa: Latensi penemuan dan koneksi, keandalan, dan throughput dikumpulkan saat memindai dan menghubungkan ke perangkat menggunakan SDK Di Sekitar.
  • Informasi perangkat: Model perangkat, negara, versi build, dan nama paket aplikasi dikumpulkan dan dikaitkan dengan metrik performa untuk mengidentifikasi bagian khusus perangkat dan regional.

Pengguna akhir dapat mengizinkan atau menolak koleksi ini dengan membuka Setelan > Google > Penggunaan & diagnostik.