Ringkasan

Nearby Messages API adalah API publish-subscribe yang memungkinkan Anda meneruskan payload biner kecil antara perangkat Android dan iOS yang terhubung ke internet. Perangkat tidak harus berada di jaringan yang sama, tetapi harus terhubung ke Internet.

Nearby menggunakan Bluetooth Hemat Energi untuk mengomunikasikan kode penyambungan unik dalam waktu antarperangkat. Server memfasilitasi pertukaran pesan antara perangkat yang mendeteksi kode penyambungan yang sama. Saat mendeteksi kode penyambungan dari perangkat di sekitar, perangkat akan mengirimkan kode penyambungan ke server Nearby Messages untuk divalidasi, dan untuk memeriksa apakah ada pesan yang akan dikirimkan untuk kumpulan langganan aplikasi saat ini.

Nearby Messages tidak diautentikasi dan tidak memerlukan Akun Google.

Mekanisme persis untuk pertukaran data dapat bervariasi dari rilis ke rilis. Urutan berikut menunjukkan peristiwa yang menyebabkan pertukaran pesan:

  1. Aplikasi penerbit membuat permintaan untuk mengaitkan payload biner (pesan) dengan kode penyambungan yang unik dalam waktu (token). Server membuat asosiasi sementara antara payload pesan dan token.

  2. Perangkat penerbit menggunakan Bluetooth Hemat Energi untuk membuat token dapat dideteksi oleh perangkat di sekitar. Perangkat penerbit juga menggunakan Bluetooth Hemat Energi untuk memindai token dari perangkat lain.

  3. Aplikasi yang berlangganan mengaitkan langganannya dengan token dan menggunakan Bluetooth Hemat Energi untuk mengirimkan tokennya ke penerbit, dan untuk mendeteksi token penerbit.

  4. Saat salah satu pihak mendeteksi token pihak lain, pihak tersebut akan melaporkannya ke server.

  5. Server memfasilitasi pertukaran pesan antara dua perangkat saat keduanya dikaitkan dengan token yang sama, dan kunci API yang digunakan oleh aplikasi yang memanggil dikaitkan dengan project yang sama di Google Developers Console.

Saat menggunakan Nearby SDK layanan Google Play, analisis penggunaan dikumpulkan untuk meningkatkan kualitas pengalaman.

  • Metrik performa: Durasi publikasi dan langganan serta jumlah pesan yang diterima dikumpulkan saat menggunakan Nearby SDK.
  • Informasi perangkat: Model perangkat, negara, versi build, dan nama paket aplikasi dikumpulkan dan dikaitkan dengan metrik performa untuk mengidentifikasi slice spesifik per perangkat dan regional.
  • Nearby Messages memublikasikan: Data yang dipublikasikan melalui Nearby Messages disimpan oleh Google hingga pesan tidak lagi dipublikasikan. Data ini dibagikan kepada pelanggan yang berada di dekat perangkat.

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