ربط الحسابات

اللاعب في Flock هو حساب واحد يمكن أن يحمل عدّة بيانات اعتماد. فقد يبدأ اللاعب نفسه بمعرّف جهاز، ثم يضيف بريدًا إلكترونيًا وكلمة مرور لاحقًا، ثم يربط Google بعد ذلك — وتسجيل الدخول بأيٍّ منها يصل إلى الحساب نفسه بالتقدّم نفسه. وهذا ما يجعل البدء بالجهاز أولًا آمنًا: يبدأ اللاعب فورًا دون نموذج تسجيل، ثم يربط بيانات اعتماد حقيقية حين يصبح مرتبطًا باللعبة، فيحتفظ بكل شيء إن فقد الجهاز.

النطاق: بيانات الاعتماد تخصّ اللاعب؛ واللاعب يخصّ لعبة.

أنواع بيانات الاعتماد

device_id وemail وgoogle وapple وfacebook وsteam وdiscord. ويمكن للاعب أن يحمل واحدًا من كل نوع على الأكثر — فربط حساب Google ثانٍ باللاعب نفسه يُرفض بدل أن يحلّ محلّ الأول بصمت.

Unity
Unreal

يقع الربط في مزوّد المصادقة إلى جانب استدعاءات تسجيل الدخول، وكل دالة منه تتطلّب لاعبًا مسجَّل الدخول. ويعمل المثال داخل دالة async؛ وidToken رمز هوية Google الذي يحصل عليه مسار تسجيل الدخول لديك أصلًا.

using System.Collections.Generic;
using Flock;
using Flock.Models;

// ما الذي يستطيع هذا اللاعب تسجيل الدخول به حاليًا؟
List<PlayerLinkedAccount> accounts =
    await FlockClient.Instance.Authentication.GetLinkedAccountsAsync();

// اربط بيانات اعتماد بريد إلكتروني/كلمة مرور باللاعب المسجَّل دخوله.
accounts = await FlockClient.Instance.Authentication.LinkEmailAsync("[email protected]", "hunter2");

// اربط حسابًا اجتماعيًا بالرمز نفسه الذي يحصل عليه مسار تسجيل الدخول لديك أصلًا.
accounts = await FlockClient.Instance.Authentication.LinkGoogleAsync(idToken);

// فُكّ الربط.
accounts = await FlockClient.Instance.Authentication.UnlinkAsync(FlockCredentialProvider.Google);

وهناك دالة لكل مزوّد — LinkEmailAsync وLinkDeviceAsync وLinkGoogleAsync وLinkAppleAsync وLinkFacebookAsync وLinkSteamAsync وLinkDiscordAsync — وكل منها يأخذ الرمز نفسه الذي يحصل عليه مسار تسجيل الدخول من تلك المنصّة. وLinkDeviceAsync() دون معرّف تربط معرّف الجهاز الذي تحفظه الحزمة لهذا التثبيت. أما UnlinkAsync فتأخذ FlockCredentialProvider بدلًا من ذلك.وكل واحدة من هذه الدوال تُعيد قائمة بيانات الاعتماد كاملةً بعد التحديث، فيؤدّي الربط وفكّه دور التحديث أيضًا — ونادرًا ما تحتاج إلى استدعاء GetLinkedAccountsAsync مرة أخرى مباشرةً بعدها.ويحمل كل PlayerLinkedAccount الحقول Provider وProviderUserId وEmail وEmailVerified.

لا يستطيع اللاعب فكّ ربط آخر بيانات اعتماد لديه. فإزالتها تترك حسابًا لا يستطيع أحد تسجيل الدخول إليه، ولذلك يرفض الخادم ذلك بالرمز FlockErrorCode.PlayerCannotUnlinkLastCredential. عطِّل زر فكّ الربط حين تحتوي القائمة على مدخل واحد بدل أن يكتشف اللاعب ذلك على هيئة خطأ.

أخطاء يستحقّ التعامل معها بالاسم:

الرمز	المعنى
`PlayerAccountAlreadyLinked`	بيانات الاعتماد مرتبطة سلفًا — بهذا اللاعب أو بلاعب آخر.
`PlayerAccountNotLinked`	فكّ ربط شيء لا يملكه اللاعب.
`PlayerCannotUnlinkLastCredential`	آخر وسيلة تسجيل دخول متبقّية.
`PlayerInvalidLinkRequest`	رفض المزوّد الرمز المُرسَل.

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

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

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

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

// A player is signed in. this: any object in the game's world.
FFlockAuthProvider* Auth = UFlockSubsystem::Get(this)->GetAuthProvider();

// What is this player currently able to sign in with?
Auth->GetLinkedAccounts([](TFlockResult<FFlockPlayerAccountsResponse> Listed)
{
    for (const FFlockPlayerLinkedAccount& Account : Listed.Value.Accounts)
    {
        UE_LOG(LogTemp, Display, TEXT("%s %s"), *Account.Provider, *Account.Email);
    }
});

