प्लैटफ़ॉर्म की पुष्टि करना

अपने गेम को Google Play की गेम सेवाओं (PGS) के साथ इंटिग्रेट करने का पहला चरण, प्लैटफ़ॉर्म की पुष्टि की सुविधा लागू करना है. उपलब्धियां, लीडरबोर्ड, और इवेंट जैसी अन्य सभी सुविधाओं को ऐक्सेस करने के लिए, यह ज़रूरी है.

Play की गेम सेवाओं का एसडीके, गेम लॉन्च होने पर प्लैटफ़ॉर्म की पुष्टि की सुविधा अपने-आप लागू करता है. इसलिए, आपको अपने गेम के साथ PGS v2 एसडीके इंटिग्रेट करना होगा. साथ ही, पुष्टि करने का सुझाया गया तरीका लागू करना होगा. इससे आपका गेम, Google Play Games Level Up से जुड़े उपयोगकर्ता अनुभव के दिशा-निर्देशों के मुताबिक काम करेगा.

पुष्टि करने से जुड़े कॉन्सेप्ट

Play की गेम सेवाओं के वर्शन 2 में, "साइन इन करने" के कॉन्सेप्ट को दो अलग-अलग लेयर में बांटा गया है: प्लैटफ़ॉर्म की पुष्टि और इन-गेम पुष्टि.

प्लैटफ़ॉर्म की पुष्टि

Play की गेम सेवाएं, प्लैटफ़ॉर्म पर लोगों की दिलचस्पी बढ़ाने वाली एक लेयर उपलब्ध कराती हैं. यह गेमर प्रोफ़ाइल का इस्तेमाल करके, Google Play Games के इकोसिस्टम के साथ आपके खिलाड़ी के संबंध को मैनेज करती है. इससे उपलब्धियां, लीडरबोर्ड, और मिशन जैसी सुविधाएं ऐक्सेस की जा सकती हैं. प्लैटफ़ॉर्म की पुष्टि की मुख्य विशेषताएं यहां दी गई हैं:

• साइलेंट और अपने-आप होने वाली पुष्टि: गेम लॉन्च होने पर, पुष्टि की प्रक्रिया बैकग्राउंड में अपने-आप होती है. Play की गेम सेवाओं के लिए, साइन इन करें बटन की ज़रूरत नहीं होती.
• खिलाड़ी आईडी: प्लैटफ़ॉर्म की पुष्टि की प्रक्रिया पूरी होने के बाद, Play की गेम सेवाएं एक स्थायी खिलाड़ी आईडी उपलब्ध कराती हैं. एक ही गेम के लिए, यह आईडी सभी डिवाइसों पर एक जैसा होता है. इस आईडी का इस्तेमाल मुख्य तौर पर, प्लैटफ़ॉर्म की सुविधाओं को ट्रैक करने के लिए करें. जैसे, उपलब्धियों की प्रोग्रेस.
• डीकपल्ड: आपको Play की गेम सेवाओं का इस्तेमाल, अपने गेम के मुख्य आइडेंटिटी सिस्टम के तौर पर नहीं करना चाहिए. इससे खिलाड़ी के इन-गेम खाते (आईजीए), गेम की प्रोग्रेस या इन्वेंट्री को मैनेज नहीं किया जा सकता. Play की गेम सेवाएं, स्थायी प्लैटफ़ॉर्म आइडेंटिफ़ायर के तौर पर काम करती हैं.

खिलाड़ी आईडी

खिलाड़ी आईडी, Play की गेम सेवाओं के खिलाड़ी खाते का आइडेंटिफ़ायर होता है. आपका गेम, Play की गेम सेवाओं की पुष्टि का इस्तेमाल करके, आपके गेम में साइन इन करने वाले किसी भी खिलाड़ी के लिए खिलाड़ी आईडी वापस पा सकता है. आपका गेम क्लाइंट इंटिग्रेशन, गेम सर्वर इंटिग्रेशन, और क्लाउड-सेव सेवा, Play की गेम सेवाओं से खिलाड़ी के डेटा को सुरक्षित तरीके से ऐक्सेस करने के लिए, आईडी का इस्तेमाल कर सकती हैं.

जब कोई उपयोगकर्ता आपके गेम को एक से ज़्यादा डिवाइसों पर खेलता है, तो उसके लिए खिलाड़ी आईडी एक जैसा होता है. हालांकि, यह आईडी अलग-अलग गेम के लिए हमेशा एक जैसा नहीं होता. ज़्यादा जानकारी के लिए, नई जनरेशन वाले खिलाड़ी आईडी देखें.

