अपने गेम को Google Play Games Services के साथ इंटिग्रेट करने के लिए, सबसे पहले प्लैटफ़ॉर्म की पुष्टि करने की सुविधा लागू करें. इन सुविधाओं को ऐक्सेस करने के लिए, इसकी ज़रूरत होती है. जैसे, उपलब्धियां, लीडरबोर्ड, और इवेंट.
Google Play Games Level Up के उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देशों का पालन करने के लिए, आपके गेम को पुष्टि करने के सुझाए गए तरीके के मुताबिक होना चाहिए.
शुरू करना और पुष्टि करना
अपने गेम को शुरू करने और उसकी पुष्टि करने के लिए, यह ज़रूरी चरण है:
- स्टार्टअप पर Play Games Services v2 SDK को शुरू करके, प्लैटफ़ॉर्म की पुष्टि करने की सुविधा लागू करें. ज़्यादा जानकारी के लिए, Android गेम के लिए प्लैटफ़ॉर्म की पुष्टि करना लेख पढ़ें. Play Games की सेवाओं की सुविधाओं को ऐक्सेस करने के लिए, यह ज़रूरी चरण है. जैसे, उपलब्धियां और लीडरबोर्ड.
- गेम लॉन्च होने के दौरान, पुष्टि करने की प्रोसेस बैकग्राउंड में बिना किसी रुकावट के चलती है.
Play Games की सेवाओं का इस्तेमाल करने वाले मौजूदा लोगों को पुष्टि हो जाने के बाद, स्वागत मैसेज दिखेगा.
प्रोफ़ाइल बनाना
इस प्लैटफ़ॉर्म का इस्तेमाल करने के लिए, खिलाड़ियों के पास Play की गेम सेवाओं की प्रोफ़ाइल होनी चाहिए. ऐसा हो सकता है कि कुछ खिलाड़ियों के पास, आपका गेम शुरू करते समय Play की गेम सेवाओं की प्रोफ़ाइल न हो. इन खिलाड़ियों को खाता बनाने के लिए कहा जाएगा.
Play की गेम सेवाओं वाली प्रोफ़ाइल के बिना कोई गेम लॉन्च करने पर, प्रोफ़ाइल बनाने के लिए अपने-आप ट्रिगर होने वाले प्रॉम्प्ट डिफ़ॉल्ट रूप से अपने-आप दिखते हैं.
पुष्टि करने के लिए सुझाया गया फ़्लो
Google Play Games Level Up के उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देशों का पालन करने के लिए, पुष्टि करें कि आपने खिलाड़ी की प्रोग्रेस जारी रखने से जुड़ी ज़रूरी शर्तों का पालन किया हो. खिलाड़ियों को अपने गेम में साइन इन कराने के लिए, पुष्टि करने की यह प्रोसेस अपनाएं:
- गेम शुरू होने के दौरान, अपने-आप ट्रिगर होने वाली प्रोफ़ाइल बनाने की सुविधा लागू करें.
- अगर अपने-आप पुष्टि होने की सुविधा काम नहीं करती है या आपने इसे अस्वीकार कर दिया है, तो मैन्युअल तरीके से साइन इन करने का बटन दिखाएं, ताकि बाद में पुष्टि की जा सके.
खिलाड़ी आईडी
प्लेयर आईडी, Play की गेम सेवाओं के प्लेयर खाते का आइडेंटिफ़ायर होता है. आपका गेम, ऐसे किसी भी खिलाड़ी के लिए प्लेयर आईडी वापस पा सकता है जो 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 की सेवाओं के ज़रिए लॉगिन करने के अनुरोधों के लिए, हर दिन का कोटा तय होता है. ज़्यादा जानकारी के लिए, रोज़ाना के कोटे को मैनेज करना लेख पढ़ें.