العملات والمحافظ

العملات هي الوحدات التي يقوم عليها اقتصادك — قطع نقدية، أو جواهر، أو طاقة، أو أي شيء آخر. وتُعرّف كل لعبة عملاتها الخاصة، ولكل لاعب محفظة تحمل أرصدته.

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

عرِّف عملاتك من لوحة التحكم — العملة ليست سوى وحدة لها اسم، وأنت من يقرّر إن كانت تُكتسب أم تُشترى أم الاثنين معًا. ويمكنك أيضًا تفقّد محافظ اللاعبين من هنا.

العملات والمحافظ — عرِّف العملات وتفقّد محافظ اللاعبين من لوحة التحكم.

تُضيف AddGameFundsAsync رصيدًا إلى محفظة اللاعب المسجَّل دخوله. وتتولّى حزمة التطوير استنتاج قالب اللاعب الموسوم currency نيابةً عنك؛ ومزامنة المخططات تُضمّن معرّفه فيتخطّى الاستدعاء ذلك البحث. أما الأرصدة فتُقرأ كبيانات لاعب عادية — فالمحفظة هي صفّ ذلك القالب.

// منح رصيد. يستنتج القالب الموسوم "currency" أثناء التشغيل.
PlayerData wallet = await FlockClient.Instance.Commands.AddGameFundsAsync("gold", 500);

// بعد Code Generation ← Sync Schemas، بعملة مُحدَّدة النوع:
wallet = await FlockClient.Instance.Commands.AddGameFundsAsync(FlockFundId._100, 500);

// اقرأ أرصدة اللاعب المسجَّل دخوله.
PlayerData balances = await FlockClient.Instance.Player.GetMyDataByTagAsync("currency");

منح الأرصدة آمن ماليًا. فالمنح يفشل بدل أن يُصفّ في طابور حين يتعذّر الوصول إلى الخادم، ولا يُعاد إرساله أبدًا بعد فشل غامض — إذ قد يعني انتهاء المهلة أن الرصيد أُضيف فعلًا، ولن تخاطر حزمة التطوير بإضافته مرتين. ولا يُعاد إلا ما لم يُعالَج قطعًا (408/429)، لذا غلِّف الاستدعاء بـtry/catch ودع اللاعب يعيد المحاولة عن قصد.

أعضاء FlockFundId هي معرّفات العملات لا أسماؤها (ومن هنا _100 — تُضاف شرطة سفلية في البداية حين يبدأ المعرّف برقم). فأسماء العملات لا توجد إلا في نقطة النهاية الإدارية في لوحة التحكم، وهي خارج متناول مفتاح حزمة التطوير.

تُضيف Flock Add Game Funds رصيدًا إلى محفظة اللاعب المسجَّل دخوله. وتتكفّل حزمة التطوير بإيجاد القالب الموسوم بـ currency، ومزامنة المخطّط تُضمِّن معرّفه فيتخطّى الاستدعاء هذا البحث.

Sdk->GetCommandProvider()->AddGameFunds(TEXT("coins"), 250, OnCredited);

// After a sync, with a typed currency:
FFlockGenerated::AddFunds(this, EFlockCurrencyId::Gold, 100, OnCredited);

عمليات المنح آمنة ماليًا. فالمنح يفشل بدل أن يُصفّ في طابور حين يتعذّر الوصول إلى الخادم، ولا يُعاد إرساله أبدًا بعد فشل غامض — إذ قد يعني انتهاء المهلة أن الرصيد أُضيف فعلًا، ولن تخاطر حزمة التطوير بإضافته مرتين. واقرأ الأرصدة كما تقرأ أي بيانات لاعب عادية.

تخصم عمليات الشراء من المتجر من المحفظة المعنية تلقائيًا كجزء من المعاملة — فلا داعي لتعديل الأرصدة بيدك في أي عملية شراء اعتيادية.

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

المفاهيم

حزم التطوير

الميزات

المرجع

العملات والمحافظ