على اللاعب الجديد أن يُنشئ حسابًا قبل أن يستطيع الدخول. فدوال LoginWith…Async لا تُنشئ حسابًا أبدًا — إنما تُدخل حسابًا قائمًا. واستدعاؤها لمن لم يسجّل قط يفشل بالرمز player.invalid_login_credentials ‏(FlockErrorCode.PlayerInvalidLoginCredentials).ويقع أكثر الناس في هذا عند الدخول بمعرّف الجهاز، إذ يبدو تدفّق ضيف يُفترض أن يعمل مباشرة. سجّل الدخول، وأنشئ الحساب حين لا يكون للجهاز حساب بعد:

using Flock;
using Flock.Exceptions;

try
{
    // كل تشغيل بعد الأول.
    await FlockClient.Instance.Authentication.LoginWithDeviceAsync();
}
catch (FlockException notRegistered) when (notRegistered.ErrorCode == FlockErrorCode.PlayerInvalidLoginCredentials)
{
    // أول تشغيل على هذا الجهاز: يُنشئ الحساب ويُدخل اللاعب معًا.
    await FlockClient.Instance.Authentication.RegisterWithDeviceAsync();
}

وتسجيل هوية لها حساب بالفعل لا يرمي استثناءً — بل يُعيد null ويترك اللاعب خارج الجلسة، ولذلك يجب أن يتبع التسجيلَ الذي يُعيد null تسجيلُ دخول.

ونجاح RegisterWith…Async يُدخل اللاعب أيضًا، فلا حاجة إلى استدعاء ثانٍ في المسار الطبيعي. ودون معرّف، تستعمل استدعاءات الجهاز معرّف الجهاز الذي تصنعه الحزمة في أول تشغيل وتحفظه لهذا التثبيت. واللعبة التي سجّلت دخول لاعبيها بمعرّف خاص بها من قبل (مثل SystemInfo.deviceUniqueIdentifier) تستمرّ في تمرير ذلك المعرّف، وإلا نال لاعبوها حسابات جديدة؛ والتفاصيل في أول استدعاء لك. وإن أخطأت الترتيب فإن الاستثناء يخبرك بذلك ويسمّي الدالة التي ينبغي استدعاؤها؛ راجع معالجة الأخطاء.

كل طريقة عقدة غير متزامنة ضمن Flock | Auth بمنفذَي On Success وOn Failure، أو استدعاء على مزوّد المصادقة في C++. وتستبدل حزمة التطوير بيانات الاعتماد التي أنتجتها حزمة تطوير منصّتك بجلسة Flock.

#include "FlockSubsystem.h"
#include "Providers/FlockAuthProvider.h"

UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);   // this: any object in the game's world
if (Sdk->IsAuthenticated())
{
    return;   // Signed in already: a second sign-in would end this one.
}

// Email and Password: what the player typed into your sign-in screen.
Sdk->GetAuthProvider()->LoginWithEmail(Email, Password,
    [](TFlockResult<FFlockPlayerLoginResponse> Result)
    {
        if (Result.bSuccess) { /* Result.Value.PlayerId */ }
    });

يجب أن يُنشئ اللاعب الجديد حسابًا قبل أن يستطيع تسجيل الدخول. فـ LoginWith… لا تُنشئ حسابًا أبدًا: واستدعاؤها لشخص لم يُنشئ حسابًا قط يفشل بالرمز player.invalid_login_credentials. أما RegisterWith… الناجحة فتُنشئ الحساب وتُسجّل دخول اللاعب. وتسجيل هوية لها حساب بالفعل يُبلَّغ عنه على أنه نجاح مع ضبط bAlreadyRegistered، ويترك اللاعب دون تسجيل دخول، فأتبِعه بتسجيل دخول.

في تسجيل الدخول بالجهاز، لا تسجّل الدخول إلا حين لا يكون أحد قد سجّل دخوله بعد (إذ يُستعاد تسجيل الدخول المحفوظ حين تبدأ الحزمة، وتسجيل دخول ثانٍ يُنهي الجلسة التي بدأها الأول)، ثم أنشئ الحساب أولًا، وسجّل الدخول حين يكون للجهاز حساب بالفعل. واترك معرّف الجهاز فارغًا: فتستخدم استدعاءات الجهاز حينها المعرّف الذي تُنشئه الحزمة مرة واحدة وتحفظه لهذا التثبيت.

#include "FlockSubsystem.h"

