आसानी से रिस्टोर करने की सुविधा

Seamless Restore, Google Play Games Services की एक सुविधा है. इसे इस तरह से डिज़ाइन किया गया है कि जब कोई खिलाड़ी किसी नए डिवाइस पर गेम इंस्टॉल करता है या उसे फिर से इंस्टॉल करता है, तो वह तुरंत अपनी गेम प्रोग्रेस से फिर से जुड़ जाता है. इससे लॉगिन स्क्रीन की समस्या को दूर किया जा सकता है.

Level Up प्रोग्राम के लिए, सीमलेस रीस्टोर करने की सुविधा से जुड़े दिशा-निर्देशों का पालन करना ज़रूरी है.

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

उपयोगकर्ता खातों को लिंक करना, ताकि एक डिवाइस पर शुरू किया गया कॉन्टेंट दूसरे डिवाइस पर भी जारी रखा जा सके और अलग-अलग डिवाइसों पर कॉन्टेंट चलाया जा सके

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

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

बिना किसी रुकावट के गेम खेलने और अलग-अलग डिवाइसों पर गेम खेलने की सुविधा देने के लिए, आपको दो मुख्य सुविधाएं लागू करनी होंगी:

• खाता लिंक करना
• क्लाउड सेव

Play Games की सेवाओं की पुष्टि करने की प्रोसेस में, खिलाड़ी की पहचान करने वाले अलग-अलग विकल्प मिलते हैं. इन विकल्पों की मदद से, Play की गेम सेवाओं को अपने मौजूदा आइडेंटिटी सिस्टम के साथ इंटिग्रेट किया जा सकता है.

Play Games की सेवाओं का नया इंटिग्रेशन

जिन गेम में Play की गेम सेवाओं का इंटिग्रेशन पहले से मौजूद नहीं है उनके लिए, Recall API बैकएंड सेटअप को आसान बनाता है. यह खाते के असोसिएशन मैनेज करता है. साथ ही, किसी व्यक्ति के गेम खाते और उसके Play की गेम सेवाओं वाले खाते के बीच कनेक्शन को सेव करता है.

Recall API का इस्तेमाल करके खाता लिंक करना

अलग-अलग प्लैटफ़ॉर्म पर उपलब्ध गेम में उपयोगकर्ता खातों को लिंक करने के लिए, Recall API का इस्तेमाल करने का सुझाव दिया जाता है. यह एपीआई खास तौर पर उन गेम के लिए फ़ायदेमंद है जिनमें Play की गेम सेवाओं को पहले से इंटिग्रेट नहीं किया गया है. इसके अलावा, यह उन गेम के लिए भी फ़ायदेमंद है जो Play की गेम सेवाओं के अलावा, प्लैटफ़ॉर्म की पुष्टि करने वाले अन्य समाधानों का इस्तेमाल करते हैं.

Recall API, खाते के असोसिएशन मैनेज करके, आपके गेम के बैकएंड सेटअप को आसान बनाता है.

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

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

उपयोगकर्ता के डेटा को सुरक्षित रखने और सुरक्षा बनाए रखने के लिए, गेम को रिकॉल टोकन जनरेट करते समय, बेहतर एन्क्रिप्शन एल्गोरिदम का इस्तेमाल करना चाहिए.

Recall के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Recall API देखें.

Recall API की सुविधा लागू करने के लिए, अपने गेम में Play की गेम सेवाओं वाले Recall API को इंटिग्रेट करना लेख पढ़ें.

Play Games की सेवाओं का मौजूदा इंटिग्रेशन

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

Player_id के साथ बाइंड करना

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

जिन गेम का बैकएंड, Play Games की सेवाओं के साथ सेट अप किया गया है Player_Id या जिन गेम में बच्चों के लिए सहायता की ज़रूरत होती है उन्हें Player_Id का इस्तेमाल करना चाहिए. साथ ही, अपने गेम और तीसरे पक्ष के खातों को Player_Id से लिंक करना चाहिए.

जानें कि प्लेयर आईडी कैसे काम करते हैं:

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

ज़्यादा जानकारी के लिए, नई जनरेशन वाले प्लेयर आईडी देखें.

खाते को लिंक करने की सुविधा का इस्तेमाल करके, हर उपयोगकर्ता के लिए एक से ज़्यादा खाते मैनेज करना

उपयोगकर्ता के एक से ज़्यादा खातों को Play की गेम सेवाओं के एक ही खाते से लिंक करने के लिए, अपनी टेबल में एक से ज़्यादा मैपिंग बनाएं.

'Google से साइन इन करें' सुविधा का इस्तेमाल करके, Google की क्रॉस-प्लैटफ़ॉर्म पहचान

Google से साइन इन करें (SiwG), Google का मुख्य आइडेंटिटी सॉल्यूशन है. इसकी मदद से गेम डेवलपर, गेम खेलने वाले लोगों की प्रोफ़ाइल की जानकारी सुरक्षित तरीके से पा सकते हैं. जैसे, उनका नाम, ईमेल पता, और प्रोफ़ाइल फ़ोटो.

