दोस्त

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

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

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

  • 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 API का इस्तेमाल शुरू करने से पहले, यह काम करें: