दोस्त

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

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

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

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

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

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

बुनियादी जानकारी

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

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

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

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

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

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

अगले चरण

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