'Google से साइन इन करें' सुविधा का एक मुख्य फ़ायदा यह है कि यह वेब, Android, और iOS जैसे कई प्लैटफ़ॉर्म पर उपलब्ध है. इससे खिलाड़ियों को तेज़ी से, सुरक्षित तरीके से, और भरोसेमंद तरीके से साइन-इन करने का अनुभव मिलता है.

Google आईडी टोकन के sub फ़ील्ड के साथ बाइंड करें

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

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

यहां हाई-लेवल फ़्लो दिया गया है:

• Android पर: आपका गेम, Play Games की सेवाओं वाले एसडीके को शुरू करता है. इससे Android डिवाइसों पर प्लैटफ़ॉर्म की पुष्टि अपने-आप ट्रिगर हो जाती है. Android पर Google खाते से साइन इन करते समय, साइन इन करने के तीन स्कोप के लिए अनुरोध करें: email, profile, और openid. Play Games की सेवाओं के v2 इंटिग्रेशन का इस्तेमाल न करें. ये वही स्कोप हैं जिनके लिए स्टैंडर्ड SiwG SDK अनुरोध करता है. इससे आपको एक आईडी टोकन मिलता है. इसमें प्लेयर का sub फ़ील्ड शामिल होता है.
• वेब और iOS पर: आपका गेम, स्टैंडर्ड वेब के लिए 'Google से साइन इन करें', iOS और macOS के लिए Google साइन इन SDK टूल का इस्तेमाल करता हो. जब उपयोगकर्ता साइन इन करता है, तो SiwG SDK एक आईडी टोकन उपलब्ध कराता है. इसमें उपयोगकर्ता का sub फ़ील्ड भी शामिल होता है.
• खाता लिंक करना: उपयोगकर्ता दोनों प्लैटफ़ॉर्म पर एक ही Google खाते से साइन इन कर रहा है. इसलिए, आपको मिलने वाला sub फ़ील्ड एक जैसा होगा. इसके बाद, इस sub वैल्यू को अपने आइडेंटिटी सलूशन में मौजूद इंटरनल यूज़र आईडी से आसानी से बाइंड किया जा सकता है. इससे उपयोगकर्ताओं को एक जैसा अनुभव मिलता है.

Android पर इंटिग्रेशन

Android पर, Play Games Services SDK टूल को शुरू करें, ताकि Android डिवाइसों पर प्लैटफ़ॉर्म की पुष्टि करने की प्रोसेस अपने-आप शुरू हो जाए. इसके बाद, Android पर Google खाते से साइन इन करते समय, साइन इन करने के तीन स्कोप के लिए अनुरोध करें: email, profile, और openid. इससे आपको सर्वर-साइड ऑथराइज़ेशन कोड वापस पाने में मदद मिलती है. आपका बैकएंड, इस कोड को ऐसे आईडी टोकन के लिए बदल सकता है जिसमें उपयोगकर्ता की जानकारी शामिल होती है. इसमें यूनीक sub फ़ील्ड भी शामिल होता है.

बड़े लेवल पर, लागू करने की प्रोसेस में ये चरण शामिल होते हैं:

1. एक ही प्रोजेक्ट में क्लाइंट आईडी सेट अप करना: इंटिग्रेट करने से पहले, आपको Google Play Console में Play की गेम सेवाओं को सेट अप करना होगा, ताकि आपको OAuth 2.0 क्लाइंट आईडी मिल सकें.

2. Play Games की सेवाएं कॉन्फ़िगर करें: सबसे पहले, अपने गेम को Google Play Console में जोड़ें. इसके बाद, Play Games की सेवाओं के प्लैटफ़ॉर्म पर पुष्टि करने की सुविधा को अपने गेम के साथ इंटिग्रेट करें.

3. 'Google से साइन इन करें' बटन जोड़ना: अपने गेम के साइन-इन पेज या उपयोगकर्ता सेटिंग स्क्रीन पर, 'Google से साइन इन करें' बटन जोड़ें. इस बटन पर क्लिक करने पर, साइन इन या साइन अप करने का फ़्लो शुरू हो जाएगा. इस बटन को बनाते समय, हमारा सुझाव है कि आप 'Google से साइन इन करें' सुविधा के लिए ब्रैंडिंग के दिशा-निर्देशों का पालन करें. बटन पर कम से कम "Google" या "Google से साइन इन करें" साफ़ तौर पर दिखना चाहिए. दिशा-निर्देशों के लिंक में, डाउनलोड की जा सकने वाली ऐसी यूज़र एक्सपीरियंस (यूएक्स) ऐसेट भी दी गई हैं जो दिशा-निर्देशों का पालन करती हैं. इनका इस्तेमाल आपके गेम में किया जा सकता है.

