Android Uygulaması

Aşağıdaki örnekler, örnek kimliğini bir Android istemcisinde uygulamanıza yardımcı olur. Bu örneklerde, Google Cloud Messaging kullanımdan kaldırıldığından yalnızca gösterim amacıyla yararlı olan GCM kapsamının kullanıldığını unutmayın.

Google Play Hizmetleri'ni kurun

İstemci uygulamanızı yazmak için Google Play Hizmetleri SDK'sını kurma bölümünde açıklandığı şekilde Google Play Hizmetleri SDK'sını kullanın. Play Hizmetleri Kitaplığı, Örnek Kimliği kitaplığını içerir.

Örnek Kimliği Alma

Aşağıdaki kod satırı bir Örnek Kimliği döndürür:

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

Jeton oluştur

Jeton oluşturmak için Google Developers Console tarafından oluşturulan bir proje kimliği gerekir.

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);

Jetonları ve örnek kimliklerini yönetme

Örnek kimliği, jetonları silmenize ve yenilemenize olanak tanır.

Jetonları ve örnek kimliklerini silme

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

Ayrıca, ilişkili tüm jetonlar dahil olmak üzere örnek kimliğini de silebilirsiniz. getInstance() numaralı telefonu bir sonraki aramanızda yeni bir örnek kimliği alacaksınız:

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

Jetonları yenile

Örnek Kimliği hizmeti, düzenli aralıklarla (örneğin, 6 ayda bir) geri çağırma yaparak uygulamanızın jetonlarını yenilemesini ister. Aşağıdaki durumlarda da geri çağırmalar başlatabilir:

• Güvenlik sorunları (ör. SSL veya platform sorunları) varsa
• Cihaz bilgileri artık geçerli değil (ör. yedekleme ve geri yükleme).
• Aksi takdirde Örnek Kimliği hizmeti etkilenir.

Bu geri çağırmaları almak için uygulamanızda Örnek Kimliği dinleyici hizmetini uygulayın:

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
    }
  }
};

Bu hizmeti projenin Manifest dosyasında da yapılandırmanız gerekir:

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