// Attach an email and password to the signed-in player.
Auth->LinkEmail(Email, Password, [](TFlockResult<FFlockPlayerAccountsResponse> Linked)
{
    if (Linked.bSuccess)
    {
        return;   // Linked.Value.Accounts: the full, updated list
    }
    if (Linked.Error.ErrorCode == EFlockErrorCode::PlayerAccountAlreadyLinked)
    {
        // The email is already on this player, or on another one.
    }
    UE_LOG(LogTemp, Warning, TEXT("%s"), *Linked.Error.ToDisplayText());
});

// A social credential: the same token your sign-in already gets from that platform.
Auth->LinkGoogle(IdToken, [](TFlockResult<FFlockPlayerAccountsResponse> Linked) {});

// Detach one.
Auth->Unlink(EFlockCredentialProvider::Google, [](TFlockResult<FFlockPlayerAccountsResponse> Unlinked) {});

Email وPassword هما ما كتبه اللاعب في نموذجك؛ وIdToken هو الرمز الذي يحصل عليه تسجيل الدخول بـ Google لديك أصلًا. وهناك استدعاء لكل مزوّد — LinkEmail وLinkDevice وLinkGoogle وLinkApple وLinkFacebook وLinkSteam وLinkDiscord — يأخذ كلٌّ منها الرمز نفسه الذي يحصل عليه مسار تسجيل الدخول لديك من تلك المنصة. وLinkDevice بمعرّف فارغ تربط معرّف الجهاز الذي تحفظه الحزمة لهذا التثبيت. أما Unlink فتأخذ EFlockCredentialProvider بدلًا منه.كل هذه الاستدعاءات تكتمل بقائمة بيانات الاعتماد الكاملة المحدَّثة (Accounts)، فيصبح الربط وفكّ الربط تحديثًا في الوقت نفسه. ويحمل كل FFlockPlayerLinkedAccount الحقول Provider وProviderUserId وEmail وEmailVerified وProviderType، وهو المزوّد بصيغة EFlockCredentialProvider لتمرّره مباشرة إلى Unlink. وتُطلق أحداث Flock ‏On Account Linked وOn Account Unlinked مع المزوّد.وفي Blueprint هذه هي Flock Get Linked Accounts وFlock Link Email وFlock Link Device وFlock Link Google وFlock Link Apple وFlock Link Steam وFlock Link Facebook وFlock Link Discord وFlock Unlink Account، تحت Flock | Auth، ولكلٍّ منها On Success وOn Failure.

حدث مخصّص Link Email بمدخلَي Email وPassword، موصول بـ Flock Link Email، ويطبع كلٌّ من On Success وOn Failure نصًّا — اربط بريدًا إلكترونيًا وكلمة مرور باللاعب المسجَّل دخوله، واعرض ما عاد.

لا يستطيع اللاعب فكّ ربط آخر بيانات اعتماد لديه. فإزالتها تترك حسابًا لا يستطيع أحد تسجيل الدخول إليه، ولذلك يرفض الخادم ذلك بالرمز EFlockErrorCode::PlayerCannotUnlinkLastCredential. عطِّل زر فكّ الربط حين تحتوي القائمة على مدخل واحد بدل أن يكتشف اللاعب ذلك على هيئة خطأ.

أخطاء يستحقّ التعامل معها بالاسم (Error.ErrorCode، وكلٌّ منها EFlockErrorCode:: متبوعًا بالاسم أدناه):

الرمز	المعنى
`PlayerAccountAlreadyLinked`	بيانات الاعتماد مرتبطة سلفًا — بهذا اللاعب أو بلاعب آخر. والربط الذي تعيد لعبتك إرساله بعد ردّ لم يصل يُقرأ هكذا أيضًا.
`PlayerAccountNotLinked`	فكّ ربط شيء لا يملكه اللاعب.
`PlayerCannotUnlinkLastCredential`	آخر وسيلة تسجيل دخول متبقّية.
`PlayerInvalidLinkRequest`	رفض المزوّد الرمز المُرسَل.

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

ولا تُخزَّن حالة بيانات الاعتماد مؤقتًا ولا تُصفّ في طابور عند انقطاع الاتصال: فكل استدعاء يذهب إلى الخادم.

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

بعد ربط بريد إلكتروني يصبح للاعب كلمة مرور يمكنه إعادة تعيينها. وتعمل ResetPasswordAsync (في Unreal: ‏ResetPassword) دون تسجيل دخول، بالبريد والرمز الذي أرسلته ForgotPasswordAsync، فلا يهمّ كيف سجّل اللاعب دخوله هذه المرة.

ربط الحسابات متاح في حزمة Unity وحزمة Unreal.

راجع تسجيل الدخول للاطّلاع على استدعاءات تسجيل الدخول نفسها.

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

المفاهيم

الميزات

المرجع

ربط الحسابات

أنواع بيانات الاعتماد

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

​أنواع بيانات الاعتماد

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

أنواع بيانات الاعتماد

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