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 penghubung unik dalam waktu antara perangkat. Server memfasilitasi pertukaran pesan antara perangkat yang mendeteksi kode penghubung yang sama. Saat perangkat mendeteksi kode penghubung dari perangkat di sekitar, perangkat tersebut akan mengirimkan kode penghubung ke server Nearby Messages untuk validasi, 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 pertukaran data yang tepat 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 pairing unik dalam waktu (token). Server membuat kaitan sementara antara payload pesan dan token.

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

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

  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 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 bagian spesifik perangkat dan regional.
  • Publikasi Nearby Messages: 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.