Google साइन-इन एपीआई के बंद होने के बाद, हम 2026 में Games v1 SDK टूल को हटा रहे हैं. फ़रवरी 2025 के बाद, Google Play पर ऐसे टाइटल पब्लिश नहीं किए जा सकेंगे जिन्हें हाल ही में games v1 SDK टूल के साथ इंटिग्रेट किया गया है. हमारा सुझाव है कि आप इसके बजाय,
games v2 SDK टूल का इस्तेमाल करें.
पिछले गेम के v1 इंटिग्रेशन वाले मौजूदा टाइटल कुछ साल तक काम करते रहेंगे. हालांकि, हमारा सुझाव है कि आप जून 2025 से v2 पर माइग्रेट करें.
यह गाइड, Play Games Services v1 SDK टूल का इस्तेमाल करने के लिए है. SDK टूल के नए वर्शन के बारे में जानकारी पाने के लिए, v2 दस्तावेज़ देखें.
इस गाइड में, Android ऐप्लिकेशन में लीडरबोर्ड एपीआई का इस्तेमाल करने का तरीका बताया गया है. इससे, विज़ुअल लीडरबोर्ड बनाने, खिलाड़ी का स्कोर रिकॉर्ड करने, और स्कोर की तुलना गेम के पिछले सेशन में खिलाड़ी के स्कोर से करने में मदद मिलती है. एपीआई, com.google.android.gms.games और com.google.android.gms.games.leaderboards पैकेज में मिल सकते हैं.
शुरू करने से पहले
अगर आपने अब तक ऐसा नहीं किया है, तो लीडरबोर्ड गेम के कॉन्सेप्ट की समीक्षा करना आपके लिए मददगार हो सकता है.
लीडरबोर्ड एपीआई का इस्तेमाल करके कोड लिखने से पहले:
- Google Play services SDK टूल सेट अप करें गाइड में दिए गए निर्देशों का पालन करके, अपने ऐप्लिकेशन को इंस्टॉल और सेट अप करें. इससे, आपको Google Play Games Services का इस्तेमाल करने में मदद मिलेगी.
- Google Play Console की गाइड में दिए गए निर्देशों का पालन करके, उन लीडरबोर्ड की जानकारी दें जिन्हें आपको अपने गेम में दिखाना है या अपडेट करना है.
- Android के सैंपल पेज पर, लीडरबोर्ड के कोड सैंपल डाउनलोड करें और उनकी समीक्षा करें.
- क्वालिटी की चेकलिस्ट में दिए गए सुझावों के बारे में जानें.
लीडरबोर्ड क्लाइंट पाना
लीडरबोर्ड एपीआई का इस्तेमाल शुरू करने के लिए, आपके गेम को पहले LeaderboardsClient ऑब्जेक्ट पाना होगा.
ऐसा करने के लिए, Games.getLeadeboardsClient() तरीके को कॉल करें और मौजूदा प्लेयर के लिए गतिविधि और GoogleSignInAccount को पास करें. खिलाड़ी के खाते की जानकारी वापस पाने का तरीका जानने के लिए, Android Games में साइन इन करना लेख पढ़ें.
खिलाड़ी का स्कोर अपडेट करना
जब प्लेयर का स्कोर बदलता है (उदाहरण के लिए, जब प्लेयर गेम पूरा कर लेता है), तो आपका गेम लीडरबोर्ड पर उसका स्कोर अपडेट कर सकता है. इसके लिए, LeaderboardsClient.submitScore() को कॉल करके, लीडरबोर्ड आईडी और रॉ स्कोर की वैल्यू को पास करना होगा.
नीचे दिया गया कोड स्निपेट दिखाता है कि आपका ऐप्लिकेशन, खिलाड़ी का स्कोर कैसे अपडेट कर सकता है:
Games.getLeaderboardsClient(this, GoogleSignIn.getLastSignedInAccount(this))
.submitScore(getString(R.string.leaderboard_id), 1337);अपनी strings.xml फ़ाइल में लीडरबोर्ड आईडी तय करना एक अच्छा तरीका है, ताकि आपका गेम रिसॉर्स आईडी के हिसाब से लीडरबोर्ड का रेफ़रंस दे सके. खिलाड़ियों के स्कोर अपडेट करने और लोड करने के लिए कॉल करते समय, एपीआई कोटा से ज़्यादा कॉल करने से बचने के लिए, इन सबसे सही तरीकों का पालन करना न भूलें.
लीडरबोर्ड दिखाना
लीडरबोर्ड दिखाने के लिए, LeaderboardsClient.getLeaderboardIntent() को कॉल करें. इससे आपको डिफ़ॉल्ट लीडरबोर्ड यूज़र इंटरफ़ेस बनाने के लिए, Intent मिलेगा. इसके बाद, आपका गेम startActivityForResult को कॉल करके यूज़र इंटरफ़ेस (यूआई) दिखा सकता है.
नीचे दिया गया कोड स्निपेट दिखाता है कि आपका ऐप्लिकेशन, खिलाड़ी का स्कोर कैसे अपडेट कर सकता है. कोड स्निपेट में, RC_LEADERBOARD_UI अनुरोध कोड के लिए कोई भी पूर्णांक हो सकता है.
private static final int RC_LEADERBOARD_UI = 9004; private void showLeaderboard() { Games.getLeaderboardsClient(this, GoogleSignIn.getLastSignedInAccount(this)) .getLeaderboardIntent(getString(R.string.leaderboard_id)) .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_LEADERBOARD_UI); } }); }
ध्यान दें कि कोई नतीजा न मिलने पर भी, हमें startActivityForResult का इस्तेमाल करना होगा, ताकि एपीआई कॉल करने वाले पैकेज की पहचान कर सके. डिफ़ॉल्ट लीडरबोर्ड यूज़र इंटरफ़ेस (यूआई) का उदाहरण नीचे दिया गया है.
