Android कोड को लागू करना

नीचे दिए गए उदाहरण, Android क्लाइंट में इंस्टेंस आईडी लागू करने में आपकी मदद करेंगे. ध्यान दें कि ये उदाहरण GCM दायरे का इस्तेमाल करते हैं, जो सिर्फ़ जानकारी देने के मकसद से काम करता है. ऐसा इसलिए है, क्योंकि Google क्लाउड से मैसेज को इस्तेमाल से बाहर कर दिया गया है.

Google Play services सेट अप करें

अपना क्लाइंट ऐप्लिकेशन लिखने के लिए, Google Play services का SDK टूल इस्तेमाल करें. इसका तरीका जानने के लिए, Google Play services SDK टूल सेट अप करें पर जाएं. Play Services लाइब्रेरी में इंस्टेंस आईडी लाइब्रेरी शामिल होती है.

इंस्टेंस आईडी पाना

कोड की इस लाइन से एक इंस्टेंस आईडी मिलता है:

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

टोकन जनरेट करना

टोकन जनरेट करने के लिए, 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);

टोकन और इंस्टेंस आईडी मैनेज करना

इंस्टेंस आईडी की मदद से, टोकन मिटाए और रीफ़्रेश किए जा सकते हैं.

टोकन और इंस्टेंस आईडी मिटाएं

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

आपके पास इंस्टेंस आईडी को मिटाने का विकल्प भी होता है. इसमें, उससे जुड़े सभी टोकन भी शामिल हैं. अगली बार getInstance() को कॉल करने पर आपको एक नया इंस्टेंस आईडी मिलेगा:

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

टोकन रीफ़्रेश करें

इंस्टेंस आईडी सेवा समय-समय पर (उदाहरण के लिए, हर छह महीने में) कॉलबैक शुरू करती है. साथ ही, यह अनुरोध करती है कि आपका ऐप्लिकेशन अपने टोकन को रीफ़्रेश करे. यह कॉलबैक भी शुरू कर सकता है, जब:

  • इसमें सुरक्षा से जुड़ी समस्याएं होती हैं, जैसे कि एसएसएल या प्लैटफ़ॉर्म से जुड़ी समस्याएं.
  • डिवाइस की जानकारी अब मान्य नहीं है; उदाहरण के लिए, बैकअप लेना और डेटा वापस पाना.
  • हालांकि, इंस्टेंस आईडी की सेवा पर कोई असर नहीं पड़ता है.

इन कॉलबैक को पाने के लिए, अपने ऐप्लिकेशन में इंस्टेंस आईडी लिसनर सेवा लागू करें:

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

आपको इस सेवा को प्रोजेक्ट के लिए, मेनिफ़ेस्ट फ़ाइल में भी कॉन्फ़िगर करना होगा:

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