المصادقة

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

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

اضبط لعبتك

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

Unity
Unreal

تقع بيانات الاعتماد في Flock → Settings — راجع إعداد Unity.ومع Auto-Initialize On Load تصادق الحزمة لعبتك عند بدء التشغيل؛ أطفئه لتتولّى التهيئة بنفسك. وتصل إلى كل شيء عبر FlockClient.Instance.

تقع بيانات الاعتماد في Project Settings → Plugins → Flock SDK — راجع إعداد Unreal.ومع Auto-Initialize On Load تصادق الحزمة لعبتك عند بدء التشغيل؛ أطفئه لتتولّى التهيئة بنفسك. وتصل إلى كل شيء عبر UFlockSubsystem::Get(this).

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

Unity
Unreal

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

// Email / password
await FlockClient.Instance.Authentication.LoginWithEmailAsync(email, password);

// Device ID — frictionless guest sign-in keyed to the device
await FlockClient.Instance.Authentication.LoginWithDeviceAsync(deviceId);

// Platform identity — also LoginWithAppleAsync, LoginWithSteamAsync,
// LoginWithFacebookAsync, LoginWithDiscordAsync
await FlockClient.Instance.Authentication.LoginWithGoogleAsync(idToken);

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

FlockAuthProvider auth = FlockClient.Instance.Authentication;

// null means "this identity already has an account" — created nothing, signed in nobody.
if (await auth.RegisterWithDeviceAsync(deviceId) == null)
    await auth.LoginWithDeviceAsync(deviceId);

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

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

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

UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);

// Email / password
Sdk->GetAuthProvider()->LoginWithEmail(Email, Password, OnLogin);

// Device ID — frictionless guest sign-in keyed to the device
Sdk->GetAuthProvider()->LoginWithDevice(DeviceId, OnLogin);

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

وفي طرائق المنصّات تستبدل الحزمة بيان اعتماد سبق أن أنتجته حزمة تطوير المنصة لديك؛ فهي لا تحصل عليه نيابةً عنك. تتطلّب Google رمز هوية (ID token)، وApple رمز هوية (identity token)، وSteam تذكرة جلسة (session ticket). أما Facebook وDiscord فللدخول فقط — إذ يجب أن يكون الحساب موجودًا سلفًا.وإنشاء الحساب استدعاء منفصل. فتسجيل الدخول لا يُنشئ حسابًا أبدًا، ويحتاج اللاعب الجديد إلى RegisterWith… أوّلًا. والتسجيل لا يُدخل اللاعب، فأتبِعه بتسجيل دخول.وتسجيل هوية لها حساب بالفعل يُبلَّغ عنه على أنه نجاح مع ضبط bAlreadyRegistered، فتستطيع توجيه اللاعب إلى تسجيل الدخول بدل عرض رسالة فشل.وبعد ذلك اقرأ Flock Get Player Id / GetPlayerId()، أو تعامَل مع الحدث OnAuthenticated.أتختار اسمًا معروضًا؟ تحقّق أولًا من أنه متاح — وهو تحقّق استرشادي، إذ يمكن أن يحجزه لاعب آخر في أثناء ذلك:

Sdk->GetAuthProvider()->IsNameAvailable(TEXT("PlayerName"), OnChecked);

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

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

Unity
Unreal

// 1. Player enters their email; Flock emails them a reset code
await FlockClient.Instance.Authentication.ForgotPasswordAsync(email);

// 2. Player enters the code and their new password
await FlockClient.Instance.Authentication.ResetPasswordAsync(email, code, newPassword);

Sdk->GetAuthProvider()->ForgotPassword(Email, OnSent);
Sdk->GetAuthProvider()->ResetPassword(Email, Code, NewPassword, OnReset);

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

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

Unity
Unreal

await FlockClient.Instance.Authentication.SendEmailVerificationAsync();

// Player enters the emailed code
await FlockClient.Instance.Authentication.VerifyEmailAsync(code);

Sdk->GetAuthProvider()->SendEmailVerification(OnSent);
Sdk->GetAuthProvider()->VerifyEmail(Code, OnVerified);

تسجيل الخروج

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

Unity
Unreal

// Routine sign-out
FlockClient.Instance.Authentication.Logout();

// Hardened sign-out: revoke on the server, then clear locally
await FlockClient.Instance.Authentication.RevokeTokenAsync();
FlockClient.Instance.Authentication.Logout();

// Routine sign-out
Sdk->GetAuthProvider()->Logout();

// Hardened sign-out: revoke on the server, then clear locally
Sdk->GetAuthProvider()->RevokeToken([Sdk](TFlockResult<FFlockTokenRevokeResponse>)
{
    Sdk->GetAuthProvider()->Logout();
});

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

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

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

المفاهيم

حزم التطوير

الميزات

المرجع

المصادقة

اضبط لعبتك

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

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

تسجيل الخروج

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

​اضبط لعبتك

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

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

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

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

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

اضبط لعبتك

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

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

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

تسجيل الخروج

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