यह गाइड आपको किसी Android ऐप्लिकेशन में उपलब्धियों के एपीआई इस्तेमाल करने का तरीका बताती है
का इस्तेमाल, आपके गेम में उपलब्धियां अनलॉक करने और दिखाने के लिए किया जाता है. एपीआई यहां मिल सकते हैं
com.google.android.gms.games
में
और com.google.android.gms.games.achievements
पैकेज.
शुरू करने से पहले
अगर आपने अब तक ऐसा नहीं किया है, तो आपको अब इसकी समीक्षा करने में मदद मिल सकती है: उपलब्धियों के गेम के कॉन्सेप्ट के बारे में ज़्यादा जानें.
उपलब्धियां एपीआई का इस्तेमाल करके कोड करने से पहले:
इस्तेमाल करने के लिए, ऐप्लिकेशन को इंस्टॉल और सेट अप करने के निर्देशों का पालन करें Google Play की गेम सेवाओं के बारे में Google Play Services का SDK टूल सेट अप करने से जुड़ी गाइड.
वे उपलब्धियां तय करें जिन्हें आप अपने गेम को अनलॉक करना या दिखाना चाहते हैं Google Play Console की गाइड में दिए गए निर्देशों का पालन करें.
इसमें उपलब्धियों के कोड के सैंपल डाउनलोड करें और उनकी समीक्षा करें: Android सैंपल पेज.
यहां दिए गए सुझावों के बारे में जानें क्वालिटी चेकलिस्ट.
उपलब्धियां पाने वाला क्लाइंट पाएं
उपलब्धियां एपीआई का इस्तेमाल शुरू करने के लिए, आपके गेम को पहले
AchievementsClient
ऑब्जेक्ट है. ऐसा करने के लिए,
Games.getAchievementClient()
पास करने का तरीका और गतिविधि पास करना.
उपलब्धियां अनलॉक करें
उपलब्धि को अनलॉक करने के लिए,
AchievementsClient.unlock()
विधि और उपलब्धि आईडी में पास करें.
नीचे दिया गया कोड स्निपेट दिखाता है कि आपका ऐप्लिकेशन किस तरह उपलब्धियां अनलॉक कर सकता है:
PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));
अगर उपलब्धि इंक्रीमेंटल टाइप की है (यानी, कई चरणों को
इसे अनलॉक करना ज़रूरी है), इसके बजाय AchievementsClient.increment()
पर कॉल करें.
नीचे दिया गया कोड स्निपेट यह दिखाता है कि आपका ऐप्लिकेशन प्लेयर की उपलब्धि:
PlayGames.getAchievementsClient(this).increment(getString(R.string.my_achievement_id), 1);
उपलब्धि को अनलॉक करने के लिए आपको कोई और कोड लिखने की ज़रूरत नहीं है; Google Play की गेम सेवाएं उपलब्धि की आवश्यक संख्या तक पहुंचने पर उसे अपने आप अनलॉक कर देता है चरण पूरे करें.
strings.xml
फ़ाइल में उपलब्धि आईडी तय करना एक अच्छा तरीका है, इसलिए
अपने गेम में रिसॉर्स आईडी की मदद से, उपलब्धियों का रेफ़रंस दिया जा सकता है. इन्हें कॉल करते समय
उपलब्धियों को अपडेट करें और लोड करें. साथ ही, पक्का करें कि आपने
अपने एपीआई को आगे बढ़ाने से बचने के सबसे सही तरीके
कोटा.
उपलब्धियां दिखाएं
किसी खिलाड़ी की उपलब्धियां दिखाने के लिए, AchievementsClient.getAchievementsIntent()
पर कॉल करें
पाने के लिए
Intent
का इस्तेमाल करें. ऐसा करने से, आपके गेम से
कॉल करके यूज़र इंटरफ़ेस (यूआई)
startActivityForResult
.
नीचे दिया गया कोड स्निपेट दिखाता है कि आपका ऐप्लिकेशन डिफ़ॉल्ट पेज को कैसे दिखा सकता है
उपलब्धि का यूज़र इंटरफ़ेस. स्निपेट में, RC_ACHIEVEMENT_UI
एक आर्बिट्रेरी है
वह पूर्णांक, जिसका इस्तेमाल गेम, अनुरोध कोड के तौर पर करता है.
private static final int RC_ACHIEVEMENT_UI = 9003; private void showAchievements() { PlayGames.getAchievementsClient(this) .getAchievementsIntent() .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_ACHIEVEMENT_UI); } }); }
यहां डिफ़ॉल्ट उपलब्धियों के यूज़र इंटरफ़ेस (यूआई) का उदाहरण दिखाया गया है.
![](https://developer.android.com/static/images/games/pgs/achievements_android.png?hl=hi)