इन-गेम पुष्टि

इन-गेम खाते (आईजीए) को मैनेज करने की ज़िम्मेदारी आपकी होती है. यह आइडेंटिटी सिस्टम है, जो आपके गेम में खिलाड़ी की प्रोग्रेस, इन्वेंट्री, और मुद्रा को बाइंड करता है.

• मुख्य आइडेंटिटी: साइन-इन करने के मुख्य तरीके के तौर पर, अपने बैकएंड, 'Google से साइन इन करें' (एसआईडब्ल्यूजी) या अन्य प्रोवाइडर का इस्तेमाल किया जा सकता है.
• इंडिपेंडेंस: खिलाड़ी, Play की गेम सेवाओं (प्लैटफ़ॉर्म आइडेंटिटी) में साइन इन करके उपलब्धियां हासिल कर सकते हैं. इसके लिए, उन्हें किसी खास आईजीए (उदाहरण के लिए, मेहमान खाता या कोई खास एसआईडब्ल्यूजी खाता) में साइन इन करना होगा.
• एक से ज़्यादा आईजीए का मैनेजमेंट: Play की गेम सेवाएं सिर्फ़ प्लैटफ़ॉर्म की पुष्टि को मैनेज करती हैं. आपका गेम, खिलाड़ियों के आईजीए में मुख्य पुष्टि को मैनेज करता है. इसका मतलब है कि खिलाड़ियों के लिए, अपने आईजीए के बीच स्विच करने के लिए, आपके गेम के मौजूदा फ़्लो में कोई बदलाव नहीं किया गया है. जब खिलाड़ी खाते बदलते हैं, तब भी वे Play की गेम सेवाओं के ज़रिए, Play Games प्लैटफ़ॉर्म पर पुष्टि किए गए रहते हैं. साथ ही, आप उन्हें उपलब्धियों और Play की गेम सेवाओं की अन्य सुविधाओं से जुड़ा डेटा, स्थायी खिलाड़ी आईडी के हिसाब से भेजते रहते हैं.

एसआईडब्ल्यूजी के साथ क्रॉस-प्लैटफ़ॉर्म की सुविधा

खिलाड़ियों को Android, iOS, और वेब पर अपनी प्रोग्रेस जारी रखने में मदद करने के लिए, Google से साइन इन करें को इन-गेम पुष्टि के मुख्य तरीके के तौर पर इस्तेमाल करें. इन बातों का ध्यान रखें:

• Google से साइन इन करें बटन: Play की गेम सेवाओं के वर्शन 1 में, Google Play बटन अक्सर प्लैटफ़ॉर्म और गेम में साइन-इन, दोनों को मैनेज करता था. वर्शन 2 में, ये अलग-अलग प्रोसेस हैं. खिलाड़ियों के लिए, Google से साइन इन करें का एक स्टैंडर्ड बटन लागू करें, ताकि वे पुष्टि कर सकें और अपने आईजीए को ऐक्सेस कर सकें.
• Google Sign-in SDKs:
  • Android और iOS, दोनों के लिए, खिलाड़ियों को उनके आईजीए में पुष्टि करने के लिए, Google Sign-in SDKs के स्टैंडर्ड वर्शन का इस्तेमाल करें.
  • खिलाड़ी के इन-गेम खाते के मुख्य आइडेंटिफ़ायर के तौर पर, Google Open ID का इस्तेमाल करें.
  • Play की गेम सेवाओं की सुविधाओं पर खिलाड़ी की प्रोग्रेस की रिपोर्ट करने के लिए, Play की गेम सेवाओं के खिलाड़ी आईडी का इस्तेमाल करें. जैसे, उपलब्धियां.

इंटिग्रेशन का सुझाया गया तरीका

अपने गेम को Play की गेम सेवाओं के साथ इंटिग्रेट करने के लिए, सुझाए गए ये चरण पूरे करें:

शुरुआत और पुष्टि

अपने गेम को शुरू करने और उसकी पुष्टि करने के लिए, यह चरण ज़रूरी है:

शुरुआत में, Play की गेम सेवाओं के वर्शन 2 का एसडीके शुरू करके, प्लैटफ़ॉर्म की पुष्टि की सुविधा लागू करें. ज़्यादा जानकारी के लिए, Android गेम के लिए प्लैटफ़ॉर्म की पुष्टि देखें. उपलब्धियां और लीडरबोर्ड जैसी Play की गेम सेवाओं की सुविधाओं को ऐक्सेस करने के लिए, यह चरण ज़रूरी है.

