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.

Fitur Di Sekitar menggunakan Bluetooth Hemat Energi untuk mengomunikasikan kode penyambungan unik dalam waktu antar-perangkat. Server memfasilitasi pertukaran pesan antar-perangkat yang mendeteksi kode penyambungan yang sama. Jika mendeteksi kode penghubung dari perangkat di sekitar, perangkat akan mengirimkan kode penyambungan ke server Nearby Messages untuk divalidasi, dan memeriksa apakah ada pesan yang akan dikirimkan untuk rangkaian langganan aplikasi saat ini.

Nearby Messages tidak diautentikasi dan tidak memerlukan Akun Google.

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

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

  2. Perangkat penayang menggunakan Bluetooth Hemat Energi agar token dapat terdeteksi oleh perangkat di sekitar. Perangkat penayang 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 mengirim tokennya ke penerbit, serta untuk mendeteksi token penayang.

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

  5. Server memfasilitasi pertukaran pesan antara dua perangkat saat keduanya dikaitkan dengan token 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 akan 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 akan disimpan oleh Google hingga pesan tidak dipublikasikan lagi. 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.