Mulai

Dokumen ini menjelaskan cara memulai pengembangan 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 dengan Layanan Google Play 7.8.0 atau yang lebih tinggi. Perangkat yang menjalankan Android 2.3 atau lebih tinggi yang dilengkapi dengan Aplikasi Play Store otomatis menerima update untuk layanan Google Play. Untuk memeriksa versi layanan Google Play mana yang terinstal di perangkat Anda, buka Setelan > Aplikasi > Layanan Google Play.

Pastikan Anda memiliki library klien terbaru untuk layanan Google Play di host pengembangan:

  1. Buka Android SDK Manager.

  2. Di bagian Tampilan & Perilaku > Setelan Sistem > SDK Android > SDK Tools, pastikan paket berikut telah diinstal:

    • Layanan Google Play
    • Repositori Google

Langkah 2: Buat Akun Google

Untuk menggunakan Nearby Messages API, Anda memerlukan Akun Google. Hal ini dilakukan agar Anda, sebagai developer, dapat mengaktifkan Nearby API pada (pengguna Anda tidak perlu memiliki Akun Google). Jika sudah memiliki akun, Anda sudah siap. Anda mungkin juga ingin Akun Google terpisah untuk tujuan pengujian.

Langkah 3: Mendapatkan kunci API

Lakukan langkah-langkah berikut untuk mengaktifkan Google Nearby Messages API untuk Android dan kunci API:

  1. Buka Konsol Google Developers.
  2. Buat atau pilih project untuk mendaftarkan aplikasi Anda.
  3. Klik Continue untuk Mengaktifkan API.
  4. Di halaman Credentials, buat kunci Android baru (dan setel API) Kredensial).
    Catatan: Jika sudah memiliki kunci Android, Anda dapat menggunakan kunci tersebut.
  5. Pada dialog yang muncul, masukkan sidik jari SHA-1 aplikasi Anda dan nama paket. 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
  6. Kunci API Android Anda yang baru akan muncul dalam daftar kunci API untuk project Anda. Kunci API adalah string karakter, seperti ini: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Dapatkan sidik jari SHA1 sertifikat Anda

Untuk membuat kunci API baru bagi aplikasi Android, Anda memerlukan sidik jari SHA1 sertifikat yang Anda gunakan untuk menandatangani APK. Pesan hanya dapat dipertukarkan di antara aplikasi yang ditandatangani dengan kunci API dari project yang sama.

Untuk mendapatkan sidik jari ini:

  1. Temukan lokasi keystore Anda.
  2. Di terminal, jalankan utilitas keytool dari JDK. Sebagai misalnya, jika Anda menggunakan keystore `debug`:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    Catatan: Untuk keystore debug, sandinya adalah android. Di Mac OS dan Linux, keystore debug biasanya yang berlokasi di ~/.android/debug.keystore. Di Windows, merupakan biasanya berlokasi di %USERPROFILE%\.android\debug.keystore.

  3. Output perintah keytool berisi SHA1 sidik jari untuk sertifikat.

Langkah 4: Konfigurasikan project Anda

Android Studio membuatnya mempermudah pembuatan project untuk Nearby Messages API. Ikuti langkah-langkah yang dijelaskan dalam Membuat Project untuk membuat proyek baru. Di Android Studio, buka file build.gradle untuk modul Anda dan tambahkan library klien layanan Google Play sebagai dependensi:

apply plugin: 'android'
...

dependencies {
    compile 'com.google.android.gms:play-services-nearby:19.3.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. Kapan publikasi atau langganan dipanggil terlebih dahulu, Nearby akan menampilkan dialog keikutsertaan.