गेम लॉन्च होने के दौरान, पुष्टि की प्रक्रिया बैकग्राउंड में साइलेंट तरीके से चलती है. Play की गेम सेवाओं के मौजूदा उपयोगकर्ताओं को, पुष्टि की प्रक्रिया पूरी होने के बाद, स्वागत मैसेज दिखता है. जिन उपयोगकर्ताओं के पास Play की गेम सेवाओं की प्रोफ़ाइल नहीं है उन्हें एसडीके शुरू होने के दौरान, प्रोफ़ाइल बनाने के लिए कहा जाता है.

प्रोफ़ाइल बनाना

प्लैटफ़ॉर्म पर लोगों की दिलचस्पी बढ़ाने के लिए, खिलाड़ियों के पास Play की गेम सेवाओं की प्रोफ़ाइल होनी चाहिए. हो सकता है कि कुछ खिलाड़ियों के पास आपका गेम शुरू करते समय, Play की गेम सेवाओं की प्रोफ़ाइल न हो. ऐसे खिलाड़ियों को प्रोफ़ाइल बनाने के लिए कहा जाएगा. अपने उपयोगकर्ताओं के लिए सही अनुभव तय करने के लिए, इनमें से कोई एक विकल्प चुनें:

प्रोफ़ाइल बनाने के लिए, अपने-आप ट्रिगर होने वाले प्रॉम्प्ट

Play की गेम सेवाओं की प्रोफ़ाइल के बिना कोई गेम लॉन्च करने पर, प्रोफ़ाइल बनाने के लिए अपने-आप ट्रिगर होने वाले प्रॉम्प्ट, डिफ़ॉल्ट रूप से दिखते हैं.

प्रोफ़ाइल बनाने के लिए, अपने-आप ट्रिगर होने वाले प्रॉम्प्ट बंद करना

प्रोफ़ाइल बनाने के लिए, अपने-आप ट्रिगर होने वाले प्रॉम्प्ट को रोकने के लिए, मेनिफ़ेस्ट फ़ाइल को कॉन्फ़िगर करके, गेम लॉन्च होने पर दिखने वाले प्रोफ़ाइल प्रॉम्प्ट बंद करें. इससे, Play की गेम सेवाओं की प्रोफ़ाइल के बिना भी उपयोगकर्ता, Play की गेम सेवाओं की प्रोफ़ाइल बनाने के लिए कहे बिना, गेम लोड कर सकते हैं.

उपयोगकर्ता, किसी भी आइडेंटिटी प्रोवाइडर से साइन इन कर सकते हैं. हालांकि, आपको उन्हें Play Games प्लैटफ़ॉर्म की पुष्टि की सुविधा से पुष्टि करने के लिए प्रोत्साहित करने के लिए, प्रोफ़ाइल बनाने का प्रॉम्प्ट दिखाना चाहिए. ज़रूरत के हिसाब से यह प्रॉम्प्ट दिखाएं. हालांकि, पक्का करें कि यह प्रॉम्प्ट, उपयोगकर्ताओं को उपलब्धियों और लीडरबोर्ड जैसी सुविधाओं में अच्छी प्रोग्रेस करने से पहले दिखे.

प्रोफ़ाइल प्रॉम्प्ट को इन सुझाए गए समय के दौरान ट्रिगर करने पर विचार करें:

• ट्यूटोरियल पूरा करने के बाद.
• इनाम पाने के दौरान (उदाहरण के लिए, मैच जीतने, कोई रेअर आइटम इकट्ठा करने या माइलस्टोन हासिल करने पर).
• दूसरा सेशन लॉन्च करने के समय.

ज़्यादा जानकारी के लिए, प्रोफ़ाइल बनाने के लिए, अपने-आप ट्रिगर होने वाले प्रॉम्प्ट को रोकना (Java) और प्रोफ़ाइल बनाने के लिए, अपने-आप ट्रिगर होने वाले प्रॉम्प्ट को रोकना (Unity) देखें.

इन-गेम पुष्टि

प्लैटफ़ॉर्म की पुष्टि की प्रक्रिया पूरी होने के बाद, डेवलपर को खिलाड़ियों के लिए, उनके आईजीए को ऐक्सेस करने के लिए ये चरण पूरे करने चाहिए. यह मौजूदा गेम की स्थिति पर निर्भर करता है:

