Authentifier à l'aide de Game Center

Vous pouvez utiliser Game Center pour connecter les joueurs à un jeu de plateformes Apple basé sur Firebase. Pour utiliser la connexion à Game Center avec Firebase, assurez-vous d'abord que le joueur local est connecté à Game Center, puis utilisez l'objet GameCenterAuthProvider pour générer un identifiant Firebase, que vous pouvez utiliser pour vous authentifier auprès de Firebase.

Avant que tu commences

Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

Consultez notre guide d'installation pour découvrir les différentes manières d'ajouter des SDK Firebase à votre projet Apple, notamment en important directement des frameworks et en utilisant CocoaPods.

1. Dans Xcode, avec votre projet d'application ouvert, accédez à File > Add Packages .
2. Lorsque vous y êtes invité, ajoutez le référentiel SDK des plates-formes Apple Firebase :

  https://github.com/firebase/firebase-ios-sdk.git

Remarque : Les nouveaux projets doivent utiliser la version par défaut (la dernière) du SDK, mais vous pouvez choisir une version plus ancienne si nécessaire.
3. Choisissez la bibliothèque d'authentification Firebase.
4. Ajoutez l'indicateur -ObjC à la section Autres indicateurs de l'éditeur de liens des paramètres de construction de votre cible.
5. Une fois terminé, Xcode commencera automatiquement à résoudre et à télécharger vos dépendances en arrière-plan.

Obsolète : Apple a rendu obsolète le champ playerID . Le SDK des plates-formes Apple Firebase utilisera gamePlayerID et teamPlayerID à partir de la version 10.5.0. La mise à niveau vers la version 10.5.0 ou ultérieure du SDK met à jour les intégrations existantes qui utilisent playerID pour utiliser à la place gamePlayerID et teamPlayerID . La mise à niveau des intégrations Game Center Sign-in existantes vers la version SDK 10.5.0 ou ultérieure est irréversible. Pour plus de détails, consultez Méthode : comptes.signInWithGameCenter .

Ensuite, effectuez quelques étapes de configuration :

1. Assurez-vous d'enregistrer votre application Apple auprès de Firebase. Cela signifie saisir l'ID du bundle de votre application dans la section d'inscription ainsi que des informations facultatives supplémentaires telles que l'ID de l'App Store et l'ID de l'équipe, etc. Cela sera nécessaire pour vérifier en toute sécurité l'audience des informations d'identification Game Center de l'utilisateur avant de terminer la connexion.
2. Activez Game Center en tant que fournisseur de connexion pour votre projet Firebase :
   1. Dans la console Firebase , ouvrez la section Authentification .
   2. Dans l’onglet Méthode de connexion , activez le fournisseur de connexion Game Center .

Intégrez la connexion Game Center à votre jeu

Tout d'abord, si votre jeu n'utilise pas déjà Game Center, suivez les instructions dans Incorporer Game Center dans votre jeu et authentifier un joueur local sur l'appareil sur le site des développeurs Apple.

Assurez-vous que l'ID de bundle que vous fournissez à iTunes Connect correspond à l'ID de bundle que vous avez utilisé lorsque vous avez connecté votre application à votre projet Firebase.

Dans le cadre de votre intégration Game Center, vous définissez un gestionnaire d'authentification qui est appelé à plusieurs moments du processus d'authentification Game Center. Dans ce gestionnaire, vérifiez si le joueur est connecté à Game Center. Si tel est le cas, vous pouvez continuer à vous connecter à Firebase.

Rapide

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
  }
}

Objectif 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
  }
};

S'authentifier avec Firebase

Après avoir déterminé que le joueur local s'est connecté à Game Center, connectez-le à votre jeu en créant un objet AuthCredential avec GameCenterAuthProvider.getCredential() et en transmettant cet objet à signIn(with:) :

Rapide

// 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!
  }

Objectif 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.
    }];
  }
}];

Prochaines étapes

Après qu'un utilisateur se connecte pour la première fois, un nouveau compte utilisateur est créé et lié à son identifiant Game Center. Ce nouveau compte est stocké dans le cadre de votre projet Firebase et peut être utilisé pour identifier un utilisateur dans chaque application de votre projet.

Dans votre jeu, vous pouvez obtenir l'UID Firebase de l'utilisateur à partir de l'objet User :

Rapide

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
}

Objectif 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;
}

Dans vos règles de sécurité de base de données en temps réel Firebase et de stockage cloud, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable auth et l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.

Pour obtenir les informations sur le joueur Game Center d'un utilisateur ou pour accéder aux services Game Center, utilisez les API fournies par Game Kit .

Pour déconnecter un utilisateur de Firebase, appelez Auth.signOut() :

Rapide

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

Objectif c

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