void AMyActor::SignInWithThisDevice()
{
    UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);   // this: any object in the game's world
    if (!Sdk || !Sdk->IsInitialized() || Sdk->IsAuthenticated())
    {
        return;   // Not started, or a player is signed in already: Flock restores a saved sign-in as it starts.
    }

    const TWeakObjectPtr<UFlockSubsystem> Flock = Sdk;

    // An empty device ID: this install's own. Name: an optional display name, unique in the game; empty leaves it out.
    Sdk->GetAuthProvider()->RegisterWithDevice(FString(), FString(), [Flock](TFlockResult<FFlockRegisterResult> Registered)
    {
        if (!Registered.bSuccess)
        {
            UE_LOG(LogTemp, Warning, TEXT("%s"), *Registered.Error.ToDisplayText());   // what is wrong, then a Fix: line
            return;
        }
        if (!Registered.Value.bAlreadyRegistered)
        {
            return;   // a new account, and the player is signed in: Registered.Value.Response.PlayerId
        }

        // This device already has an account, and registering left the player signed out: log in.
        if (Flock.IsValid())
        {
            Flock->GetAuthProvider()->LoginWithDevice(FString(), [](TFlockResult<FFlockPlayerLoginResponse> LoggedIn)
            {
                if (!LoggedIn.bSuccess)
                {
                    UE_LOG(LogTemp, Warning, TEXT("%s"), *LoggedIn.Error.ToDisplayText());
                }
            });
        }
    });
}

وتحفظ الحزمة ذلك المعرّف في Saved/Flock/device_id.txt؛ واقرأه بـ ThisDeviceId() على مزوّد المصادقة (Flock Get This Device Id في Blueprint). أما أي معرّف آخر فيُرسَل كما تمرّره تمامًا، واللعبة التي تسجّل دخول اللاعبين أصلًا بمعرّف جهاز من عندها يجب أن تواصل تمريره، وإلا حصل أولئك اللاعبون على حساب جديد فارغ: وتقول صفحة Unreal SDK متى تمرّر معرّفك. وكل استدعاء RegisterWith… يأخذ المعامل Name نفسه: اسم عرض يُبقيه الخادم فريدًا (تحقّق منه أولًا بـ IsNameAvailable)، أو فارغًا إن لم يكن هناك اسم. أما Facebook وDiscord فللدخول فقط؛ إذ يجب أن يكون الحساب موجودًا سلفًا. ويُطلق تسجيل الدخول On Authenticated في أحداث Flock ‏(GetEvents())، أيًّا كان الاستدعاء الذي أجراه.وفي Blueprint ابدأ بـ Branch على Flock Is Authenticated، ولا تسجّل الدخول إلا عند False. وتأخذ Flock Register With Device ‏Device Id وName؛ ويحمل On Success فيها النتيجة، التي تقول Already Registered فيها أن تُتبعها بـ Flock Login With Device. واترك Device Id فارغًا في كلتيهما لتستخدم معرّف هذا التثبيت؛ والصورة تمرّر إليهما مُدخل Device Id الخاص بالحدث، فاستدعِ الحدث وهو فارغ. وتعرض صفحة Unreal SDK كل خطوة.

حدث مخصّص Sign In With This Device بلا مُدخلات، وتُترك فيه منافذ Device Id فارغة لتُستخدم المعرّف الذي تحفظه حزمة التطوير، يتفرّع على Flock Is Authenticated: فقيمة True تطبع Already signed in؛ وقيمة False تشغّل Flock Register With Device، التي يفكّك On Success فيها النتيجة ويتفرّع على Already Registered: فقيمة True تشغّل Flock Login With Device التي تطبع Signed in، وقيمة False تطبع Registered and signed in؛ وكل On Failure يطبع الخطأ عبر To String (Flock Error) — سجّل الدخول مرة واحدة: حين لا يكون أحد قد سجّل دخوله، أنشئ حسابًا لهذا الجهاز، وسجّل الدخول حين يكون له حساب بالفعل.

راجع دليل حزمة تطوير Unreal للاطّلاع على جدول المزوّدين الكامل.

الجلسات

تُبقي حزمة التطوير اللاعب مسجَّل الدخول وتُجدّد جلسته تلقائيًا — فلن تتعامل مع الرموز أو انتهاء صلاحيتها بنفسك أبدًا. وإذا احتاج اللاعب إلى إعادة المصادقة، تُطلق حزمة التطوير الحدث FlockEvents.OnAuthExpired (في Unreal: On Auth Expired في أحداث Flock، GetEvents()).

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

المفاهيم

الميزات

المرجع

تسجيل الدخول

البريد الإلكتروني / كلمة المرور

معرّف الجهاز

Google / Apple

Steam / Facebook / Discord

الجلسات

البريد الإلكتروني / كلمة المرور

معرّف الجهاز

Google / Apple

Steam / Facebook / Discord

​الجلسات

الجلسات