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 tramite Game Center con Firebase, assicurati innanzitutto che il giocatore locale abbia eseguito l'accesso con 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 Firebase Authentication libreria.
4. Aggiungi il flag -ObjC alla sezione Other Linker Flags (Altri flag del linker) delle impostazioni di build della destinazione.
5. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Poi, esegui alcuni passaggi di configurazione:

1. Assicurati di registrare la tua app Apple con Firebase. Ciò significa inserire l'ID pacchetto dell'app nella sezione di registrazione insieme ad altre informazioni facoltative, come l'ID App Store e l'ID team. Questa operazione è necessaria per verificare in modo sicuro il pubblico della qualifica Game Center dell'utente prima di completare l'accesso.
2. Attiva Game Center come provider di accesso per il tuo progetto Firebase:
   1. Nella console Firebase, vai a Sicurezza > Autenticazione.
   2. Nella scheda Metodo di accesso, attiva il provider di accesso Game Center.

Integra l'accesso tramite Game Center nel tuo gioco

Innanzitutto, se il tuo gioco non utilizza già Game Center, segui le istruzioni riportate in Incorporating Game Center into Your Game (Incorporare Game Center nel tuo gioco) e Authenticating a Local Player on the Device (Autenticare un giocatore locale sul dispositivo) sul sito per sviluppatori Apple.

Assicurati che l'ID pacchetto fornito a iTunes Connect corrisponda all'ID pacchetto utilizzato per collegare 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 caso affermativo, 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
  }
};

Autenticati con Firebase

Dopo aver stabilito che il giocatore locale ha eseguito l'accesso con Game Center, consenti al giocatore di accedere al tuo gioco creando un oggetto AuthCredential con GameCenterAuthProvider.getCredential() e passando questo 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 recuperare 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 recuperare l'ID utente univoco dell'utente che ha eseguito l'accesso dalla variabile auth e utilizzarlo per controllare i dati a cui un utente può accedere.

Per ottenere le informazioni del 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;
}