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

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

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

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

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

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

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

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

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

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

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