दोस्त

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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