1. अगर डिवाइस पर कोई ऐक्टिव गेम सेशन मौजूद है, तो खिलाड़ी को अपना मौजूदा सेशन जारी रखने की अनुमति दें.
2. अगर कोई ऐक्टिव गेम सेशन मौजूद नहीं है, तो:
   1. अगर बिना किसी रुकावट के रीस्टोर करने का कोई ऐसा परिदृश्य है जिसमें आखिरी बार खेला गया आईजीए, Play की गेम सेवाओं के खिलाड़ी आईडी से जुड़ा है, तो उससे जुड़े आईजीए को अपने-आप रीस्टोर करें.
   2. इसके अलावा, खिलाड़ी को अपने ऐप्लिकेशन का तय किया गया लॉगिन या खाता बनाने वाला स्क्रीन दिखाएं. इसके बाद, खिलाड़ी मौजूदा आईजीए में लॉगिन करने या उसे बनाने के लिए, पुष्टि करने का अपना पसंदीदा तरीका चुन सकते हैं.

OAuth के दायरे

Play की गेम सेवाएं, OAuth सिस्टम पर निर्भर करती हैं. इससे खिलाड़ियों को आपके गेम को अपने खाते का ऐक्सेस देने की अनुमति मिलती है. Play की गेम सेवाओं के पास, गेम के लिए एक यूनीक दायरा (games-lite) होता है. साथ ही, अगर आपका गेम, सेव किए गए गेम की सुविधा का इस्तेमाल करता है, तो वह दूसरे दायरे (drive.appdata) पर निर्भर करता है. सेव किए गए गेम की सुविधा से, उपयोगकर्ता के Google Drive खाते का ऐक्सेस मिलता है. इसी खाते में गेम का डेटा सेव किया जाता है.

Play की गेम सेवाओं के वर्शन 2 का एसडीके इस्तेमाल करते समय, OAuth के अन्य दायरोंका अनुरोध किया जा सकता है. अगर आपको OAuth के अन्य दायरों की ज़रूरत है, तो हमारा सुझाव है कि आप requestServerSideAccess को कॉल करें. ज़्यादा जानकारी के लिए, सर्वर ऑथराइज़ेशन कोड पाना या सर्वर ऑथेंटिकेशन कोड वापस पाना देखें.

पुष्टि करने के सही तरीके के लिए, उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देश

यहां दिए गए दिशा-निर्देशों में, Play की गेम सेवाओं के वर्शन 2 के इंटिग्रेशन के साथ, पुष्टि करने के सुझाए गए तरीके के बारे में बताया गया है. इनमें नए, मौजूदा, और लौटने वाले उपयोगकर्ताओं के साथ-साथ, मेहमान मोड के परिदृश्यों के बारे में भी बताया गया है.

नया खिलाड़ी

यह तरीका, किसी ऐसे उपयोगकर्ता पर लागू होता है जो किसी डिवाइस पर पहली बार गेम लॉन्च कर रहा है. इस डिवाइस पर, गेम खेलने का कोई इतिहास मौजूद नहीं है.

1. लॉन्च होने पर, Play की गेम सेवाओं का एसडीके, उपयोगकर्ता की प्लैटफ़ॉर्म आइडेंटिटी (Play की गेम सेवाओं का खिलाड़ी आईडी) की पुष्टि करने के लिए शुरू होता है.
2. बैकग्राउंड में हैंडशेक होने के बाद, गेम खिलाड़ी को आईजीए बनाने के विकल्प दिखाता है. जैसे, नया खाता बनाएं, Google से साइन इन करें या सोशल लॉगिन के अन्य तरीके.
3. खिलाड़ी के आईजीए बनाने या चुनने के बाद, गेम इस खाते को अपने बैकएंड में चुने गए मुख्य आइडेंटिफ़ायर से बाइंड करता है.
4. गेम, चुने गए इस आईजीए को Play की गेम सेवाओं के खिलाड़ी आईडी से भी बाइंड करता है. साथ ही, इसे बिना किसी रुकावट के रीस्टोर करने के लिए, आखिरी बार खेला गया आईजीए के तौर पर मार्क करता है.

ऐक्टिव सेशन वाले खिलाड़ी

इस परिदृश्य में, ऐसे खिलाड़ियों के बारे में बताया गया है जो किसी ऐसे डिवाइस पर गेम लॉन्च कर रहे हैं जिस पर उनका पहले से कोई ऐक्टिव सेशन है. इसका मकसद, बिना किसी रुकावट के एंट्री का अनुभव देना है.

