दोस्त

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

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

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

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

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

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

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

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

  • दोस्तों की सूची लोड करें: इससे यह देखा जा सकता है कि खिलाड़ी ने गेम को दोस्तों की सूची की जानकारी ऐक्सेस करने की अनुमति दी है या नहीं. ऐक्सेस मिलने पर, आपको पुष्टि किए गए खिलाड़ी के दोस्तों से जुड़े Player ऑब्जेक्ट की सूची मिल सकती है.
  • किसी दूसरे खिलाड़ी की 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 APIs का इस्तेमाल शुरू करने से पहले, यह काम करें: