الإعدادات عن بُعد

الإعدادات عن بُعد تتيح لك التحكّم في القيم ومفاتيح الميزات من الخادم، فتضبط لعبتك، وتتحكّم في إتاحة الميزات، وتجري التجارب دون أي تحديث لدى العميل.

النطاق: تُحدَّد الإعدادات عن بُعد لكل إصدار لعبة؛ وتصل التجاوزات المضبوطة لكل شريحة ولكل لاعب إلى قراءات اللعبة حين يسجّل اللاعب دخوله.

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

أدِر قيم الإعدادات ومفاتيح الميزات لإصدار لعبة من لوحة التحكم، وتجاوزها لشريحة أو للاعب واحد. ويصل التجاوز إلى اللعبة حين يسجّل اللاعب دخوله: فحزمة التطوير تقرأ حينها الإعدادات للاعب المسجَّل دخوله.

أدِر قيم الإعدادات عن بُعد ومفاتيح الميزات من لوحة التحكم.

افتح تبويب Code Generation في Flock → Settings واضغط Sync Schemas لتحويل كل إعداد إلى صنف C# مُحدَّد النوع. ويفترض المثال إعدادًا اسمه Gameplay بالحقول max_lives وspawn_rate وwelcome_text، ويعمل داخل دالة async:

using Flock;
using Flock.Generated.Configs;

GameplayConfig gameplay = await FlockClient.Instance.Config.GetGameplayAsync();
float spawnRate = gameplay.SpawnRate;
int maxLives = gameplay.MaxLives;

ويأتي اسم وسيط الوصول من إعدادك (Gameplay ← GetGameplayAsync)، ولا يوجد إلا بعد Sync Schemas. اجلب الإعدادات عند بدء التشغيل واقرأ القيم بدل تثبيتها في الشيفرة.وتُستخرج القيم بأولوية التحديث: فحيث ينطبق تحديث على إصدار اللعبة الجاري تحصل على القيمة المُحدَّثة، وإلا فعلى قيمة الإعداد نفسه — ولا تعرف شيفرتك أيّهما حدث.للاعب المسجَّل دخوله. حين يكون لاعب مسجَّل الدخول، تُعيد القراءة القيم التي يحسبها الخادم لذلك اللاعب: لإعدادات اللعب والميزات، أحدث تحديث، ثم تجاوزات الشرائح التي ينتمي إليها، ثم تجاوزات اللاعب نفسه (أما أنواع الإعدادات الأخرى فلا تجاوزات لها، وتُقرأ كما تُقرأ دون تسجيل دخول). وحين لا يكون أحد مسجَّل الدخول، تُعيد القيم العامة للعبة. وبعد أن يجيب الخادم تُحفظ قيم اللاعب طوال تسجيل الدخول ذاك، فاللعبة التي تقرأ إعدادًا قبل دخول اللاعب (في شاشة العنوان مثلًا) تقرؤه مجددًا بعد دخوله، في معالج FlockEvents.OnAuthenticated مثلًا. وإن لم تتلقَّ قراءة اللاعب جوابًا، أعادت القراءة قيم اللاعب المحفوظة، وإلا فالقيم العامة للعبة، وطلبت قيم اللاعب مجددًا في قراءة بعد 30 ثانية أو أكثر.ويحسب الخادم قيم اللاعب لإصدار اللعبة الذي يرسله البناء، وإلا فللإصدار الذي سجّل اللاعب دخوله به آخر مرة. ولا تُعيد القراءة القيم العامة للعبة، مع تحذير واحد في الـ Console لتسجيل الدخول ذاك، إلا حين لا يجد أيًّا منهما (لا يرسل البناء إصدارًا، إذ لم يُستخرج أيّ إصدار في Flock → Settings، ولا إصدار مسجَّلًا للاعب). فاستخرج إصدار اللعبة في Flock → Settings → Configuration، فيحصل اللاعب على قيمه الخاصة من قراءته التالية بعد تسجيل الدخول.وحين تكون الذاكرة المؤقتة دون اتصال مفعّلة (Flock → Settings → Advanced Settings، Offline Cache)، تُحفظ قراءات الإعدادات على القرص وتُقدَّم منه حين يتعذّر الوصول إلى الخادم، لكل لاعب على حدة: فيحصل اللاعب العائد على قيمه الأخيرة دون اتصال، لا قيم لاعب آخر أبدًا، ويحصل اللاعب الذي لم تُقرأ قيمه عبر الإنترنت قط على القيم العامة. وتحتاج الذاكرة المؤقتة إلى قراءة واحدة ناجحة عبر الإنترنت لتمتلئ، والرفض الذي يقول إن اللاعب أو الإعداد غير موجود، أو إنه لا إصدار لعبة للقراءة، يحذف النسخة المحفوظة لذلك اللاعب.

توليد الكود هو المسار المقصود هنا، لا مجرّد تسهيل. فوسائط الوصول المُولَّدة المُحدَّدة النوع هي الواجهة البرمجية العامة؛ ودون مزامنة، تقرأ GetByConfigIdAsync<T>(configId) إعدادًا بمعرّفه إلى صنف من صنعك.

