اصالت‌سنجی بااستفاده از Game Center

می‌توانید از Game Center برای وارد کردن بازیکنان به سیستم بازی پلاتفرم‌های Apple که در Firebase ساخته شده است استفاده کنید. برای استفاده از «ورود به سیستم Game Center» با Firebase، ابتدا مطمئن شوید بازیکن محلی با Game Center به سیستم وارد شده باشد، و سپس از شیء GameCenterAuthProvider برای تولید اطلاعات کاربری Firebase استفاده کنید، که می‌توانید از آن برای اصالت‌سنجی با Firebase استفاده کنید.

قبل از شروع

از Swift Package Manager برای نصب و مدیریت وابستگی‌های Firebase استفاده کنید.

  1. در Xcode، درحالی‌که پروژه برنامه‌تان باز است، به File (فایل) > Add Packages (افزودن بسته‌ها) بروید.
  2. وقتی خواسته شد، مخزن کیت توسعه نرم‌افزار Firebase Apple platforms را اضافه کنید:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. کتابخانه Firebase Authentication را انتخاب کنید.
  5. پرچم -ObjC را به بخش Other Linker Flags (سایر پرچم‌های پیونددهنده) در تنظیمات ساخت هدف اضافه کنید.
  6. وقتی تمام شد، Xcode به‌طور خودکار شروع به حل و بارگیری وابستگی‌های شما در پس‌زمینه می‌کند.

سپس، چند مرحله پیکربندی را انجام دهید:

  1. مطمئن شوید برنامه Apple خود را در Firebase ثبت کرده‌اید. یعنی شناسه بسته ترکیبی برنامه‌تان را به‌همراه اطلاعات اختیاری دیگر مثل شناسه App Store و شناسه تیم و غیره در بخش ثبت وارد کنید. این کار برای درستی‌سنجی ایمن مخاطب اعتبارنامه Game Center کاربر قبل‌از تکمیل ورود به سیستم لازم است.
  2. Game Center را به‌عنوان ارائه‌دهنده ورود به سیستم برای پروژه Firebase خود فعال کنید:
    1. در کنسول Firebase، به امنیت > اصالت‌سنجی بروید.
    2. در برگه روش ورود به سیستم، ارائه‌دهنده ورود به سیستم Game Center را فعال کنید.

ادغام کردن «ورود به سیستم Game Center» در بازی

ابتدا، اگر بازی‌تان ازقبل از Game Center استفاده نمی‌کند، دستورالعمل‌های Incorporating Game Center into Your Game (ادغام Game Center در بازی) و Authenticating a Local Player on the Device (اصالت‌سنجی بازیکن محلی در دستگاه) را در سایت توسعه‌دهنده Apple دنبال کنید.

مطمئن شوید شناسه بسته ترکیبی که به iTunes Connect ارائه می‌دهید با شناسه بسته ترکیبی که هنگام اتصال برنامه‌تان به پروژه Firebase استفاده کردید مطابقت داشته باشد.

به‌عنوان بخشی از ادغام Game Center، یک کنترل‌کننده اصالت‌سنجی تعریف می‌کنید که در چندین نقطه در فرایند اصالت‌سنجی Game Center فراخوانی می‌شود. در این کنترل‌کننده، بررسی کنید که آیا بازیکن با Game Center به سیستم وارد شده است یا نه. اگر این‌طور است، می‌توانید به ورود به سیستم Firebase ادامه دهید.

Swift

let localPlayer = GKLocalPlayer.localPlayer()
localPlayer.authenticateHandler = { (gcAuthViewController?, error) in
  if let gcAuthViewController = gcAuthViewController {
    // Pause any activities that require user interaction, then present the
    // gcAuthViewController to the player.
  } else if localPlayer.isAuthenticated {
    // Player is signed in to Game Center. Get Firebase credentials from the
    // player's Game Center credentials (see below).
  } else {
    // Error
  }
}

Objective-C

__weak GKLocalPlayer *localPlayer = [GKLocalPlayer localPlayer];
localPlayer.authenticateHandler = ^(UIViewController *gcAuthViewController,
                                    NSError *error) {
  if (gcAuthViewController != nil) {
    // Pause any activities that require user interaction, then present the
    // gcAuthViewController to the player.
  } else if (localPlayer.isAuthenticated) {
    // Player is signed in to Game Center. Get Firebase credentials from the
    // player's Game Center credentials (see below).
  } else {
    // Error
  }
};

اصالت‌سنجی با Firebase

پس‌از اینکه مطمئن شدید بازیکن محلی با Game Center به سیستم وارد شده است، با ایجاد شیء AuthCredential با GameCenterAuthProvider.getCredential() و ارسال آن شیء به signIn(with:)، بازیکن را به سیستم بازی‌تان وارد کنید:

Swift

// Get Firebase credentials from the player's Game Center credentials
GameCenterAuthProvider.getCredential() { (credential, error) in
  if let error = error {
    return
  }
  // The credential can be used to sign in, or re-auth, or link or unlink.
  Auth.auth().signIn(with:credential) { (user, error) in
    if let error = error {
      return
    }
    // Player is signed in!
  }

Objective-C

// Get Firebase credentials from the player's Game Center credentials
[FIRGameCenterAuthProvider getCredentialWithCompletion:^(FIRAuthCredential *credential,
                                                         NSError *error) {
  // The credential can be used to sign in, or re-auth, or link or unlink.
  if (error == nil) {
    [[FIRAuth auth] signInWithCredential:credential
                              completion:^(FIRUser *user, NSError *error) {
      // If error is nil, player is signed in.
    }];
  }
}];

مراحل بعدی

پس‌از اینکه کاربر برای اولین‌بار به سیستم وارد شد، حساب کاربری جدیدی ایجاد می‌شود و به شناسه Game Center او پیوند داده می‌شود. این حساب جدید به‌عنوان بخشی از پروژه Firebase شما ذخیره می‌شود و می‌توان از آن برای شناسایی کاربر در همه برنامه‌های پروژه شما استفاده کرد.

در بازی‌تان، می‌توانید UID Firebase کاربر را از شیء User دریافت کنید:

Swift

let user = Auth.auth().currentUser
if let user = user {
  let playerName = user.displayName

  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getToken(with:) instead.
  let uid = user.uid
}

Objective-C

FIRUser *user = [FIRAuth auth].currentUser;
if (user) {
  NSString *playerName = user.displayName;

  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  NSString *uid = user.uid;
}

در «قوانین امنیتی» Firebase Realtime Database و Cloud Storage، می‌توانید شناسه کاربری یکتای کاربر واردشده به سیستم را از متغیر auth دریافت کنید و از آن برای کنترل داده‌هایی که کاربر می‌تواند به آن‌ها دسترسی داشته باشد استفاده کنید.

برای دریافت اطلاعات بازیکن Game Center کاربر یا دسترسی به سرویس‌های Game Center، از میاناهای برنامه‌سازی کاربردی ارائه‌شده توسط Game Kit استفاده کنید.

برای خارج کردن کاربر از سیستم Firebase، با Auth.signOut() تماس بگیرید:

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print ("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}