المصادقة

للمصادقة في Flock طبقتان، وتتولّى حزمة التطوير كلتيهما:

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

اضبط لعبتك

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

Unity
Unreal

تقع بيانات الاعتماد في Flock → Settings، تبويب Configuration: ‏Api Url وApi Key وGame Name (اسم لعبتك من لوحة التحكم) وGame Version — راجع إعداد Unity.ومع Auto-Initialize On Load تصادق الحزمة لعبتك عند بدء التشغيل؛ أطفئه لتتولّى التهيئة بنفسك. وتصل إلى كل شيء عبر FlockClient.Instance.

تقع بيانات الاعتماد في Project Settings → Plugins → Flock SDK Settings: ‏API URL وAPI Key وGame Name (اسم لعبتك من لوحة التحكم) وGame Version — راجع إعداد Unreal.ومع Auto Initialize on Load تصادق الحزمة لعبتك عند بدء التشغيل؛ أطفئه لتتولّى التهيئة بنفسك. وتصل إلى كل شيء عبر UFlockSubsystem::Get(this)، مع إضافة "Flock" إلى ملف Build.cs الخاص بوحدة لعبتك.

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

Unity
Unreal

كل طريقة استدعاء LoginWith…Async على FlockClient.Instance.Authentication. وجميعها ترمي استثناء FlockException عند الفشل، فغلّفها بـtry/catch لتمنح بيانات الاعتماد الخاطئة أو انقطاع الشبكة مسار إعادة محاولة نظيفًا. وتعمل الأمثلة داخل دالة async؛ وemail وpassword وidToken قيمك أنت. ودون معرّف، تستعمل استدعاءات الجهاز معرّف الجهاز الذي تصنعه الحزمة في أول تشغيل وتحفظه لهذا التثبيت؛ ويبيّن أول استدعاء لك متى تمرّر معرّفك الخاص.

using Flock;

// البريد الإلكتروني / كلمة المرور، من شاشة الدخول لديك
await FlockClient.Instance.Authentication.LoginWithEmailAsync(email, password);

// الجهاز — دخول ضيف بمعرّف الجهاز الذي تحفظه الحزمة لهذا التثبيت
await FlockClient.Instance.Authentication.LoginWithDeviceAsync();

// هوية المنصّة — وأيضًا LoginWithAppleAsync وLoginWithSteamAsync
// وLoginWithFacebookAsync وLoginWithDiscordAsync
await FlockClient.Instance.Authentication.LoginWithGoogleAsync(idToken);

وفي طرائق المنصّات تستبدل الحزمة بيان اعتماد سبق أن أنتجته حزمة تطوير المنصة لديك؛ فهي لا تحصل عليه نيابةً عنك. تتطلّب Google رمز هوية (ID token)، وApple رمز هوية (identity token)، وSteam تذكرة جلسة (session ticket)، وFacebook وDiscord رمز وصول (access token). وFacebook وDiscord للدخول فقط: ليس لهما RegisterWith…Async، فيجب أن يكون حساب اللاعب موجودًا وذلك الحساب مربوطًا به (ربط الحسابات).سجّل الدخول مرّة واحدة. يُحفظ تسجيل الدخول على الجهاز ويُستعاد مع بدء الحزمة، فتحقّق أولًا هل هناك لاعب مسجَّل الدخول بالفعل (FlockClient.Instance.IsAuthenticated، بعد أن تصبح قيمة FlockClient.IsRestoringSession هي false) وسجّل الدخول فقط إن لم يكن أحد.وإنشاء الحساب استدعاء منفصل. فتسجيل الدخول لا يُنشئ حسابًا أبدًا، ويحتاج اللاعب الجديد إلى RegisterWith…Async أوّلًا. والتسجيل الناجح يُدخل اللاعب أيضًا، فلا يتبعه استدعاء تسجيل دخول في المسار الطبيعي.وتسجيل هوية لها حساب بالفعل ليس خطأً — إذ يُعيد الاستدعاء null ويترك اللاعب خارج الجلسة، فأتبِع تلك الحالة بتسجيل دخول. ودخول الجهاز بلا شاشة حساب يسجّل الدخول أولًا، ولا يسجّل الجهاز إلا إن لم يكن له حساب بعد:

using Flock;
using Flock.Exceptions;

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

