दोस्त

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

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

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

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