Google Sign-In API को बंद कर दिया गया है. इसलिए, हम 2026 में Games v1 एसडीके को हटा रहे हैं. फ़रवरी 2025 के बाद, Google Play पर ऐसे गेम पब्लिश नहीं किए जा सकेंगे जो Games v1 एसडीके के साथ अभी-अभी इंटिग्रेट किए गए हैं. हमारा सुझाव है कि आप इसके बजाय, Games v2 SDK का इस्तेमाल करें.
गेम के v1 इंटिग्रेशन वाले मौजूदा टाइटल, कुछ सालों तक काम करते रहेंगे. हालांकि, हमारा सुझाव है कि आप जून 2025 से v2 पर माइग्रेट करें.
यह गाइड, Play की गेम सेवाओं के v1 एसडीके का इस्तेमाल करने के लिए है. SDK टूल के नए वर्शन के बारे में जानने के लिए, v2 का दस्तावेज़ देखें.
Play की गेम सेवाओं में साइन इन करने से, आपको खिलाड़ी की गेमिंग आइडेंटिटी मिलती है. यह Android पर गेम खेलने वाले लोगों के लिए, प्लैटफ़ॉर्म लेवल की गेमिंग आइडेंटिटी होती है. इस पहचान से, आपके गेम और उसे खेलने वाले व्यक्ति के बीच संबंध बनाने में मदद मिलती है. खिलाड़ी, साइन इन करने के लिए इस आइडेंटिटी का इस्तेमाल करने में ज़्यादा दिलचस्पी दिखाते हैं. ऐसा वे किसी अन्य सेंट्रलाइज़्ड सिस्टम के मुकाबले ज़्यादा करते हैं.
इसके अलावा, साइन-इन करने से आपको एक मज़बूत और लगातार काम करने वाला आइडेंटिफ़ायर मिलता है. इसका इस्तेमाल, क्लाउड सेव सिस्टम के लिए कुंजी के तौर पर किया जा सकता है. क्लाउड सेव की सुविधा बहुत काम की होती है. इससे खिलाड़ियों को ये काम करने में मदद मिलती है:
- डिवाइस बदलने या रीसेट करने पर, उन्हें वहीं से शुरू करने का विकल्प मिलता है जहां उन्होंने छोड़ा था
- गेम को एक से ज़्यादा डिवाइसों पर खेलना. जैसे, किसी दूसरे फ़ोन या Chromebook पर
- गेम को अनइंस्टॉल करके फिर से इंस्टॉल करना
Play Games Services की पहचान को अपने क्लाउड सेव करने के समाधान के लिए कुंजी के तौर पर इस्तेमाल किया जा सकता है. इसके अलावा, सेव किए गए गेम की सेवा का इस्तेमाल मुफ़्त में किया जा सकता है.
Play Games की सेवाओं (पीजीएस) में, अपने-आप साइन इन होने की सुविधा काम करती है. इससे, खिलाड़ी बिना किसी रुकावट के आसानी से साइन इन कर पाते हैं. साथ ही, इसमें मैन्युअल तरीके से साइन इन करने की सुविधा भी मिलती है. इसके लिए, उन्हें सिर्फ़ एक बार क्लिक करना होता है. इस दस्तावेज़ में, साइन इन करने के इन अलग-अलग तरीकों के बारे में बताया गया है.
साइन इन करने का सुझाया गया फ़्लो
खिलाड़ियों को अपने गेम में साइन इन कराने के लिए, साइन इन करने का यह तरीका अपनाएं:
- गेम शुरू होने के दौरान, अपने-आप साइन इन होने की सुविधा आज़माएं. इससे खिलाड़ी अपने-आप साइन इन हो जाएगा.
- अगर अपने-आप साइन इन होने की सुविधा काम नहीं करती है और उपयोगकर्ता का डिवाइस ऑनलाइन है, तो मैन्युअल तरीके से साइन इन करें.
- अगर मैन्युअल तरीके से साइन इन करने का अनुरोध अस्वीकार कर दिया जाता है, तो उपयोगकर्ता की पसंद को याद रखें और उसे फिर से मैन्युअल तरीके से साइन इन करने का विकल्प न दिखाएं. हालांकि, स्टार्टअप पर अपने-आप साइन इन होने की सुविधा को चालू रखने की कोशिश करें.
इसके अलावा, आपको यह भी पक्का करना होगा कि लोग, Play की गेम सेवाओं वाले खाते से आपके गेम में साइन इन कर पाएं. इसके लिए, आपको एक बटन उपलब्ध कराना होगा, जो आसानी से मिल जाए.
अपने-आप साइन इन होने की सुविधा
अपने-आप साइन-इन होने की सुविधा की मदद से, लोग बिना किसी रुकावट के आपके गेम में साइन इन कर सकते हैं. यह सुविधा अपने-आप काम करती है! अगर आपका गेम, उपयोगकर्ता से साइन इन करने का अनुरोध करता है और Google Play Games ऐप्लिकेशन में, अपने-आप साइन इन होने की सेटिंग चालू है, तो आपको उपयोगकर्ता के PGS आइडेंटिटी क्रेडेंशियल मिलेंगे. साथ ही, उपयोगकर्ता को PGS में साइन इन करने का विकल्प दिखेगा.
अपने-आप साइन-इन होने की सुविधा एक सेटिंग है, जिसे उपयोगकर्ता कंट्रोल कर सकते हैं. उपयोगकर्ताओं के पास यह विकल्प होता है कि वे सभी गेम में अपने-आप साइन इन होने की सुविधा चालू करें या हर बार साइन इन करने का विकल्प चुनें.
मैन्युअल तरीके से साइन इन करना
अगर कोई उपयोगकर्ता गेम में अपने-आप साइन इन नहीं होता है, तो उससे मैन्युअल तरीके से साइन इन करने के लिए कहा जा सकता है. उपयोगकर्ता, आपके गेम के सबसे ऊपर दिखने वाले डायलॉग बॉक्स से एक क्लिक में साइन इन कर सकते हैं.
सही तरीके से साइन-इन करने के लिए, PGS पॉप-अप दिखाने की अनुमति दें
PGS का इस्तेमाल करते समय, उपयोगकर्ताओं को यह पता होना चाहिए कि वे साइन इन हैं. ऐसा, PGS में साइन-इन करने की सुविधा दिखाकर किया जाता है.
साइन-इन करने की सुविधा दिखाने के लिए, गेम शुरू होने के दौरान GamesClient क्लास के setViewForPopups() तरीके को कॉल करें. इससे उपयोगकर्ताओं को सही अनुभव मिलता है.
OAuth के दायरे और PGS
PGS, OAuth सिस्टम पर निर्भर करता है. इससे लोगों को अपने खाते का ऐक्सेस आपके गेम को देने की अनुमति मिलती है. OAuth स्कोप, वे अनुमतियां होती हैं जिनका अनुरोध डेवलपर के तौर पर किया जा सकता है. अनुमति मिलने पर, आपका गेम उपयोगकर्ता की ओर से कुछ एपीआई कॉल कर सकता है. साथ ही, आपको उनके Google खाते के कुछ हिस्सों का ऐक्सेस भी मिल सकता है.
PGS का दायरा, गेम के लिए यूनीक होता है (games-lite). अगर आपका गेम, सेव किए गए गेम की सुविधा का इस्तेमाल करता है, तो यह दूसरे दायरे (drive.appdata) पर निर्भर करता है. सेव किए गए गेम की सुविधा, उपयोगकर्ता को उसके Google Drive खाते का ऐक्सेस देती है. इसी खाते में गेम का डेटा सेव किया जाता है.
आपका गेम, किसी भी ऐसे स्कोप का अनुरोध कर सकता है जिसकी ज़रूरत आपको लोगों को बेहतरीन गेमिंग अनुभव देने के लिए हो. आपका गेम, एक बंडल में उन सभी स्कोप का अनुरोध कर सकता है जिनकी उसे ज़रूरत है. इससे Google खाते के ऐक्सेस के लिए अनुरोधों की संख्या कम हो जाती है. हालांकि, इस तरीके में एक बड़ी समस्या है. अगर आपने PGS के लिए तय किए गए स्कोप से ज़्यादा स्कोप का अनुरोध किया है, तो अपने-आप साइन इन करने की सुविधा काम नहीं करेगी. अपने-आप साइन इन होने की सुविधा, खिलाड़ियों को आपके गेम में साइन इन कराने का सबसे अच्छा तरीका है.
स्कोप के लिए, बार-बार अनुरोध करने के बजाय एक ही बार में सभी स्कोप के लिए अनुरोध करें. आपके गेम को शुरुआती अनुरोध में, सिर्फ़ PGS के स्कोप के लिए पूछना चाहिए. साथ ही, अन्य स्कोप के लिए अलग से अनुरोध करना चाहिए.
OAuth ऐक्सेस, हर स्कोप के लिए अलग-अलग स्क्रीन का इस्तेमाल करके दिया जाता है. इससे उपयोगकर्ताओं को यह तय करने में मदद मिलती है कि किस स्कोप को ऐक्सेस देना है. सिर्फ़ PGS स्कोप के साथ अपने-आप साइन इन होने की सुविधा का इस्तेमाल करने पर, उपयोगकर्ताओं को किसी भी OAuth प्रॉम्प्ट के साथ इंटरैक्ट नहीं करना पड़ेगा. इससे साइन इन करने में आने वाली समस्याएं कम हो जाएंगी.
साइन इन करने के एक से ज़्यादा तरीकों की सुविधा
PGS, Android पर गेम खेलने वाले लोगों के लिए गेमिंग आइडेंटिटी उपलब्ध कराता है. हालांकि, यह ज़रूरी नहीं है कि PGS ही आपके उपयोगकर्ताओं से जुड़ी एकमात्र आइडेंटिटी हो. PGS, सोशल नेटवर्क आईडी, और गेम में मौजूद आईडी सिस्टम का इस्तेमाल करके, एक ही समय में खिलाड़ियों को साइन इन किया जा सकता है. हर सिस्टम, आपको और आपके खिलाड़ियों को खास फ़ायदे देता है. साथ ही, ये सभी सिस्टम एक साथ काम करके, Android पर गेम खेलने वाले लोगों को शानदार अनुभव दे सकते हैं.
बैकएंड इंटिग्रेशन के लिए, प्लेयर की पहचान को सुरक्षित तरीके से वापस पाना और उसकी पुष्टि करना
सर्वर के ऑथराइज़ेशन कोड का अनुरोध किया जा सकता है. इससे आपका सर्वर, REST API के ज़रिए सीधे तौर पर Play की गेम सेवाओं के सर्वर से कम्यूनिकेट कर पाएगा. इसके लिए, उसे साइन-इन किए हुए खिलाड़ी की अनुमति लेनी होगी. इससे सीधे तौर पर खिलाड़ी के आईडी, प्रोफ़ाइल, और अन्य जानकारी (जैसे कि अगर अनुमति हो, तो दोस्तों की सूची) को ऐक्सेस किया जा सकता है. अगर आपने अपने बैकएंड में प्लेयर आईडी, दोस्त के आईडी या इनसे जुड़ा कोई अन्य डेटा सेव किया है, तो इस तरीके का इस्तेमाल करके, डिवाइस पर इन फ़ील्ड में बदलाव करने की संभावना को खत्म किया जाना चाहिए.
इसके अलावा, कुछ पुराने गेम और खिलाड़ियों के लिए, Android SDK से मिले प्लेयर आईडी और अन्य खिलाड़ियों को दिखने वाले आईडी में अंतर हो सकता है. ऐसा तब होता है, जब वे एक ही गेम में उस खिलाड़ी की प्रोफ़ाइल देखते हैं. यह खास तौर पर तब होता है, जब दोस्तों की सूची का इस्तेमाल किया जा रहा हो. हालांकि, REST API में दिखाया गया player_id हमेशा एक जैसा होता है. साथ ही, यह हमेशा वही आईडी होता है जो अन्य खिलाड़ियों को दिखता है.
ज़्यादा जानकारी के लिए, ऑफ़लाइन ऐक्सेस और REST API से जुड़े दस्तावेज़ देखें.
क्लाइंट-साइड पर लागू करना
Android पर साइन-इन करने की सुविधा लागू करने का तरीका जानने के लिए, Android गेम में साइन-इन करना लेख पढ़ें.