وبعد ذلك اقرأ FlockClient.Instance.CurrentPlayerId. ولتتفاعل أيًّا كان مصدر الدخول (تسجيل دخول، أو تسجيل، أو دخول استُعيد عند البدء)، تعامَل مع FlockEvents.OnAuthenticated: يأخذ معالجه FlockAuthInfo (‏PlayerId، وMethod من نوع FlockAuthMethod). وتعامَل مع OnAuthExpired لتعيد إدخال اللاعب حين لا يعود تسجيل الدخول المحفوظ قابلًا للتجديد:

using Flock;
using UnityEngine;

public class SignInScreen : MonoBehaviour
{
    private void OnEnable()
    {
        FlockEvents.OnAuthenticated += OnSignedIn;
        FlockEvents.OnAuthExpired += OnSignInExpired;
    }

    private void OnDisable()
    {
        FlockEvents.OnAuthenticated -= OnSignedIn;
        FlockEvents.OnAuthExpired -= OnSignInExpired;
    }

    private void OnSignedIn(FlockAuthInfo info)
    {
        Debug.Log($"Signed in as {info.PlayerId} ({info.Method})");
    }

    private void OnSignInExpired()
    {
        Debug.Log("The saved sign-in expired: show the sign-in screen.");
    }
}

أتختار اسمًا معروضًا؟ تحقّق أولًا من أنه متاح — وهو تحقّق استرشادي، إذ يمكن أن يحجزه لاعب آخر في أثناء ذلك:

using Flock;

bool available = await FlockClient.Instance.Authentication.IsNameAvailableAsync("PlayerName");

كل طريقة عقدة غير متزامنة تحت Flock | Auth، أو استدعاء على مزوّد المصادقة في C++. ولا شيء يرمي استثناءً — إذ تُبنى Unreal والاستثناءات مطفأة — فتحقّق من Result.bSuccess، أو وصّل طرف On Failure في العقدة.

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

UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);
if (Sdk->IsAuthenticated())
{
    return;   // Signed in already: Flock restored the saved sign-in as it started.
}
FFlockAuthProvider* Auth = Sdk->GetAuthProvider();

// One handler serves every login method. Call one of the methods below, for the way this player
// signs in: each sign-in ends the one before it.
auto OnLogin = [](TFlockResult<FFlockPlayerLoginResponse> Result)
{
    if (!Result.bSuccess)
    {
        UE_LOG(LogTemp, Warning, TEXT("%s"), *Result.Error.ToDisplayText());
    }
};

// Email / password, from your own sign-in screen
Auth->LoginWithEmail(Email, Password, OnLogin);

// Device — guest sign-in with the device ID the SDK keeps for this install (an empty ID)
Auth->LoginWithDevice(FString(), OnLogin);

// Platform identity — also LoginWithApple, LoginWithSteam,
// LoginWithFacebook, LoginWithDiscord
Auth->LoginWithGoogle(IdToken, OnLogin);

وفي طرائق المنصّات تستبدل الحزمة بيان اعتماد سبق أن أنتجته حزمة تطوير المنصة لديك؛ فهي لا تحصل عليه نيابةً عنك. تتطلّب Google رمز هوية (ID token)، وApple رمز هوية (identity token)، وSteam تذكرة جلسة (session ticket). أما Facebook وDiscord فللدخول فقط — إذ يجب أن يكون الحساب موجودًا سلفًا.ولتسجيل الدخول بالجهاز، اترك معرّف الجهاز فارغًا: فتستخدم استدعاءات الجهاز (LoginWithDevice وRegisterWithDevice وLinkDevice وعُقدها) حينها معرّف الحزمة نفسها، GUID تُنشئه أول مرة يُحتاج إليه وتحفظه في Saved/Flock/device_id.txt. واقرأه بـ ThisDeviceId() على مزوّد المصادقة، أو بـ Flock Get This Device Id في Blueprint. أما أي معرّف آخر فيُرسَل كما تمرّره تمامًا. واللعبة التي تسجّل دخول اللاعبين أصلًا بمعرّف جهاز من عندها (GUID محفوظ في SaveGame أو في ملف) يجب أن تواصل تمرير ذلك المعرّف نفسه، وإلا حصل أولئك اللاعبون على حساب جديد فارغ. ويقول أول استدعاء لك متى يتغيّر المعرّف المحفوظ ومتى تمرّر معرّفك.سجّل الدخول مرة واحدة. يُحفظ تسجيل الدخول على الجهاز ويُستعاد حين تبدأ الحزمة، فتحقّق أولًا هل سجّل لاعب دخوله من قبل (IsAuthenticated()، أو Branch على Flock Is Authenticated في Blueprint)، ولا تسجّل الدخول إلا حين لا يكون أحد قد سجّل دخوله. فتسجيل دخول ثانٍ يُنهي جلسة التحليلات التي بدأها الأول.وإنشاء الحساب استدعاء منفصل. فتسجيل الدخول لا يُنشئ حسابًا أبدًا، ويحتاج اللاعب الجديد إلى RegisterWith… أوّلًا. والتسجيل الذي يُنشئ الحساب يُدخل اللاعب أيضًا ويُطلق OnAuthenticated، فلا يتبعه تسجيل دخول.وتسجيل هوية لها حساب بالفعل يُبلَّغ عنه على أنه نجاح مع ضبط bAlreadyRegistered، ولا يُدخل أحدًا: فأتبِعه بتسجيل الدخول. ولا تسجّل الدخول أبدًا بعد تسجيلٍ أدخل اللاعب.

