Вы можете использовать Game Center для входа игроков в игру на платформах Apple, созданную на основе Firebase. Чтобы использовать вход в Game Center с Firebase, сначала убедитесь, что локальный игрок вошел в Game Center, а затем используйте объект GameCenterAuthProvider
для генерации учетных данных Firebase, которые вы можете использовать для аутентификации в Firebase.
Прежде чем начать
Используйте Swift Package Manager для установки и управления зависимостями Firebase.
- В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .
- При появлении соответствующего запроса добавьте репозиторий Firebase Apple platform SDK:
- Выберите библиотеку Firebase Authentication .
- Добавьте флаг
-ObjC
в раздел «Другие флаги компоновщика» настроек сборки вашей цели. - По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.
https://github.com/firebase/firebase-ios-sdk.git
Далее выполните некоторые шаги по настройке:
- Обязательно зарегистрируйте свое приложение Apple в Firebase. Это означает, что необходимо ввести идентификатор пакета вашего приложения в разделе регистрации вместе с дополнительной необязательной информацией, такой как идентификатор App Store и идентификатор команды и т. д. Это потребуется для безопасной проверки аудитории учетных данных Game Center пользователя перед завершением входа.
- Включите Game Center в качестве поставщика входа для вашего проекта Firebase:
- В консоли Firebase откройте раздел «Аутентификация» .
- На вкладке «Способ входа» включите поставщика входа Game Center .
Интегрируйте вход в Game Center в свою игру
Во-первых, если ваша игра еще не использует Game Center, следуйте инструкциям в разделах «Внедрение Game Center в вашу игру» и «Аутентификация локального игрока на устройстве» на сайте разработчиков Apple.
Убедитесь, что идентификатор пакета, который вы предоставляете iTunes Connect, совпадает с идентификатором пакета, который вы использовали при подключении приложения к проекту Firebase.
В рамках интеграции Game Center вы определяете обработчик аутентификации, который вызывается в нескольких точках процесса аутентификации Game Center. В этом обработчике проверьте, вошел ли игрок в Game Center. Если да, вы можете продолжать входить в 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 } }
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 } };
Аутентификация с помощью Firebase
После того, как вы определили, что локальный игрок вошел в систему с помощью Game Center, войдите в игру, создав объект AuthCredential
с помощью GameCenterAuthProvider.getCredential()
и передав этот объект в 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! }
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. }]; } }];
Следующие шаги
После того, как пользователь войдет в систему в первый раз, создается новая учетная запись пользователя, которая связывается с его идентификатором Game Center. Эта новая учетная запись хранится как часть вашего проекта Firebase и может использоваться для идентификации пользователя в каждом приложении в вашем проекте.
В вашей игре вы можете получить Firebase UID пользователя из объекта 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 }
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; }
В правилах безопасности Firebase Realtime Database и Cloud Storage вы можете получить уникальный идентификатор вошедшего в систему пользователя из переменной auth
и использовать его для управления данными, к которым пользователь может получить доступ.
Чтобы получить информацию об игроке Game Center или получить доступ к службам Game Center, используйте API, предоставляемые Game Kit .
Чтобы выйти из Firebase, вызовите Auth.signOut()
:
Быстрый
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; }