Implementasi Android

Contoh berikut akan membantu Anda menerapkan ID Instance di klien Android. Perhatikan bahwa contoh ini menggunakan cakupan GCM, yang hanya berguna untuk tujuan demonstrasi karena Google Cloud Messaging sudah tidak digunakan lagi.

Siapkan Layanan Google Play

Untuk menulis aplikasi klien Anda, gunakan SDK layanan Google Play, seperti yang dijelaskan dalam Menyiapkan SDK Layanan Google Play. Library Layanan Play menyertakan library Instance ID.

Mendapatkan ID Instance

Baris kode berikut menampilkan ID Instance:

String iid = InstanceID.getInstance(context).getId();

Membuat token

Pembuatan token memerlukan Project ID yang dibuat oleh Google Developers Console.

String authorizedEntity = PROJECT_ID; // Project id from Google Developer Console
String scope = "GCM"; // e.g. communicating using GCM, but you can use any
                      // URL-safe characters up to a maximum of 1000, or
                      // you can also leave it blank.
String token = InstanceID.getInstance(context).getToken(authorizedEntity,scope);

Mengelola token dan ID Instance

ID instance memungkinkan Anda menghapus dan memuat ulang token.

Menghapus token dan ID Instance

String authorizedEntity = PROJECT_ID;
String scope = "GCM";
InstanceID.getInstance(context).deleteToken(authorizedEntity,scope);

Anda juga dapat menghapus ID Instance itu sendiri, termasuk semua token terkait. Saat berikutnya memanggil getInstance(), Anda akan mendapatkan ID Instance baru:

InstanceID.getInstance(context).deleteInstanceID();
String newIID = InstanceID.getInstance(context).getId();

Catatan: Jika aplikasi Anda menggunakan token yang dihapus oleh deleteInstanceID, aplikasi Anda harus membuat token pengganti.

Token refresh

Layanan ID Instance memulai callback secara berkala (misalnya, setiap 6 bulan), yang meminta aplikasi Anda untuk memperbarui tokennya. Kode ini juga dapat memulai callback saat:

• Ada masalah keamanan; misalnya, masalah SSL atau platform.
• Informasi perangkat tidak lagi valid; misalnya, pencadangan dan pemulihan.
• Jika tidak, layanan ID Instance akan terpengaruh.

Terapkan layanan pemroses ID Instance di aplikasi Anda untuk menerima callback ini:

public class MyInstanceIDService extends InstanceIDListenerService {
  public void onTokenRefresh() {
    refreshAllTokens();
  }

  private void refreshAllTokens() {
    // assuming you have defined TokenList as
    // some generalized store for your tokens
    ArrayList<TokenList> tokenList = TokensList.get();
    InstanceID iid = InstanceID.getInstance(this);
    for(tokenItem : tokenList) {
      tokenItem.token =
        iid.getToken(tokenItem.authorizedEntity,tokenItem.scope,tokenItem.options);
      // send this tokenItem.token to your server
    }
  }
};

Anda juga harus mengonfigurasi layanan ini dalam file Manifes untuk project:

<service android:name=".MyInstanceIDService" android:exported="false">
  <intent-filter>
        <action android:name="com.google.android.gms.iid.InstanceID"/>
  </intent-filter>
</service>