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

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

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

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

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

games v2 (मौजूदा)

Android, GMS Core, Play Games Services, और तीसरे पक्ष (3P) के गेम सर्वर पर मौजूद गेम ऐप्लिकेशन के बीच इंटरैक्शन.
Android, GMS Core, Play की गेम सेवाओं, और तीसरे पक्ष (3P) के गेम सर्वर पर मौजूद गेम ऐप्लिकेशन के बीच इंटरैक्शन. (ज़्यादा जानकारी के लिए इमेज पर क्लिक करें).

games v1 (लेगसी)

Android, GMS Core, Play Games Services, और तीसरे पक्ष (3P) के गेम सर्वर पर मौजूद गेम ऐप्लिकेशन के बीच इंटरैक्शन.
Android, GMS Core, Play Games Services, और तीसरे पक्ष (3P) के गेम सर्वर पर मौजूद गेम ऐप्लिकेशन के बीच इंटरैक्शन. (ज़्यादा जानकारी के लिए इमेज पर क्लिक करें).

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

  • गेम के लिए आवेदन.
    • यह Android डिवाइस पर चल रहे उपयोगकर्ता के गेम ऐप्लिकेशन को दिखाता है.
    • इसमें दो मुख्य कॉम्पोनेंट होते हैं:
      • games v1 या games v2 SDK. क्लाइंट-साइड एसडीके, Play की गेम सेवाओं के साथ इंटरैक्ट करने के लिए ज़िम्मेदार होता है.
      • 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 SDK की सुविधाओं की तुलना की गई है:


सुविधा

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 Games Services की प्रोफ़ाइल बदल सकते हैं. ज़्यादा जानकारी के लिए, मोबाइल पर Play Games प्रोफ़ाइलें स्विच करने का तरीका देखें.