حدث مخصّص 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) — سجّل الدخول مرة واحدة: حين لا يكون أحد قد سجّل دخوله، سجّل الجهاز؛ وحين يكون له حساب من قبل، سجّل الدخول بالمعرّف نفسه.

تُمرّر الصورة إلى العقد مُدخل Device Id الخاص بالحدث؛ فاستدعِ الحدث وهو فارغ لتستخدم معرّف هذا التثبيت.

void AMyActor::SignInWithThisDevice()
{
    UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);
    if (!Sdk || !Sdk->IsInitialized() || Sdk->IsAuthenticated())
    {
        return;   // Not started, or a player is signed in already: a second sign-in ends the first one's session.
    }

    const TWeakObjectPtr<UFlockSubsystem> WeakSdk(Sdk);

    // An empty device ID: this install's own (ThisDeviceId). No display name either.
    Sdk->GetAuthProvider()->RegisterWithDevice(FString(), FString(),
        [WeakSdk](TFlockResult<FFlockRegisterResult> Registered)
        {
            UFlockSubsystem* LiveSdk = WeakSdk.Get();
            FFlockAuthProvider* Auth = LiveSdk ? LiveSdk->GetAuthProvider() : nullptr;
            if (!Auth)
            {
                return;   // The game is closing.
            }
            if (!Registered.bSuccess)
            {
                UE_LOG(LogTemp, Warning, TEXT("%s"), *Registered.Error.ToDisplayText());
                return;
            }
            if (!Registered.Value.bAlreadyRegistered)
            {
                return;   // A new player, signed in by the register.
            }
            Auth->LoginWithDevice(FString(), [](TFlockResult<FFlockPlayerLoginResponse> Login)
            {
                if (!Login.bSuccess)
                {
                    UE_LOG(LogTemp, Warning, TEXT("%s"), *Login.Error.ToDisplayText());
                }
            });
        });
}

وبعد ذلك اقرأ Flock Get Player Id / GetPlayerId(). ولتتصرّف أيًّا كان مصدر تسجيل الدخول (تسجيل دخول، أو تسجيل حساب، أو تسجيل دخول مستعاد عند بدء التشغيل)، اربط OnAuthenticated؛ واربط OnAuthExpired لتُدخل اللاعب من جديد حين يتعذّر تجديد تسجيل دخول محفوظ. وكلاهما على مركز الأحداث، ويجب أن تكون معالجاتهما في C++ من نوع UFUNCTION():

#include "FlockEvents.h"

// In BeginPlay; HandleSignedIn(const FFlockAuthInfo& Info) and HandleSignInExpired() are UFUNCTION()s of AMyActor.
if (UFlockSubsystem* Sdk = UFlockSubsystem::Get(this))
{
    Sdk->GetEvents()->OnAuthenticated.AddDynamic(this, &AMyActor::HandleSignedIn);
    Sdk->GetEvents()->OnAuthExpired.AddDynamic(this, &AMyActor::HandleSignInExpired);
}

أتختار اسمًا معروضًا؟ تحقّق أولًا من أنه متاح — وهو تحقّق استرشادي، إذ يمكن أن يحجزه لاعب آخر في أثناء ذلك:

UFlockSubsystem::Get(this)->GetAuthProvider()->IsNameAvailable(TEXT("PlayerName"),
    [](TFlockResult<FFlockNameAvailableResponse> Result)
    {
        if (Result.bSuccess && !Result.Value.Available)
        {
            UE_LOG(LogTemp, Log, TEXT("%s is taken"), *Result.Value.Name);
        }
    });

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

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

Unity
Unreal

يعمل هذا داخل دالة async؛ وتأتي email وcode وnewPassword من شاشاتك أنت.

using Flock;

