Panduan Developer

Panduan berikut akan membantu Anda membuat aplikasi berkualitas tinggi dengan Nearby Messages API dan Nearby Connections API.

Menghormati privasi pengguna

• Bantu pengguna memahami data apa yang akan diekspos aplikasi Anda kepada pengguna di sekitar.

• Jangan memublikasikan informasi sensitif seperti sandi dan nomor kartu kredit. Sebagai gantinya, teruskan token otorisasi atau ID transaksi.

Mewajibkan tindakan eksplisit yang dimulai pengguna untuk memulai Nearby

• Jangan mengejutkan pengguna. Mewajibkan pengguna melakukan tindakan eksplisit (ketukan tombol, membuka bagian di aplikasi Anda, pengalih khusus, dll.) untuk mengaktifkan Nearby.

• Di iOS dan Android, memanggil Nearby untuk pertama kalinya akan memicu dialog izin dari Nearby. Menunggu tindakan pengguna yang eksplisit sebelum memanggil Nearby akan membantu pengguna mengontekstualisasikan dialog dan mengaitkannya dengan fitur berbasis kedekatan aplikasi Anda.

Perhatikan penggunaan baterai

Penggunaan radio dan sensor oleh Nearby akan menyebabkan aplikasi Anda mengonsumsi baterai dengan kecepatan 2,5-3,5 kali lipat dari kecepatan normal. Untuk mengurangi penggunaan baterai, perhatikan rekomendasi berikut.

• Di Android, saat memublikasikan atau berlangganan dengan perangkat non-BLE, panggil Nearby Messages API hanya dari Aktivitas, dan hanya jalankan Aktivitas tersebut saat layar aktif dan aplikasi Anda berada di latar depan. Untuk melakukannya, teruskan Aktivitas sebagai argumen ke parameter Context dari Nearby.getMessagesClient(). Memanggil Nearby dari Layanan hanya didukung saat berlangganan pesan beacon Bluetooth Hemat Energi (BLE).

• Di Android, dalam callback Activity.onStop() aplikasi Anda, panggil Nearby.getMessagesClient(Activity).unpublish() dan Nearby.getMessagesClient(Activity).unsubscribe() pada setiap publikasi atau langganan yang aktif. Di iOS, tidak ada tindakan yang diperlukan karena hal ini ditangani secara otomatis.

• Permudah pengguna untuk menghentikan publikasi dan langganan aktif.

• Jangan memublikasikan atau berlangganan di latar belakang tanpa sepengetahuan pengguna.

Menggunakan branding yang tepat

• Kami telah menyediakan serangkaian aset standar yang dapat Anda gunakan untuk merepresentasikan Nearby di aplikasi Anda. Gunakan hanya ikon yang disetujui berikut saat merujuk ke Nearby.

• Aset PNG

• Aset SVG