Puoi utilizzare Game Center per far accedere i giocatori 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.
- In Xcode, con il progetto dell'app aperto, vai a File > Add Packages (File > Aggiungi pacchetti).
- Quando richiesto, aggiungi il repository dell'SDK Firebase per le piattaforme Apple:
- Scegli la libreria Firebase Authentication.
- Aggiungi il flag
-ObjCalla sezione Other Linker Flags (Altri flag del linker) delle impostazioni di build del target. - Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.
https://github.com/firebase/firebase-ios-sdk.git
Poi, esegui alcuni passaggi di configurazione:
- 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, l'ID team e così via. Questo sarà necessario per verificare in modo sicuro il pubblico delle credenziali Game Center dell'utente prima di completare l'accesso.
- Attiva Game Center come provider di accesso per il tuo progetto Firebase:
- Nella console Firebase, vai a Sicurezza > Autenticazione.
- Nella scheda Metodo di accesso, abilita il provider di accesso Game Center.
Integra l'accesso a 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 e Authenticating a Local Player on the Device sul sito per sviluppatori Apple.
Assicurati che l'ID pacchetto fornito a iTunes Connect corrisponda a quello 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 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 } };
Autenticati con Firebase
Dopo aver stabilito che il giocatore locale ha eseguito l'accesso con Game Center,
fai accedere il giocatore al tuo gioco creando un oggetto AuthCredential con
GameCenterAuthProvider.getCredential() e passando l'oggetto 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 ha eseguito l'accesso per la prima volta, viene creato un nuovo account utente che viene collegato al suo ID Game Center. Questo nuovo account viene archiviato come parte del tuo progetto Firebase e può essere utilizzato per identificare un utente in ogni app del progetto.
Nel tuo gioco, puoi ottenere 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 ottenere 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 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():
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; }