// 1. يُدخل اللاعب بريده الإلكتروني؛ فترسل له Flock رمز إعادة التعيين
await FlockClient.Instance.Authentication.ForgotPasswordAsync(email);

// 2. يُدخل اللاعب الرمز وكلمة مروره الجديدة
await FlockClient.Instance.Authentication.ResetPasswordAsync(email, code, newPassword);

// Email, Code and NewPassword come from your own screens.
FFlockAuthProvider* Auth = UFlockSubsystem::Get(this)->GetAuthProvider();

// 1. The player enters their email; Flock emails them a reset code
Auth->ForgotPassword(Email, [](TFlockResult<FFlockAuthActionResponse> Sent) {});

// 2. The player enters the code and their new password
Auth->ResetPassword(Email, Code, NewPassword, [](TFlockResult<FFlockAuthActionResponse> Reset)
{
    if (!Reset.bSuccess)
    {
        UE_LOG(LogTemp, Warning, TEXT("%s"), *Reset.Error.ToDisplayText());
    }
});

التحقّق من البريد الإلكتروني

اختياري، ويقوم على رمز، ويبقى تحت سيطرتك دائمًا — فالحزمة لا ترسل رسائل تحقّق من تلقاء نفسها. ويُستعمل عادةً واللاعب مسجَّل الدخول (إذ تُرفَق جلسته تلقائيًا)، لكن أيًّا من الاستدعاءين لا يتوقّف على ذلك.

Unity
Unreal

يعمل هذا داخل دالة async؛ وcode هو الرمز الذي كتبه اللاعب من البريد.

using Flock;

await FlockClient.Instance.Authentication.SendEmailVerificationAsync();

// يُدخل اللاعب الرمز المُرسَل بالبريد
await FlockClient.Instance.Authentication.VerifyEmailAsync(code);

FFlockAuthProvider* Auth = UFlockSubsystem::Get(this)->GetAuthProvider();

Auth->SendEmailVerification([](TFlockResult<FFlockAuthActionResponse> Sent) {});

// The player enters the emailed code
Auth->VerifyEmail(Code, [](TFlockResult<FFlockAuthActionResponse> Verified)
{
    if (!Verified.bSuccess)
    {
        UE_LOG(LogTemp, Warning, TEXT("%s"), *Verified.Error.ToDisplayText());
    }
});

تسجيل الخروج

يمسح Logout الجلسة على الجهاز — وهو تسجيل الخروج المعتاد من جهة العميل. أما في الأجهزة المشتركة أو عند اختراق جلسة، فإن الإبطال يقتل جلسة اللاعب من جهة الخادم أيضًا، فيتوقّف رمز الجلسة المسروق عن العمل. وإيقاف حزمة التطوير ليس تسجيل خروج: يبقى تسجيل الدخول المحفوظ على الجهاز، ويستعيد التشغيل التالي اللاعب نفسه.

Unity
Unreal

يعمل هذا داخل دالة async.

using Flock;

// تسجيل خروج عادي
FlockClient.Instance.Authentication.Logout();

// تسجيل خروج مُحصَّن: أبطِل على الخادم، ثم امسح محليًا
await FlockClient.Instance.Authentication.RevokeTokenAsync();
FlockClient.Instance.Authentication.Logout();

// Routine sign-out
UFlockSubsystem::Get(this)->GetAuthProvider()->Logout();

// Hardened sign-out: revoke on the server, then clear locally
UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);
const TWeakObjectPtr<UFlockSubsystem> WeakSdk(Sdk);
Sdk->GetAuthProvider()->RevokeToken([WeakSdk](TFlockResult<FFlockTokenRevokeResponse>)
{
    UFlockSubsystem* LiveSdk = WeakSdk.Get();
    if (FFlockAuthProvider* Auth = LiveSdk ? LiveSdk->GetAuthProvider() : nullptr)
    {
        Auth->Logout();
    }
});

الجلسات مُدارة نيابةً عنك

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

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

المفاهيم

الميزات

المرجع

المصادقة

اضبط لعبتك

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

التحقّق من البريد الإلكتروني

تسجيل الخروج

الجلسات مُدارة نيابةً عنك

​اضبط لعبتك

​سجّل دخول لاعب

​إعادة تعيين كلمة المرور

​التحقّق من البريد الإلكتروني

​تسجيل الخروج

​الجلسات مُدارة نيابةً عنك

اضبط لعبتك

سجّل دخول لاعب

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

التحقّق من البريد الإلكتروني

تسجيل الخروج

الجلسات مُدارة نيابةً عنك