दोस्त

अपने गेम में दोस्तों की सुविधा जोड़ने और मौजूदा इन-गेम दोस्तों की सूची और अन्य सोशल सिस्टम को बेहतर बनाने के लिए, Friends APIs का इस्तेमाल करें. इससे, खिलाड़ियों को ये काम करने में मदद मिलती है:

  • आपके गेम में अपने दोस्तों को ढूंढना.

  • लीडरबोर्ड पर अपने दोस्तों के साथ स्कोर की तुलना करना.

  • Play Games में मौजूद दोस्तों की सूची को, गेम में मौजूद दोस्तों की सूची के साथ जोड़ना.

  • इन-गेम प्रोफ़ाइल के पॉप-अप की मदद से, किसी अन्य खिलाड़ी की पहचान करना. इस पॉप-अप में, मौजूदा खिलाड़ी की ओर से अपने दोस्त को दिया गया निकनेम दिखता है. इससे उन्हें पता चलता है कि वे किसके साथ खेल रहे हैं.

दोस्तों को इंपोर्ट करना

आम जानकारी

इन एपीआई की मदद से, ये कार्रवाइयां की जा सकती हैं:

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

Play Games में मौजूद दोस्तों की सूची इंपोर्ट करना

Friends APIs का इस्तेमाल करके, अपने खिलाड़ियों के Play Games में मौजूद दोस्तों की सूची पाई जा सकती है. साथ ही, उन्हें गेम में मौजूद दोस्तों की सूची में जोड़ा जा सकता है.

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

अपने गेम में Play Games में मौजूद दोस्तों को जोड़ना

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

बैकएंड सर्वर से दोस्तों की सूची का इस्तेमाल करते समय, उसे सुरक्षित तरीके से लोड करें. इसके लिए, Android API के नतीजे को पास करने के बजाय, REST API का इस्तेमाल करें. पक्का करें कि फ़िलहाल पुष्टि किए गए खिलाड़ी के लिए, REST API में players.get(me) से मिली प्लेयर आईडी का इस्तेमाल किया जाए. ऐसा इसलिए, क्योंकि यह आईडी अन्य खिलाड़ियों को दिखने वाली आईडी के जैसी ही होगी.

अगर दोस्तों की सूची को सेव नहीं किया जाता है (सिर्फ़ देखते समय इस्तेमाल किया जाता है), तो कोई और काम करने की ज़रूरत नहीं है.

Play Games का ऐक्सेस देना

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

किसी अन्य खिलाड़ी की प्रोफ़ाइल देखना

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

किसी दूसरे खिलाड़ी की प्रोफ़ाइल देखना

सोशल लीडरबोर्ड

Friends APIs का इस्तेमाल, लीडरबोर्ड के लिए भी किया जा सकता है. इस सुविधा का इस्तेमाल करके, मौजूदा खिलाड़ी की रैंकिंग को Play Games में मौजूद उसके दोस्तों के बीच दिखाया जा सकता है. ध्यान दें कि यह सुविधा सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्होंने आपके ऐप्लिकेशन के साथ यह जानकारी शेयर की है. साथ ही, यह सुविधा तब उपलब्ध होती है, जब उपयोगकर्ता Play Games में दोस्त हों. इस सुविधा को चालू करने के लिए, गेम में उपयोगकर्ता के लिए एक कंट्रोल उपलब्ध कराया जाता है. यह कंट्रोल, लीडरबोर्ड के सोशल व्यू को चुनने के लिए, collection आर्ग्युमेंट का इस्तेमाल करता है. ज़्यादा जानने के लिए, सार्वजनिक और सोशल लीडरबोर्डके बारे में जानकारी देने वाला सेक्शन देखें.

अगर सोशल लीडरबोर्ड कलेक्शन लागू किया जाता है, तो लीडरबोर्ड के स्कोर लोड करने के लिए किए गए कॉल से, अनुमति की ज़रूरत वाली रिज़ॉल्यूशन से जुड़ी गड़बड़ी मिल सकती है. यह गड़बड़ी, से मिलने वाली गड़बड़ी जैसी ही होती है loadFriends(). अगर Play Games की ओर से उपलब्ध कराए गए डिफ़ॉल्ट यूज़र इंटरफ़ेस (यूआई) को लागू किया जाता है (उदाहरण के लिए, getLeaderboardIntent()), तो यह गड़बड़ी अपने-आप ठीक हो जाती है.

अगले चरण

Friends APIs का इस्तेमाल शुरू करने से पहले, यह काम करें: