Ringkasan

Nearby Messages API adalah API publikasi-langganan 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 yang unik tepat waktu antar-perangkat. Server memfasilitasi pertukaran pesan antarperangkat 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 memeriksa apakah ada pesan yang akan dikirim untuk rangkaian langganan aplikasi saat ini.

Nearby Messages tidak diautentikasi dan tidak memerlukan Akun Google.

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

  1. Aplikasi publikasi membuat permintaan untuk mengaitkan payload biner (pesan) dengan kode penyambungan unik-in-time (token). Server membuat pengaitan sementara antara payload pesan dan token.

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

  3. Aplikasi yang berlangganan mengaitkan langganannya dengan token dan menggunakan Bluetooth Low Energy untuk mengirim tokennya ke penayang, serta untuk mendeteksi token penayang.

  4. Ketika salah satu sisi mendeteksi token pihak lain, kedua belah pihak melaporkannya ke server.

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

Saat menggunakan Nearby SDK layanan Google Play, analisis penggunaan dikumpulkan untuk meningkatkan 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 regional dan khusus perangkat.
  • 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 data ini dengan membuka Setelan > Google > Penggunaan & diagnostik.