माइग्रेशन के बारे में खास जानकारी

Google Play की गेम सेवाओं के लिए, games v1 एसडीके, Google Sign-In for Android पर निर्भर करता है. इसे बंद कर दिया गया है. साथ ही, इसे 2025 में Google Play services Auth SDK (com.google.android.gms:play-services-auth) से हटा दिया जाएगा. नए गेम ऐप्लिकेशन, 2025 तक Games v1 का इस्तेमाल कर सकते हैं. Google साइन-इन की सुविधा हटाने से, मौजूदा गेम ऐप्लिकेशन के लिए निर्भरता से जुड़ी समस्याएं पैदा होती हैं. मौजूदा गेम ऐप्लिकेशन को Games v1 एसडीके से Games v2 एसडीके पर माइग्रेट करने से, Google खाते से साइन इन करने की सुविधा हटाने की वजह से होने वाली डिपेंडेंसी की समस्याएं ठीक हो जाती हैं.

इस दस्तावेज़ से आपको गेम ऐप्लिकेशन और अलग-अलग एसडीके के बीच होने वाले इंटरैक्शन को समझने में मदद मिलती है. इस दस्तावेज़ में, ऐप्लिकेशन की सुविधाओं की तुलना, Play की गेम सेवाओं वाले एसडीके के v1 और v2 वर्शन की सुविधाओं से भी की गई है.

SDK टूल के इंटरैक्शन

इन डायग्राम में, Android पर मौजूद गेम ऐप्लिकेशन, Google Mobile Services (GMS) Core, Play की गेम सेवाओं, और तीसरे पक्ष (3P) के गेम सर्वर के बीच इंटरैक्शन दिखाया गया है. इसमें बताया गया है कि ऐप्लिकेशन, पुष्टि करने और गेम की सुविधाओं के लिए Google की सेवाओं का इस्तेमाल कैसे करता है. साथ ही, यह तीसरे पक्ष के किसी अन्य सिस्टम के साथ इंटरैक्ट भी करता है.

यहां कॉम्पोनेंट और एसडीके के बारे में खास जानकारी दी गई है:

• गेम के लिए आवेदन.
  • यह Android डिवाइस पर चल रहे उपयोगकर्ता के गेम ऐप्लिकेशन को दिखाता है.
  • इसमें दो मुख्य कॉम्पोनेंट होते हैं:
    • games v1 या games v2 SDK टूल. यह क्लाइंट-साइड SDK टूल, Play Games Services के साथ इंटरैक्ट करने के लिए ज़िम्मेदार होता है.
    • Auth SDK. Google Play services Auth SDK, गेम v1 में उपयोगकर्ता की पुष्टि करने और अनुमति देने के फ़्लो को मैनेज करने के लिए ज़िम्मेदार है.
  • दोनों एसडीके, AIDL (Android इंटरफ़ेस डेफ़िनिशन लैंग्वेज) का इस्तेमाल करके कम्यूनिकेट करते हैं. इससे पता चलता है कि अलग-अलग प्रोसेस या सेवाओं के बीच कम्यूनिकेशन का पैटर्न कैसा है.
• GMS Core को Google Play Services भी कहा जाता है.
  • यह Android पर Google की मालिकाना हक वाली लेयर है.
  • गेम ऐप्लिकेशन, GMS Core के दो मॉड्यूल का इस्तेमाल करता है:
    • गेम मॉड्यूल. यह गेम से जुड़ी सुविधाएं उपलब्ध कराता है. जैसे, लीडरबोर्ड, उपलब्धियां, और गेम की स्थिति मैनेज करना.
    • Auth Module. यह कुकी, उपयोगकर्ता की पुष्टि करने और अनुमति देने से जुड़ी कार्रवाइयों को मैनेज करती है.
  • गेम ऐप्लिकेशन में मौजूद Games और Auth SDK, AIDL इंटरफ़ेस का इस्तेमाल करके, संबंधित मॉड्यूल से कम्यूनिकेट करते हैं. इससे इंटर-प्रोसेस कम्यूनिकेशन (आईपीसी) का पता चलता है.

• Play Games Services का गेटवे.
  • यह एक लॉजिकल गेटवे है, जो GMS Core और Play की गेम सेवाओं के सर्वर के बीच कम्यूनिकेशन करता है.
  • यह सर्वर के साथ कम्यूनिकेशन के लिए, एपीआई अनुरोधों, डेटा ट्रांसफ़ॉर्मेशन, और पुष्टि करने की प्रोसेस को मैनेज करता है.