1. जब खिलाड़ी ऐप्लिकेशन लॉन्च करता है, तो Play की गेम सेवाएं बैकग्राउंड में साइलेंट तरीके से पुष्टि करती हैं. साथ ही, उपलब्धियों और Play की गेम सेवाओं की अन्य सुविधाओं के हिसाब से प्रोग्रेस ट्रैक करने के लिए, आपको खिलाड़ी आईडी उपलब्ध कराती हैं.
2. साथ ही, जहां लागू हो वहां गेम, लॉगिन स्क्रीन को बायपास कर देता है और खिलाड़ी को तुरंत उसके ऐक्टिव आईजीए सेशन या उसके खिलाड़ी आईडी से जुड़े आखिरी बार खेले गए आईजीए में साइन इन कर देता है. इससे खिलाड़ी तुरंत गेमप्ले जारी रख सकते हैं.

खाते बदलने वाले खिलाड़ी

यह तरीका तब लागू होता है, जब ऐक्टिव सेशन वाला कोई खिलाड़ी, खाते बदलने के लिए गेम की सेटिंग पर जाता है. उदाहरण के लिए, किसी दूसरे खाते का इस्तेमाल करने के लिए, मुख्य खाते से साइन आउट करना.

1. खिलाड़ी, मौजूदा आईजीए से साइन आउट करता है. हालांकि, Play की गेम सेवाओं के प्लैटफ़ॉर्म का कनेक्शन ऐक्टिव रहता है.
2. जब खिलाड़ी किसी दूसरे आईजीए से लॉगिन करता है, तो गेम इस नए खाते को मौजूदा Play की गेम सेवाओं के खिलाड़ी आईडी से बाइंड करता है. यह सिर्फ़ बिना किसी रुकावट के रीस्टोर करने के लिए, आखिरी बार खेले गए आईजीए के तौर पर बाइंड किया जाता है.

लौटने वाले खिलाड़ियों के लिए, बिना किसी रुकावट के रीस्टोर करने की सुविधा

यह परिदृश्य तब लागू होता है, जब कोई खिलाड़ी, कुछ समय तक गेम न खेलने के बाद, री-इंस्टॉल करने के बाद या किसी बिलकुल नए डिवाइस पर गेम लॉन्च करता है. हमारा सुझाव है कि गेम में, बिना किसी रुकावट के रीस्टोर करने की सुविधा लागू की जाए.

1. लॉन्च होने पर, Play की गेम सेवाएं, उपयोगकर्ता की पुष्टि करती हैं और गेम को Play की गेम सेवाओं का खिलाड़ी आईडी उपलब्ध कराती हैं.
2. गेम, अपने बैकएंड की जांच करता है (या Recall API का इस्तेमाल करने पर, वापस पाया गया Recall टोकन) और देखता है कि आखिरी बार खेला गया कोई आईजीए, Play की गेम सेवाओं के इस आईडी से पहले से लिंक है या नहीं.
3. अगर कोई लिंक मिलता है, तो गेम, खिलाड़ी की प्रोग्रेस को अपने-आप रीस्टोर कर देता है और उसे लॉगिन कर देता है. इससे, मैन्युअल लॉगिन स्क्रीन पूरी तरह से स्किप हो जाती है.
4. इसके अलावा, गेम खिलाड़ी को उसकी लॉगिन स्क्रीन दिखाता है
   1. इसके बाद, खिलाड़ी लॉगिन करने का कोई तरीका चुनता है और किसी आईजीए में साइन इन करता है
   2. इसके बाद, गेम इस आईजीए को Play की गेम सेवाओं के खिलाड़ी आईडी से बाइंड करता है. यह सिर्फ़ बिना किसी रुकावट के रीस्टोर करने के लिए, आखिरी बार खेले गए आईजीए के तौर पर बाइंड किया जाता है.

मेहमान मोड

खिलाड़ी, स्थानीय मेहमान खाते का इस्तेमाल करके आपका गेम लॉन्च कर सकते हैं और खेल सकते हैं. Play की गेम सेवाएं, बैकग्राउंड में खिलाड़ी की पुष्टि करती हैं. अगर खिलाड़ी प्रोग्रेस सेव करें चुनता है, तो आपका गेम, मेहमान सेशन को एक स्थायी आईजीए में बदल देता है और उसे खिलाड़ी आईडी से बाइंड कर देता है. टकराव की समस्या हल करने के बारे में ज़्यादा जानकारी के लिए, मेहमान खाता देखें.