الإنجازات

الإنجاز في Flock نوع من الإعدادات/القوالب — يُعرَّف إلى جانب إعدادات لعبتك وقوالب اللاعبين — ويُولّد تلقائيًا مدخل بيانات لاعب لتتبّع تقدّم كل لاعب. فأنت لا تستدعي واجهة برمجية منفصلة للإنجازات: تضبط الإنجاز، وتُهيّئ Flock بيانات اللاعب المقابلة لتقرأها وتحدّثها.

النطاق: تُضبط الإنجازات لكل إصدار لعبة (كإعدادات لعبة + قوالب لاعبين).

لوحة التحكم
Unity
Unreal

عرِّف الإنجازات من صفحة إعدادات الإنجازات — وهي المرجع الأوحد. يصبح كل إنجاز جزءًا من إعدادات لعبتك وقوالب اللاعبين، وتُنشئ Flock مدخل بيانات لاعب يحمل التقدّم.

تأخذ UnlockAchievementAsync اسم الإنجاز، أو تعدادًا مُولَّدًا بعد Sync Schemas (تبويب Code Generation) فيستحيل أن تخطئ في كتابته. وتتولّى حزمة التطوير استنتاج الصف الموسوم achievement نيابةً عنك. وتعمل الأمثلة داخل دالة async.

using Flock;
using Flock.Generated.Achievements;
using Flock.Models;

PlayerData row = await FlockClient.Instance.Commands.UnlockAchievementAsync("first_win");

// بعد المزامنة — مُحدَّد النوع، فالاسم غير الموجود على الخادم يفشل عند الترجمة:
row = await FlockClient.Instance.Commands.UnlockAchievementAsync(FlockAchievementId.FirstWin);

والنسخة المُحدَّدة النوع إضافية — إذ تبقى نسخة النص الخام متاحة — لكن فضّلها عليها.سجلّ الإنجازات يأتي من التسجيل. يصنع الخادم سجلّ إنجازات اللاعب حين يسجّل، من قالب الإنجازات في إصدار اللعبة (قالب بيانات لاعب موسوم achievement). فاللاعب الذي سجّل قبل وجود ذلك القالب، أو تحت إصدار لعبة آخر، لا سجلّ له، وترمي UnlockAchievementAsync استثناء FlockValidationException يقول ذلك: أنشئ القالب أولًا، ثم سجّل اللاعبين تحت إصدار اللعبة الذي تستخدمه هذه النسخة.وإن كنت تحتفظ بتفاصيل الإنجاز (الاسم المعروض، والوصف، والمكافأة) في إعداد موسوم achievement، فإن توليد الكود يربطها بالتعداد نفسه، فتمنح الإنجاز وتقرأ تفاصيله بقيمة واحدة. والنوع مُولَّد من إعدادك أنت: هنا إعداد اسمه achievements فيه حقل قائمة achievements لمدخلاته name وdescription.

using Flock;
using Flock.Generated.Achievements;
using Flock.Generated.Configs;
using UnityEngine;

// تُعيد المدخل المطابق، أو null حين لا يحوي الإعداد مدخلًا له.
AchievementsConfigAchievementsItem firstWin =
    await FlockClient.Instance.Config.GetAchievementDetailsAsync(FlockAchievementId.FirstWin);
if (firstWin != null)
    Debug.Log(firstWin.Description);

وتُصفّ عمليات الفتح في طابور دون اتصال وتُعاد عند عودة الاتصال.

تأخذ Flock Unlock Achievement اسم الإنجاز، أو قائمة منسدلة مُولَّدة بعد مزامنة المخطّط بحيث يستحيل أن تخطئ في كتابته. وتتكفّل حزمة التطوير بإيجاد الصف الموسوم بـ achievement نيابةً عنك.

#include "FlockSubsystem.h"

UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);   // this: any object in the game's world

Sdk->GetCommandProvider()->UnlockAchievement(TEXT("first_win"), [](TFlockResult<FFlockPlayerData> Unlocked) {});

// After Code Generation's sync, with the id baked in:
FFlockGenerated::UnlockAchievement(this, EFlockAchievementId::FirstWin, [](TFlockResult<FFlockPlayerData> Unlocked) {});

وعمليات الفتح تُصفّ في طابور عند انقطاع الاتصال وتُعاد عند عودته.

الإنجازات تُضبط ولا تُبرمج. عرِّفها من صفحة إعدادات الإنجازات، ثم تكشفها لك حزمة التطوير عبر إعدادات اللعبة وبيانات اللاعب.

بدء الاستخدام

المفاهيم

الميزات

المرجع

الإنجازات