4. साइन-इन स्कोप के साथ सर्वर ऑथराइज़ेशन कोड का अनुरोध करें: जब खिलाड़ी बटन पर क्लिक करता है, तो आपका गेम एक बार इस्तेमाल किया जा सकने वाला सर्वर ऑथराइज़ेशन कोड का अनुरोध करता है. सबसे ज़रूरी चरण यह है कि इस अनुरोध को कॉन्फ़िगर किया जाए, ताकि इसमें ये साइन-इन स्कोप शामिल हों: EMAIL, PROFILE, और OPEN_ID.

   इसे कॉन्फ़िगर करने का तरीका, आपके डेवलपमेंट एनवायरमेंट पर निर्भर करता है:

   • Java/Kotlin के लिए: requestServerSideAccess का इस्तेमाल करके, सर्वर ऑथराइज़ेशन कोड पाने के लिए गाइड देखें.

   • Unity के लिए: Unity में पुष्टि करने वाले कोड वापस पाने से जुड़ी गाइड देखें.

5. बैकएंड पर ऑथराइज़ेशन कोड को एक्सचेंज करें और आईडी टोकन की पुष्टि करें: पिछले चरण से मिले ऑथराइज़ेशन कोड को अपने बैकएंड सर्वर पर भेजें. सर्वर पर, OAuth 2.0 कोड एक्सचेंज फ़्लो की स्टैंडर्ड गाइड का पालन करें. इससे कोड को आईडी टोकन, ऐक्सेस टोकन, और रीफ़्रेश टोकन के लिए स्वैप किया जा सकता है. गाइड में बताए गए तरीके के मुताबिक, आपको अपने सर्वर पर आईडी टोकन की पुष्टि करनी होगी.

6. sub फ़ील्ड को बाइंड करें: आईडी टोकन की पुष्टि हो जाने के बाद, उसके पेलोड से sub फ़ील्ड को निकालें. इस sub वैल्यू का इस्तेमाल, अपने आइडेंटिटी सॉल्यूशन में Google आइडेंटिटी के लिए यूनीक कुंजी के तौर पर करें.

   • अगर आपके डेटाबेस में यह sub वैल्यू पहले से मौजूद है, तो इसका मतलब है कि उपयोगकर्ता ने पहले भी खाता लिंक किया था. उन्हें उनके गेम खाते में साइन इन कराएं.

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

iOS, वेब, और अन्य प्लैटफ़ॉर्म में इंटिग्रेशन

Android, iOS, वेब या पीसी के अलावा अन्य प्लैटफ़ॉर्म पर, आपको 'Google से साइन इन करें' सुविधा वाले स्टैंडर्ड SDK टूल इस्तेमाल करने होंगे. इसका मकसद Android फ़्लो जैसा ही है: सुरक्षित तरीके से Google आईडी टोकन पाना, उसे अपने बैकएंड पर भेजना, और खाते को लिंक करने के लिए sub फ़ील्ड का इस्तेमाल करना.

बड़े लेवल पर, लागू करने की प्रोसेस में ये चरण शामिल होते हैं:

1. क्लाइंट-साइड इंटिग्रेशन: अपने प्लैटफ़ॉर्म के लिए, 'Google से साइन इन करें' सुविधा वाले एसडीके को इंटिग्रेट करने के लिए, आधिकारिक दस्तावेज़ में दिए गए निर्देशों का पालन करें. इन गाइड में, क्लाइंट-साइड के पूरे फ़्लो के बारे में बताया गया है. इसमें, 'Google से साइन इन करें' बटन रेंडर करने से लेकर आईडी टोकन वापस पाने तक की जानकारी शामिल है.

   • वेब के लिए: वेब के लिए Google से साइन इन करें

   • iOS के लिए: iOS और macOS के लिए Google साइन इन

   • जिन प्लैटफ़ॉर्म के लिए कोई एसडीके उपलब्ध नहीं है (जैसे कि कस्टम गेम इंजन या पीसी बिल्ड), उनके लिए ज़रूरी टोकन पाने के लिए, OAuth 2.0 वेब सर्वर फ़्लो को मैन्युअल तरीके से लागू किया जा सकता है.

2. बैकएंड लॉजिक: आईडी टोकन (या ऑथराइज़ेशन कोड) को अपने बैकएंड पर भेजें. इसके बाद, आपका सर्वर ठीक उसी तरह से पुष्टि करता है और sub फ़ील्ड बाइंडिंग लॉजिक का इस्तेमाल करता है जैसा कि "Android पर इंटिग्रेशन" सेक्शन के चौथे और पांचवें चरण में बताया गया है.

'Google से साइन इन करें' सुविधा के सभी फ़्लो से मिले sub फ़ील्ड की वैल्यू, Android पर Google Play Games Services के फ़्लो से मिली वैल्यू के बराबर होती है. इसलिए, इस प्रोसेस से उपयोगकर्ता का खाता सभी प्लैटफ़ॉर्म पर लिंक हो जाता है.