يوضّح لك هذا الدليل كيفية استخدام واجهات برمجة تطبيقات الإنجازات في أحد تطبيقات Android.
لفتح الإنجازات في لعبتك وعرضها. يمكن العثور على واجهات برمجة التطبيقات
في com.google.android.gms.games
وcom.google.android.gms.games.achievements
حزم.
قبل البدء
إذا لم تكن قد فعلت ذلك بالفعل، فقد تجد أنه من المفيد مراجعة مفاهيم ألعاب الإنجازات.
قبل بدء الترميز باستخدام واجهة برمجة تطبيقات الإنجازات:
اتّبِع التعليمات لتثبيت تطبيقك وإعداده لاستخدامه. "خدمات ألعاب Google Play" في دليل إعداد حزمة تطوير البرامج (SDK) لخدمات Google Play
يمكنك تحديد الإنجازات التي تريد أن تتيحها لعبتك أو تعرضها، من خلال باتّباع التعليمات الواردة في دليل 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?authuser=19&hl=ar)