अपने गेम को Google Play की गेम सेवाओं (PGS) के साथ इंटिग्रेट करने का पहला चरण, प्लैटफ़ॉर्म की पुष्टि करने की सुविधा को लागू करना है. उपलब्धियां, लीडरबोर्ड, और इवेंट जैसी अन्य सभी सुविधाओं को ऐक्सेस करने के लिए, इसकी ज़रूरत होती है.
Play Games की सेवाओं का एसडीके, गेम लॉन्च के समय प्लैटफ़ॉर्म की पुष्टि अपने-आप करता है. इसलिए, आपको PGS v2 एसडीके को अपने गेम के साथ इंटिग्रेट करना होगा. साथ ही, पुष्टि करने के लिए सुझाए गए फ़्लो को लागू करना होगा. इससे आपका गेम, Google Play Games Level Up उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देशों को लागू करने और उनका पालन करने के लिए तैयार हो जाएगा.
पुष्टि करने के कॉन्सेप्ट
Play की गेम सेवाओं के वर्शन 2 में, "साइन इन करने" की सुविधा को दो अलग-अलग लेयर में बांटा गया है: प्लैटफ़ॉर्म पर पुष्टि करना और गेम में पुष्टि करना.
प्लैटफ़ॉर्म की पुष्टि करना
Play की गेम सेवाओं में, प्लैटफ़ॉर्म से जुड़ने की सुविधा मिलती है. यह गेमर प्रोफ़ाइल का इस्तेमाल करके, Google Play Games के ईकोसिस्टम के साथ आपके प्लेयर के संबंध को मैनेज करता है. इससे उपलब्धियां, लीडरबोर्ड, और क्वेस्ट जैसी सुविधाओं को ऐक्सेस किया जा सकता है. प्लैटफ़ॉर्म की पुष्टि करने की सुविधा की मुख्य बातें:
- साइलेंट और अपने-आप होने वाली पुष्टि: गेम लॉन्च होने पर, बैकग्राउंड में अपने-आप पुष्टि हो जाती है. Play Games की सेवाओं के लिए, मैन्युअल तरीके से साइन इन करें बटन की ज़रूरत नहीं है.
- प्लेयर आईडी: प्लैटफ़ॉर्म पर पहचान की पुष्टि हो जाने के बाद, Play की गेम सेवाएं एक स्टेबल प्लेयर आईडी उपलब्ध कराती हैं. यह आईडी, एक ही गेम के लिए सभी डिवाइसों पर एक जैसा होता है. इस आईडी का इस्तेमाल मुख्य रूप से प्लैटफ़ॉर्म की सुविधाओं को ट्रैक करने के लिए किया जाता है. जैसे, उपलब्धि की प्रोग्रेस.
- अलग किया गया: आपको Play की गेम सेवाओं का इस्तेमाल, अपने गेम के मुख्य पहचान सिस्टम के तौर पर नहीं करना चाहिए. इससे, गेम में खिलाड़ी के खाते (आईजीए), गेम की प्रोग्रेस या इन्वेंट्री को मैनेज किया जाता है. Play Games Services, एक स्थायी प्लैटफ़ॉर्म आइडेंटिफ़ायर के तौर पर काम करता है.
खिलाड़ी आईडी
प्लेयर आईडी, Play की गेम सेवाओं के प्लेयर खाते का आइडेंटिफ़ायर होता है. आपका गेम, Play की गेम सेवाओं की पुष्टि करने की सुविधा का इस्तेमाल करके, आपके गेम में साइन इन करने वाले किसी भी खिलाड़ी का आईडी वापस पा सकता है. आपका गेम क्लाइंट इंटिग्रेशन, गेम सर्वर इंटिग्रेशन, और क्लाउड-सेव सेवा, इस आईडी का इस्तेमाल करके Play Games की सेवाओं से खिलाड़ी के डेटा को सुरक्षित तरीके से ऐक्सेस कर सकती हैं.
जब कोई उपयोगकर्ता आपके गेम को एक से ज़्यादा डिवाइसों पर खेलता है, तब उसके लिए प्लेयर आईडी एक जैसा होता है. हालांकि, यह सुविधा हर गेम में एक जैसी नहीं होती. ज़्यादा जानकारी के लिए, नई जनरेशन वाले प्लेयर आईडी देखें.
गेम में पुष्टि करने की सुविधा
आपके पास इन-गेम खाते (आईजीए) को मैनेज करने का विकल्प होता है. यह एक आइडेंटिटी सिस्टम है, जो आपके गेम में खिलाड़ी की प्रोग्रेस, इन्वेंट्री, और मुद्रा को बाइंड करता है.
- प्राइमरी आइडेंटिटी: साइन इन करने के मुख्य तरीके के तौर पर, अपने बैकएंड, 'Google से साइन इन करें' (एसआईडब्ल्यूजी) या अन्य प्रोवाइडर का इस्तेमाल किया जा सकता है.
- इंडिपेंडेंस: खिलाड़ी, Play Games Services (प्लैटफ़ॉर्म आइडेंटिटी) में साइन इन करके उपलब्धियां हासिल कर सकते हैं. इसके लिए, उन्हें किसी खास IGA (उदाहरण के लिए, मेहमान खाता या कोई खास SiWG खाता) में साइन इन करना होगा.
- एक से ज़्यादा आईजीए मैनेज करना: Play Games Services सिर्फ़ प्लैटफ़ॉर्म की पुष्टि करता है. आपका गेम, खिलाड़ियों के आईजीए में उनकी मुख्य पुष्टि को मैनेज करता है. इसका मतलब है कि खिलाड़ियों के लिए, एक से दूसरे आईजीए के बीच स्विच करने के लिए, आपके गेम के मौजूदा फ़्लो में कोई बदलाव नहीं किया गया है. जब खिलाड़ी खाते बदलते हैं, तब वे PGS के ज़रिए Play Games प्लैटफ़ॉर्म पर पुष्टि किए गए खाते से जुड़े रहते हैं. साथ ही, उपलब्धियों और PGS की अन्य सुविधाओं से जुड़ा उनका डेटा, खिलाड़ी के आईडी के हिसाब से भेजा जाता रहता है.
SiWG की मदद से, क्रॉस-प्लैटफ़ॉर्म पर गेम खेलना जारी रखें
खिलाड़ियों को Android, iOS, और वेब पर अपनी प्रोग्रेस जारी रखने में मदद करने के लिए, गेम में पुष्टि करने के मुख्य तरीके के तौर पर Google से साइन इन करें का इस्तेमाल करें. इन बातों का ध्यान रखें:
- 'Google से साइन इन करें' बटन: PGS v1 में, Google Play बटन से अक्सर प्लैटफ़ॉर्म और गेम, दोनों में साइन इन किया जाता था. v2 में, ये अलग-अलग प्रोसेस हैं. खिलाड़ियों के लिए, 'Google से साइन इन करें' बटन को लागू करें, ताकि वे पुष्टि कर सकें और अपने आईजीए को ऐक्सेस कर सकें.
- Google Sign-in SDK टूल:
- Android और iOS, दोनों के लिए, Google से साइन इन करने वाले स्टैंडर्ड एसडीके टूल का इस्तेमाल करें, ताकि खिलाड़ियों को उनके आईजीए में पुष्टि की जा सके.
- किसी खिलाड़ी के इन-गेम खाते के लिए, Google Open ID को मुख्य आइडेंटिफ़ायर के तौर पर इस्तेमाल करें.
- Play Games की सुविधाओं पर किसी खिलाड़ी की प्रोग्रेस की रिपोर्ट करने के लिए, Play Games की सेवाओं के खिलाड़ी के आईडी का इस्तेमाल करें. जैसे, उपलब्धियां.
सुझाया गया इंटिग्रेशन
अपने गेम को Play की गेम सेवाओं के साथ इंटिग्रेट करने के लिए, यह तरीका अपनाएं:
शुरू करना और पुष्टि करना
अपने गेम को शुरू करने और उसकी पुष्टि करने के लिए, यह चरण पूरा करना ज़रूरी है:
स्टार्टअप पर Play की गेम सेवाओं के v2 एसडीके को शुरू करके, प्लैटफ़ॉर्म की पुष्टि करने की सुविधा लागू करें. ज़्यादा जानकारी के लिए, Android गेम के लिए प्लैटफ़ॉर्म की पुष्टि करना लेख पढ़ें. Play Games की सेवाओं की सुविधाओं को ऐक्सेस करने के लिए, यह चरण ज़रूरी है. जैसे, उपलब्धियां और लीडरबोर्ड.
गेम लॉन्च होने के दौरान, पुष्टि करने की प्रोसेस बैकग्राउंड में बिना किसी रुकावट के चलती है. Play Games की सेवाओं का इस्तेमाल करने वाले मौजूदा लोगों को पुष्टि हो जाने के बाद, स्वागत मैसेज दिखता है. जिन उपयोगकर्ताओं के पास Play की गेम सेवाएं प्रोफ़ाइल नहीं है उन्हें एसडीके शुरू करने के दौरान, प्रोफ़ाइल बनाने के लिए कहा जाता है.
प्रोफ़ाइल बनाना
इस प्लैटफ़ॉर्म का इस्तेमाल करने के लिए, खिलाड़ियों के पास Play की गेम सेवाओं की प्रोफ़ाइल होनी चाहिए. ऐसा हो सकता है कि कुछ खिलाड़ियों के पास, आपका गेम शुरू करते समय Play Games Services प्रोफ़ाइल न हो. इन खिलाड़ियों को खाता बनाने के लिए कहा जाएगा.
Play की गेम सेवाओं वाली प्रोफ़ाइल के बिना कोई गेम लॉन्च करने पर, प्रोफ़ाइल बनाने के लिए अपने-आप ट्रिगर होने वाले प्रॉम्प्ट डिफ़ॉल्ट रूप से अपने-आप दिखते हैं.
गेम में पुष्टि करने की सुविधा
प्लेटफ़ॉर्म की पुष्टि हो जाने के बाद, डेवलपर को यह तरीका अपनाना चाहिए, ताकि खिलाड़ी अपने आईजीए ऐक्सेस कर सकें. यह तरीका, गेम की मौजूदा स्थिति के हिसाब से होना चाहिए:
- अगर डिवाइस पर कोई गेम सेशन चालू है, तो खिलाड़ी को अपना मौजूदा सेशन फिर से शुरू करने की अनुमति दें.
- अगर कोई गेम सेशन चालू नहीं है, तो:
- बिना किसी रुकावट के डेटा वापस लाने के मामले में, अगर आखिरी बार चलाया गया IGA, PGS Player ID से जुड़ा है, तो उससे जुड़े IGA को अपने-आप वापस लाने की प्रोसेस शुरू करें.
- अगर ऐसा नहीं है, तो खिलाड़ी को अपने ऐप्लिकेशन की लॉगिन या खाता बनाने की स्क्रीन दिखाएं. इसके बाद, खिलाड़ी किसी मौजूदा आईजीए में लॉग इन करने या उसे सेट अप करने के लिए, पुष्टि करने का अपना पसंदीदा तरीका चुन सकते हैं.
OAuth के दायरे
Play की गेम सेवाएं, OAuth सिस्टम पर निर्भर करती हैं. इसकी मदद से, खिलाड़ी आपके गेम को अपने खाते का ऐक्सेस दे पाते हैं. Play की गेम सेवाओं का दायरा, गेम (games-lite) के लिए यूनीक होता है. अगर आपके गेम में सेव किए गए गेम की सुविधा का इस्तेमाल किया जाता है, तो यह दूसरे स्कोप (drive.appdata) पर निर्भर करता है. सेव किए गए गेम की सुविधा, उपयोगकर्ता को उसके Google Drive खाते का ऐक्सेस देती है. गेम का डेटा इसी खाते में सेव होता है.
Play की गेम सेवाओं के v2 एसडीके का इस्तेमाल करते समय, अतिरिक्त OAuth स्कोप का अनुरोध किया जा सकता है.
अगर आपको OAuth के अन्य स्कोप की ज़रूरत है, तो हमारा सुझाव है कि आप requestServerSideAccess को कॉल करें.
ज़्यादा जानकारी के लिए, सर्वर ऑथराइज़ेशन कोड पाना या सर्वर ऑथराइज़ेशन कोड वापस पाना लेख पढ़ें.
पुष्टि करने के सबसे सही फ़्लो के लिए, उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देश
यहां दिए गए दिशा-निर्देशों में, PGS v2 के साथ इंटिग्रेशन के लिए, पुष्टि करने के सुझाए गए फ़्लो के बारे में बताया गया है. इनमें नए, मौजूदा, और लौटने वाले उपयोगकर्ताओं के साथ-साथ मेहमान के तौर पर इस्तेमाल करने से जुड़े सभी संभावित उदाहरण शामिल होते हैं.
नया प्लेयर
यह फ़्लो, उस उपयोगकर्ता पर लागू होता है जो किसी ऐसे डिवाइस पर पहली बार गेम लॉन्च कर रहा है जिस पर पहले कभी गेम नहीं खेला गया है.
- लॉन्च होने पर, PGS SDK उपयोगकर्ता की प्लैटफ़ॉर्म पहचान (PGS प्लेयर आईडी) की पुष्टि करने के लिए शुरू होता है.
- बैकग्राउंड में यह प्रोसेस पूरी होने के बाद, गेम में खिलाड़ी को IGA बनाने के विकल्प दिखते हैं. जैसे, नया खाता बनाएं, Google खाते से साइन इन करें या सोशल मीडिया के अन्य प्लैटफ़ॉर्म से लॉगिन करने के तरीके.
- जब कोई खिलाड़ी IGA बनाता है या उसे चुनता है, तो गेम इस खाते को अपने बैकएंड में चुने गए मुख्य आइडेंटिफ़ायर से बाइंड कर देता है.
- गेम, चुने गए इस आईजीए को PGS प्लेयर आईडी से भी जोड़ता है. साथ ही, इसे बिना किसी रुकावट के डेटा वापस पाने के लिए, आखिरी बार खेला गया आईजीए के तौर पर मार्क करता है.
ऐक्टिव सेशन वाले खिलाड़ी
इस उदाहरण में, ऐसे खिलाड़ियों के बारे में बताया गया है जो किसी ऐसे डिवाइस पर गेम लॉन्च करते हैं जिस पर उनका सेशन पहले से चालू है. इसका मकसद, बिना किसी रुकावट के एंट्री करने का अनुभव देना है.
- जब खिलाड़ी ऐप्लिकेशन लॉन्च करता है, तो PGS बैकग्राउंड में चुपचाप पुष्टि करता है. इससे आपको प्लेयर आईडी मिलता है, ताकि उपलब्धियों और अन्य Play की गेम सेवाओं की सुविधाओं के हिसाब से प्रोग्रेस को ट्रैक किया जा सके.
- साथ ही, जहां लागू हो वहां गेम, लॉगिन स्क्रीन को बायपास कर देता है. इसके बाद, वह खिलाड़ी को तुरंत उसके ऐक्टिव IGA सेशन या उसके प्लेयर आईडी से जुड़े आखिरी बार खेले गए IGA में साइन इन कर देता है, ताकि वह तुरंत गेम खेलना जारी रख सके.
खाते स्विच करने वाले खिलाड़ी
यह फ़्लो तब होता है, जब चालू सेशन वाला कोई खिलाड़ी खाते बदलने के लिए, गेम की सेटिंग पर जाता है. उदाहरण के लिए, किसी दूसरे खाते का इस्तेमाल करने के लिए मुख्य खाते से साइन आउट करना.
- खिलाड़ी मौजूदा IGA से साइन आउट कर लेता है, लेकिन PGS प्लैटफ़ॉर्म का कनेक्शन चालू रहता है.
- जब कोई खिलाड़ी किसी दूसरे आईजीए से लॉग इन करता है, तो गेम इस नए खाते को मौजूदा PGS Player ID से बाइंड कर देता है. ऐसा सिर्फ़ बिना किसी रुकावट के डेटा वापस लाने के लिए किया जाता है.
वापस आने वाले खिलाड़ियों के लिए, गेम को आसानी से वापस पाने की सुविधा
यह स्थिति तब लागू होती है, जब कोई खिलाड़ी कुछ समय तक गेम न खेलने के बाद उसे फिर से शुरू करता है, उसे फिर से इंस्टॉल करता है या किसी नए डिवाइस पर शुरू करता है. गेम में बिना किसी रुकावट के गेम को फिर से शुरू करने की सुविधा लागू करने का सुझाव दिया जाता है.
- लॉन्च होने पर, PGS उपयोगकर्ता की पुष्टि करता है और गेम को PGS प्लेयर आईडी देता है.
- गेम, अपने बैकएंड की जांच करता है. अगर रीकॉल एपीआई का इस्तेमाल किया जा रहा है, तो वह रीट्रिव किए गए रीकॉल टोकन की जांच करता है. इससे यह पता चलता है कि क्या आखिरी बार खेला गया IGA, इस PGS आईडी से पहले से लिंक है.
- अगर कोई लिंक मिल जाता है, तो गेम अपने-आप खिलाड़ी की प्रोग्रेस को वापस ले आता है और उसे लॉग इन कर देता है. इससे, खिलाड़ी को मैन्युअल तरीके से लॉग इन करने की ज़रूरत नहीं पड़ती.
- इसके अलावा, गेम में खिलाड़ी को लॉगिन स्क्रीन दिखाई जाती है
- इसके बाद, प्लेयर लॉगिन करने का तरीका चुनता है और किसी IGA में साइन इन करता है
- इसके बाद, गेम इस IGA को PGS प्लेयर आईडी के साथ बाइंड करता है. इससे गेम को आसानी से रीस्टोर किया जा सकता है.
मेहमान मोड
खिलाड़ी, स्थानीय मेहमान खाते का इस्तेमाल करके गेम लॉन्च कर सकते हैं और उसे खेल सकते हैं. PGS अब भी बैकग्राउंड में पुष्टि करता है. अगर खिलाड़ी प्रोग्रेस सेव करें का विकल्प चुनता है, तो गेम गेस्ट सेशन को स्थायी IGA में बदल देता है. साथ ही, इसे PGS Player ID से बाइंड कर देता है.