• Play की गेम सेवाओं का सर्वर.
  • यह Play Games की सेवाओं की बैकएंड सेवाओं को दिखाता है. ये सेवाएं, गेम का डेटा सेव करने, उपयोगकर्ता खातों को मैनेज करने, और एक से ज़्यादा खिलाड़ियों वाली सुविधाओं को उपलब्ध कराने के लिए ज़िम्मेदार होती हैं.
• तीसरे पक्ष का गेम गेटवे.
  • अगर आपका गेम ऐप्लिकेशन, तीसरे पक्ष (3P) के ऐप्लिकेशन के तौर पर ज़रूरी शर्तें पूरी करता है, तो क्लाइंट लाइब्रेरी, तीसरे पक्ष के गेम सर्वर के ज़रिए Play की गेम सेवाओं के सर्वर से कम्यूनिकेट करती है.
  • इसका मतलब है कि ऐप्लिकेशन, सेवा देने वाली किसी अन्य कंपनी से भी पुष्टि कर सकता है.
• तीसरे पक्ष का गेम सर्वर.
  • यह एक वैकल्पिक बाहरी सर्वर को दिखाता है, जिससे गेम ऐप्लिकेशन इंटरैक्ट कर सकता है. ऐसा शायद कस्टम सुविधाओं या डेटा मैनेजमेंट के लिए किया जाता है.
  • ऐप्लिकेशन के साथ कम्यूनिकेशन, तीसरे पक्ष के गेम गेटवे के ज़रिए होता है.

सुविधाओं की तुलना

इस टेबल में, games v1 और games v2 एसडीके की सुविधाओं की तुलना की गई है:

सुविधा	games v1 SDK	Games v2 SDK
पुष्टि करना	play-services-auth के साथ इंटिग्रेशन ज़रूरी है.	आसान और बेहतर; play-services-auth की ज़रूरत नहीं है.
अनुमति	सफल, असफल, और फिर से कोशिश करने के लिए अतिरिक्त कोड.	एसडीके टूल मैनेज करता है
सर्वर ऐक्सेस टोकन	GoogleSigninClient के साथ, OAuth 2.0 के अतिरिक्त स्कोप का अनुरोध कर सकता है. साइन-इन के दौरान गड़बड़ी मैनेज करने के लिए अतिरिक्त कोड.	Play की गेम सेवाओं के वेब एपीआई के लिए, सर्वर-साइड ऐक्सेस का अनुरोध करते समय, GamesSignInClient के साथ OAuth 2.0 के तीन बुनियादी आइडेंटिटी स्कोप का अनुरोध कर सकता है. ज़्यादा जानकारी के लिए, Play Games Services को सर्वर-साइड से ऐक्सेस करना और सर्वर से पुष्टि करने वाले कोड वापस पाना लेख पढ़ें.
साइन-इन करने की प्रोसेस	GoogleSigninClient का इस्तेमाल करता है. अपने-आप साइन इन होने की सुविधा और गड़बड़ी को ठीक करने के लिए, बॉयलरप्लेट कोड को मैनेज करने के लिए अतिरिक्त कोड.	GamesSignInClient का इस्तेमाल करता है. एसडीके टूल, छोटे-मोटे बदलाव वाले कोड, अपने-आप साइन इन होने की सुविधा, और गड़बड़ी ठीक करने की सुविधा को मैनेज करता है.
वेलकम पॉप-अप	ज़्यादा कोड की ज़रूरत है. डेवलपर, इसके दिखने की जगह और समय को कंट्रोल कर सकते हैं.	इसके लिए, किसी अतिरिक्त कोड की ज़रूरत नहीं होती. Games v2 SDK के साथ कॉन्फ़िगर किए गए सभी गेम में एक जैसा यूज़र इंटरफ़ेस.
डिपेंडेंसी	ज़रूरी है play-services-auth.	गेम मॉड्यूल, अनुमति देने और पुष्टि करने की प्रोसेस को मैनेज करता है. आपको कोई अन्य डिपेंडेंसी जोड़ने की ज़रूरत नहीं है.
साइन आउट करें	GoogleSignInClient.signOut का इस्तेमाल करता है.	साइन आउट करने वाले एपीआई का इस्तेमाल नहीं किया जा सकता.
Play Games की सेवाओं के एक से ज़्यादा खाते और हर गेम के लिए सेटिंग	आपके गेम में खाता मैनेज करने की सुविधा उपलब्ध है.	लोग, मोबाइल डिवाइस की सेटिंग में जाकर Play की गेम सेवाओं वाली प्रोफ़ाइल बदल सकते हैं. ज़्यादा जानकारी के लिए, मोबाइल पर Play Games प्रोफ़ाइलें स्विच करने का तरीका देखें.