Flock Resolve Config Data تعيد القيم الفعّالة لإصدار اللعبة قيد التشغيل — قيم التحديث إن وُجد تحديث منطبق، وبيانات الإعداد نفسه فيما عدا ذلك. ولا يعرف مخطّطك أيّ الحالتين وقعت.

#include "FlockSubsystem.h"

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

// The config's Id comes from its name, as the dashboard shows it.
const TWeakObjectPtr<UFlockSubsystem> Flock = Sdk;
Sdk->GetConfigProvider()->GetConfigByName(TEXT("difficulty"), [Flock](TFlockResult<FFlockGameConfigSchema> Config)
{
    if (!Config.bSuccess || !Flock.IsValid())
    {
        return;
    }
    Flock->GetConfigProvider()->ResolveConfigData(Config.Value.Id, [](TFlockResult<FFlockStructuredData> Data)
    {
        int32 Enemies = 5;   // your own default, kept when the read fails or the value is missing
        if (Data.bSuccess)
        {
            Data.Value.TryGetInt(TEXT("enemies.count"), Enemies);
        }
    });
});

يُستنتج الإعداد بمعرّفه Id، الذي تقرؤه GetConfigByName (Flock Get Config By Name) من الاسم الذي تعرضه لوحة التحكم. واقرأ القيمة بمسارها المنقوط، محتفظًا بقيمتك الافتراضية حين تكون مفقودة: ففي Blueprint تأخذ كلٌّ من Get Data Int وGet Data Float وGet Data String وGet Data Bool مسارًا وقيمة احتياطية.

حدث مخصّص Load Difficulty، ثم Flock Get Config By Name للإعداد difficulty، ثم Flock Resolve Config Data بمعرّفه، ثم Get Data Int للمسار enemies.count بالقيمة الاحتياطية 5 إلى Print String — اقرأ إعداد الصعوبة باسمه، واستنتجه، واقرأ منه قيمة واحدة بقيمة احتياطية.

وبعد مزامنة المخطّطات تصبح عقدة واحدة تعيد بنية مُحدَّدة النوع:

عقدة ماكرو Get Gameplay مولَّدة تغذّي عقدة Break — Get Gameplay تجلب القيم وتستنتجها وتعيد بنية مُحدَّدة النوع — فكّكها للحصول على أطراف حقيقية.

للاعب المسجَّل دخوله. حين يكون لاعب مسجَّل الدخول، تُعيد Flock Resolve Config Data (وعقد Get المُولَّدة التي تستدعيها) القيم التي يحسبها الخادم لذلك اللاعب: لإعدادات اللعب والميزات، أحدث تحديث، ثم تجاوزات الشرائح التي ينتمي إليها، ثم تجاوزات اللاعب نفسه (أما أنواع الإعدادات الأخرى فلا تجاوزات لها، وتُقرأ كما تُقرأ دون تسجيل دخول). وحين لا يكون أحد مسجَّل الدخول، تُعيد القيم العامة للعبة. وبعد أن يجيب الخادم تُحفظ قيم اللاعب طوال تسجيل الدخول ذاك، فاللعبة التي تقرأ إعدادًا قبل دخول اللاعب (في شاشة العنوان مثلًا) تقرؤه مجددًا بعد دخوله: اربط On Authenticated على مركز الأحداث واستنتج الإعداد من جديد هناك. وإن رُفضت قراءة اللاعب (لا يعرف الخادم لاعبًا كهذا، أو لا إصدار لعبة لديه للقراءة، أو لا إعداد بذلك الاسم)، أجابت القيم العامة للعبة بقية تسجيل الدخول؛ وإن لم تتلقَّ جوابًا، أجابت قيم اللاعب المحفوظة، وإلا فالقيم العامة للعبة، وأُرسلت قراءة اللاعب مجددًا في قراءة بعد 30 ثانية أو أكثر.وحين لا يتلقّى الخادم إصدار لعبة مع الطلب، تُعيد القراءة القيم العامة للعبة، ويعرض Output Log تحذيرًا واحدًا لتسجيل الدخول ذاك، مع طريقة الإصلاح: استخرج إصدار اللعبة (Tools → Flock → Resolve Game Version، أو Project Settings → Plugins → Flock SDK Settings).وتُخزَّن قراءات الإعدادات مؤقتًا وتُقدَّم من القرص عند تعذّر الوصول إلى الخادم، لكل لاعب على حدة: فيحصل اللاعب العائد على قيمه الأخيرة دون اتصال، لا قيم لاعب آخر أبدًا، ويحصل اللاعب الذي لم تُقرأ قيمه عبر الإنترنت قط على القيم العامة.

أنماط الاستخدام

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

وفّر دائمًا قيمًا افتراضية آمنة لدى العميل حتى تبقى لعبتك قابلة للعب إذا فشل جلب الإعدادات.

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

المفاهيم

الميزات

المرجع

الإعدادات عن بُعد

أنماط الاستخدام

​أنماط الاستخدام

أنماط الاستخدام