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