المصادقة

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

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

اضبط لعبتك

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

تظهر الإخفاقات بصورة مختلفة في كل محرّك. ترمي Unity استثناء FlockException؛ بينما تُعيد Unreal قيمة TFlockResult تتحقّق منها، لأن Unreal تُبنى مع تعطيل الاستثناءات. كما أن كل استدعاء في Unreal هو أيضًا عقدة Blueprint لها طرف On Failure.

البريد الإلكتروني / كلمة المرور
معرّف الجهاز
Google / Apple / Steam / Facebook / Discord

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

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

تسجيل دخول كضيف بلا احتكاك، مرتبط بالجهاز:

await FlockClient.Instance.Authentication.LoginWithDeviceAsync(deviceId);

Sdk->GetAuthProvider()->LoginWithDevice(DeviceId, OnLogin);

مرّر الرمز أو التذكرة الصادرة عن المنصة إلى الدالة المقابلة. في Unity: LoginWithGoogleAsync، وLoginWithAppleAsync، وLoginWithSteamAsync، وLoginWithFacebookAsync، وLoginWithDiscordAsync. أما Unreal فتُسقط اللاحقة Async — LoginWithGoogle، وهكذا.وفي الحالتين تستبدل الحزمة بيان اعتماد سبق أن أنتجته حزمة تطوير المنصة لديك؛ فهي لا تحصل عليه نيابةً عنك. تتطلّب Google رمز هوية (ID token)، وApple رمز هوية (identity token)، وSteam تذكرة جلسة (session ticket).

التسجيل وتسجيل الدخول استدعاءان منفصلان في كلتا الحزمتين — فتسجيل الدخول لا يُنشئ حسابًا، والتسجيل لا يسجّل دخول اللاعب. استخدم RegisterWith…Async (في Unity) أو RegisterWith… (في Unreal) لخطوة إنشاء الحساب. وتسجيل هوية لها حساب بالفعل يُبلَّغ عنه بوصفه نجاحًا، مع علامة تتيح لك توجيه اللاعب إلى تسجيل الدخول بدل عرض إخفاق عليه. وفي Unreal يقتصر Facebook وDiscord على تسجيل الدخول — إذ يجب أن يكون الحساب موجودًا مسبقًا. وبعد ذلك، اقرأ FlockClient.Instance.CurrentPlayerId (في Unity) أو Flock Get Player Id / GetPlayerId() (في Unreal)، أو تعامَل مع الحدث OnAuthenticated. أتختار اسمًا معروضًا؟ تحقّق أولًا من أنه متاح — وهو تحقّق استرشادي، إذ يمكن أن يحجزه لاعب آخر في هذه الأثناء:

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

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

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

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

// 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);

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

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

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

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() الجلسة على الجهاز — وهو تسجيل الخروج المعتاد من جهة العميل. أما للأجهزة المشتركة أو الجلسات المخترقة، فإن RevokeTokenAsync() يُنهي إضافةً إلى ذلك جلسة اللاعب على الخادم، بحيث يتوقّف أي رمز جلسة مسروق عن العمل:

// 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 على مركز أحداثها.

تعامَل مع إخفاقات تسجيل الدخول لتعرض مسار إعادة محاولة نظيفًا عند خطأ في بيانات الاعتماد أو انقطاع الشبكة. في Unity غلّف الاستدعاء بـtry/catch لالتقاط FlockException؛ وفي Unreal تحقّق من Result.bSuccess، أو وصّل طرف On Failure في العقدة.

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

المفاهيم

حزم التطوير

الميزات

المرجع

المصادقة

اضبط لعبتك

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

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

تسجيل الخروج

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

​اضبط لعبتك

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

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

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

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

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

اضبط لعبتك

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

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

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

تسجيل الخروج

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