दोस्त

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

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

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

  • उनके Play Games दोस्तों की सूची को दोस्तों की मौजूदा इन-गेम सूचियों के साथ मिलाएं.

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

दोस्तों को इंपोर्ट करें

बुनियादी बातें

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

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

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

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

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

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

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

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

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

Play Games को ऐक्सेस दें

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

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

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

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

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

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

लीडरबोर्ड पर मौजूद दोस्त

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

अगले चरण

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