Dokumen ini menjelaskan cara mulai mengembangkan aplikasi dengan Nearby Messages API di Android. Nearby Messages API adalah bagian dari layanan Google Play.
Langkah 1: Dapatkan layanan Google Play
Nearby Messages API tersedia di perangkat Android yang menggunakan layanan Google Play 7.8.0 atau yang lebih tinggi. Perangkat yang menjalankan Android 2.3 atau lebih tinggi dan memiliki aplikasi Google Play Store akan otomatis menerima update layanan Google Play. Untuk memeriksa versi layanan Google Play yang terinstal di perangkat Anda, buka Setelan > Aplikasi > Layanan Google Play.
Pastikan Anda memiliki library klien terbaru untuk layanan Google Play di host pengembangan:
- Buka Android SDK Manager.
Di bagian Appearance & Behavior > System Settings > Android SDK > SDK Tools, pastikan paket berikut telah diinstal:
- Layanan Google Play
- Repositori Google
Langkah 2: Dapatkan Akun Google
Untuk menggunakan Nearby Messages API, Anda memerlukan Akun Google. Dengan begitu, Anda, sebagai developer, dapat mengaktifkan Nearby API di langkah berikutnya (pengguna tidak perlu memiliki Akun Google). Jika sudah memiliki akun, Anda sudah siap. Sebaiknya Anda juga membuat Akun Google terpisah untuk tujuan pengujian.
Langkah 3: Mendapatkan kunci API
Lakukan langkah-langkah berikut untuk mengaktifkan Google Nearby Messages API untuk Android dan mendapatkan kunci API:
- Buka Google Developers Console.
- Buat atau pilih project untuk mendaftarkan aplikasi Anda.
- Klik Continue untuk Mengaktifkan API.
- Pada halaman Credentials, buat kunci Android baru (dan tetapkan Credentials
API).
Catatan: Jika Anda sudah memiliki kunci Android, Anda dapat menggunakan kunci tersebut. - Pada dialog yang muncul, masukkan sidik jari SHA-1
dan nama paket aplikasi Anda. Contoh:
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
com.example.android.nearbyexample
- Kunci API Android Anda yang baru akan muncul dalam daftar kunci API untuk project.
Kunci API adalah string karakter, seperti ini:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
Dapatkan sidik jari SHA1 sertifikat Anda
Untuk membuat kunci API baru untuk aplikasi Android, Anda memerlukan sidik jari SHA1 dari sertifikat yang Anda gunakan untuk menandatangani APK. Pesan hanya dapat dipertukarkan antar-aplikasi yang ditandatangani dengan kunci API dari project yang sama.
Untuk mendapatkan sidik jari ini:
- Temukan lokasi keystore Anda.
- Di terminal, jalankan utilitas
keytool
dari JDK. Misalnya, jika Anda menggunakan keystore`debug`
: - Output perintah
keytool
berisi sidik jari SHA1 untuk sertifikat tersebut.
$ keytool -alias \ androiddebugkey -keystore \ ~/.android/debug.keystore -list -v
Catatan: Untuk keystore debug, sandinya adalah
android
. Di Mac OS dan Linux, keystore debug biasanya
berada di ~/.android/
. Di Windows, biasanya
lokasi di %USERPROFILE%\
.
Langkah 4: Konfigurasikan project Anda
Android Studio memudahkan
pembuatan project untuk Nearby Messages API. Ikuti langkah-langkah yang dijelaskan dalam Membuat Project untuk membuat project baru. Di Android Studio, buka file build.gradle
untuk
modul dan tambahkan library klien layanan Google Play sebagai dependensi:
apply plugin: 'android' ... dependencies { compile 'com.google.android.gms:play-services-nearby:19.1.0' }
Kemudian, konfigurasi manifes Anda dengan Kunci API yang dihasilkan pada langkah sebelumnya:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.google.sample.app" >
<application ...>
<meta-data
android:name="com.google.android.nearby.messages.API_KEY"
android:value="API_KEY" />
<activity>
...
</activity>
</application>
</manifest>
Langkah 5: Memublikasikan dan berlangganan
Di aplikasi Anda, mulai gunakan Nearby Messages API.
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
...
mMessageListener = new MessageListener() {
@Override
public void onFound(Message message) {
Log.d(TAG, "Found message: " + new String(message.getContent()));
}
@Override
public void onLost(Message message) {
Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
}
}
mMessage = new Message("Hello World".getBytes());
}
@Override
public void onStart() {
super.onStart();
...
Nearby.getMessagesClient(this).publish(mMessage);
Nearby.getMessagesClient(this).subscribe(mMessageListener);
}
@Override
public void onStop() {
Nearby.getMessagesClient(this).unpublish(mMessage);
Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
...
super.onStop();
}
Nearby Messages API memerlukan izin pengguna. Saat publikasikan atau berlangganan pertama kali dipanggil, fitur Di Sekitar akan menampilkan dialog keikutsertaan.