Autenticazione tramite il Centro giochi

Puoi utilizzare Game Center per consentire ai giocatori di accedere a un gioco per piattaforme Apple creato su Firebase. Per utilizzare l'accesso a Game Center con Firebase, assicurati innanzitutto che il giocatore locale abbia eseguito l'accesso a Game Center, quindi utilizza l'oggetto GameCenterAuthProvider per generare una credenziale Firebase, che puoi utilizzare per l'autenticazione con Firebase.

Prima di iniziare

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

1. In Xcode, con il progetto dell'app aperto, vai a File > Add Packages (File > Aggiungi pacchetti).
2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:

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

3. Scegli la raccolta Firebase Authentication.
4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di build del target.
5. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

A questo punto, esegui alcuni passaggi di configurazione:

1. Assicurati di registrare la tua app Apple con Firebase. Ciò significa inserire l'ID bundle dell'app nella sezione di registrazione insieme a informazioni facoltative aggiuntive, come l'ID App Store e l'ID team. Questo passaggio è necessario per verificare in modo sicuro il pubblico delle credenziali Game Center dell'utente prima di completare l'accesso.
2. Attiva Game Center come provider di accesso per il tuo progetto Firebase:
   1. Nella Firebase console, apri la sezione Autenticazione.
   2. Nella scheda Metodo di accesso, attiva il provider di accesso Game Center.

Integrare l'accesso tramite Game Center nel gioco

Innanzitutto, se il tuo gioco non utilizza già Game Center, segui le istruzioni riportate in Incorporating Game Center into Your Game e Authenticating a Local Player on the Device sul sito per sviluppatori Apple.

Assicurati che l'ID bundle che fornisci a iTunes Connect corrisponda a quello che hai utilizzato quando hai connesso l'app al progetto Firebase.

Nell'ambito dell'integrazione di Game Center, definisci un gestore di autenticazione che viene chiamato in più punti della procedura di autenticazione di Game Center. In questo gestore, controlla se il giocatore ha eseguito l'accesso con Game Center. In questo caso, puoi continuare ad accedere a Firebase.

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

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

Autenticarsi con Firebase

Dopo aver stabilito che il giocatore locale ha eseguito l'accesso con Game Center, accedi al gioco creando un oggetto AuthCredential con GameCenterAuthProvider.getCredential() e passando l'oggetto a signIn(with:):

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

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

Passaggi successivi

Dopo che un utente ha eseguito l'accesso per la prima volta, viene creato un nuovo account utente collegato al suo ID Game Center. Questo nuovo account viene memorizzato come parte del tuo progetto Firebase e può essere utilizzato per identificare un utente in ogni app del tuo progetto.

Nel tuo gioco, puoi ottenere l'UID Firebase dell'utente dall'oggetto User:

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
}

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

Nelle regole di sicurezza di Firebase Realtime Database e Cloud Storage, puoi ottenere l'ID utente univoco dell'utente che ha eseguito l'accesso dalla variabile auth e utilizzarlo per controllare a quali dati può accedere un utente.

Per ottenere le informazioni sul giocatore di Game Center di un utente o per accedere ai servizi di Game Center, utilizza le API fornite da Game Kit.

Per disconnettere un utente da Firebase, chiama Auth.signOut():

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

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