Autenticazione tramite il Centro giochi

Puoi utilizzare Game Center per far accedere i giocatori a un gioco per piattaforme Apple creato su Firebase. Per utilizzare l'accesso con il Centro giochi con Firebase, assicurati innanzitutto che il giocatore locale abbia eseguito l'accesso con il Centro giochi, quindi utilizza l'oggetto GameCenterAuthProvider per generare una credenziale Firebase, che puoi utilizzare per autenticarti 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 > Aggiungi pacchetti.
  2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:
    3.   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 compilazione del target.
  5. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Poi, svolgi alcuni passaggi di configurazione:

  1. Assicurati di registrare la tua app Apple con Firebase. Ciò significa che dovrai inserire l'ID del bundle della tua app nella sezione di registrazione insieme a informazioni facoltative aggiuntive come l'ID App Store e l'ID team e così via. Queste informazioni saranno necessarie per verificare in modo sicuro il pubblico delle credenziali di Game Center dell'utente prima di completare l'accesso.
  2. Attiva Game Center come fornitore di accesso per il tuo progetto Firebase:
    1. Nella console Firebase, apri la sezione Autenticazione.
    2. Nella scheda Metodo di accesso, attiva il fornitore 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 Integrare Game Center nel gioco e Autenticare un giocatore locale sul dispositivo sul sito per sviluppatori Apple.

Assicurati che l'ID pacchetto fornito a iTunes Connect corrisponda a quello utilizzato quando hai collegato l'app al tuo progetto Firebase.

Nell'ambito dell'integrazione di Game Center, definisci un gestore dell'autenticazione 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.

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

Esegui l'autenticazione con Firebase

Dopo aver stabilito che il giocatore locale ha eseguito l'accesso con Game Center, invitalo ad accedere al tuo gioco creando un oggetto AuthCredential con GameCenterAuthProvider.getCredential() e passandolo a 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.
    }];
  }
}];

Passaggi successivi

Dopo che un utente accede per la prima volta, viene creato un nuovo account utente e collegato al suo ID Game Center. Questo nuovo account viene archiviato nel progetto Firebase e può essere utilizzato per identificare un utente in ogni app del progetto.

Nel tuo gioco, puoi recuperare l'UID Firebase dell'utente dall'oggetto 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;
}

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 far uscire un utente da Firebase, chiama 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;
}