Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

Аутентификация с помощью игровых сервисов Google Play на Android

Вы можете использовать сервисы Google Play Games для входа игроков в игру для Android, созданную на Firebase. Чтобы использовать сервисы Google Play Games, войдите в систему с помощью Firebase, сначала войдите в систему с помощью Google Play Games и запросите код аутентификации OAuth 2.0 при этом. Затем передайте код аутентификации в PlayGamesAuthProvider чтобы сгенерировать учетные данные Firebase, которые вы можете использовать для аутентификации в Firebase.

Прежде чем вы начнете

Настройте свой Android-проект

  1. Если вы еще этого не сделали, добавьте Firebase в свой проект Android .

  2. Используя Firebase Android BoM , объявите зависимость для библиотеки Firebase Authentication Android в файле Gradle вашего модуля (уровня приложения) (обычно app/build.gradle ).

    Кроме того, в рамках настройки аутентификации Firebase вам необходимо добавить в приложение SDK сервисов Google Play.

    Джава

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.0.0')
    
        // Declare the dependency for the Firebase Authentication library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:18.1.0'
    }

    Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

    (Альтернатива) Объявить зависимости библиотеки Firebase без использования BoM

    Если вы решите не использовать Firebase BoM, вы должны указать каждую версию библиотеки Firebase в ее строке зависимости.

    Обратите внимание: если вы используете несколько библиотек Firebase в своем приложении, мы настоятельно рекомендуем использовать BoM для управления версиями библиотек, что гарантирует совместимость всех версий.

    dependencies {
        // Declare the dependency for the Firebase Authentication library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth:20.0.0'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:18.1.0'
    }

    Котлин + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.0.0')
    
        // Declare the dependency for the Firebase Authentication library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth-ktx'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:18.1.0'
    }

    Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

    (Альтернатива) Объявить зависимости библиотеки Firebase без использования BoM

    Если вы решите не использовать Firebase BoM, вы должны указать каждую версию библиотеки Firebase в ее строке зависимости.

    Обратите внимание: если вы используете несколько библиотек Firebase в своем приложении, мы настоятельно рекомендуем использовать BoM для управления версиями библиотек, что гарантирует совместимость всех версий.

    dependencies {
        // Declare the dependency for the Firebase Authentication library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-auth-ktx:20.0.0'
    // Also declare the dependency for the Google Play services library and specify its version implementation 'com.google.android.gms:play-services-auth:18.1.0'
    }

Настройте свой проект Firebase

  1. Установите отпечаток SHA-1 вашей игры на странице настроек консоли Firebase.

    Вы можете получить хэш SHA сертификата подписи с помощью команды gradle signingReport :

    ./gradlew signingReport

  2. Включите Google Play Games в качестве поставщика услуг входа:

    1. Найдите идентификатор клиента веб-сервера и секрет клиента. Идентификатор клиента веб-сервера идентифицирует ваш проект Firebase для серверов аутентификации Google Play.

      Чтобы найти эти значения:

      1. Откройте свой проект Firebase на странице учетных данных консоли Google API .
      2. В разделе идентификаторов клиентов OAuth 2.0 откройте страницу сведений о веб-клиенте (автоматически создается службой Google) . На этой странице перечислены идентификатор и секрет клиента вашего веб-сервера.
    2. Затем в консоли Firebase откройте раздел « Аутентификация ».

    3. На вкладке Метод входа включите поставщика услуг входа в Play Игры . Вам нужно будет указать идентификатор клиента веб-сервера вашего проекта и секрет клиента, которые вы получили из консоли API.

  1. Откройте консоль Google Play и нажмите Игровые сервисы .
  2. Щелкните Добавить новую игру . В диалоговом окне новой игры щелкните Я уже использую API Google в своей игре и щелкните имя своего проекта Firebase в списке. Выберите категорию игры, затем нажмите « Продолжить», чтобы перейти на страницу сведений об игре.
  3. В конце страницы сведений об игре убедитесь, что включены все необходимые API.
  4. Затем откройте страницу связанных приложений и нажмите Android . Укажите название пакета вашей игры и нажмите « Сохранить и продолжить» . Консоль отобразит ваш идентификатор клиента Android. Вы можете игнорировать это значение.
  5. На странице « Тестирование» внесите в белый список адреса электронной почты всех пользователей, которым необходимо войти в вашу игру, прежде чем вы разместите ее в магазине Play.

Интегрируйте вход в Play Игры в свою игру

Во-первых, интегрируйте вход в Play Игры в свое приложение. См. Раздел « Вход в игры для Android» для получения полных инструкций.

В вашей интеграции, когда вы GoogleSignInOptions объект GoogleSignInOptions , используйте конфигурацию DEFAULT_GAMES_SIGN_IN и вызовите requestServerAuthCode :

Джава

GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
        .requestServerAuthCode(getString(R.string.default_web_client_id))
        .build();

Котлин + KTX

val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
        .requestServerAuthCode(getString(R.string.default_web_client_id))
        .build()

Вы должны передать свой идентификатор клиента веб-сервера методу requestServerAuthCode . Это идентификатор, который вы указали при включении входа в Play Игры в консоли Firebase.

Аутентифицироваться с Firebase

После добавления входа в Play Games в свое приложение вам необходимо настроить Firebase для использования учетных данных Google, которые вы получаете, когда игрок успешно входит в Play Games.

  1. Во-первых, в методе onCreate вашей операции onCreate получите общий экземпляр объекта FirebaseAuth :

Джава

private FirebaseAuth mAuth;
// ...
// Initialize Firebase Auth
mAuth = FirebaseAuth.getInstance();

Котлин + KTX

private lateinit var auth: FirebaseAuth
// ...
// Initialize Firebase Auth
auth = Firebase.auth
  1. При инициализации Activity проверьте, вошел ли игрок уже в Firebase:

Джава

@Override
public void onStart() {
    super.onStart();
    // Check if user is signed in (non-null) and update UI accordingly.
    FirebaseUser currentUser = mAuth.getCurrentUser();
    updateUI(currentUser);
}

Котлин + KTX

override fun onStart() {
    super.onStart()
    // Check if user is signed in (non-null) and update UI accordingly.
    val currentUser = auth.currentUser
    updateUI(currentUser)
}
If the player isn't signed in, present the player with your game's
signed-out experience, including the option to sign in.
  1. После того, как игрок войдет в Play Games в GoogleSignInAccount или интерактивном режиме, получите код аутентификации из объекта GoogleSignInAccount , GoogleSignInAccount его на учетные данные Firebase и GoogleSignInAccount аутентификацию в Firebase, используя учетные данные Firebase:

Джава

// Call this both in the silent sign-in task's OnCompleteListener and in the
// Activity's onActivityResult handler.
private void firebaseAuthWithPlayGames(GoogleSignInAccount acct) {
    Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.getId());

    final FirebaseAuth auth = FirebaseAuth.getInstance();
    AuthCredential credential = PlayGamesAuthProvider.getCredential(acct.getServerAuthCode());
    auth.signInWithCredential(credential)
            .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
                @Override
                public void onComplete(@NonNull Task<AuthResult> task) {
                    if (task.isSuccessful()) {
                        // Sign in success, update UI with the signed-in user's information
                        Log.d(TAG, "signInWithCredential:success");
                        FirebaseUser user = auth.getCurrentUser();
                        updateUI(user);
                    } else {
                        // If sign in fails, display a message to the user.
                        Log.w(TAG, "signInWithCredential:failure", task.getException());
                        Toast.makeText(MainActivity.this, "Authentication failed.",
                                Toast.LENGTH_SHORT).show();
                        updateUI(null);
                    }

                    // ...
                }
            });
}

Котлин + KTX

// Call this both in the silent sign-in task's OnCompleteListener and in the
// Activity's onActivityResult handler.
private fun firebaseAuthWithPlayGames(acct: GoogleSignInAccount) {
    Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.id!!)

    val auth = Firebase.auth
    val credential = PlayGamesAuthProvider.getCredential(acct.serverAuthCode!!)
    auth.signInWithCredential(credential)
            .addOnCompleteListener(this) { task ->
                if (task.isSuccessful) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "signInWithCredential:success")
                    val user = auth.currentUser
                    updateUI(user)
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "signInWithCredential:failure", task.exception)
                    Toast.makeText(baseContext, "Authentication failed.",
                            Toast.LENGTH_SHORT).show()
                    updateUI(null)
                }

                // ...
            }
}

Если вызов signInWithCredential успешно, вы можете использовать метод getCurrentUser для получения данных учетной записи пользователя.

Следующие шаги

После того, как пользователь входит в систему в первый раз, создается новая учетная запись пользователя, привязанная к его идентификатору Play Games. Эта новая учетная запись хранится как часть вашего проекта Firebase и может использоваться для идентификации пользователя во всех приложениях вашего проекта.

В своей игре вы можете получить UID пользователя Firebase из объекта FirebaseUser :

Джава

FirebaseUser user = mAuth.getCurrentUser();
String playerName = user.getDisplayName();

// 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 FirebaseUser.getIdToken() instead.
String uid = user.getUid();

Котлин + KTX

val user = auth.currentUser
user?.let {
    val 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 FirebaseUser.getIdToken() instead.
    val uid = user.uid
}

В своей базе данных Firebase Realtime и правилах безопасности облачного хранилища вы можете получить уникальный идентификатор пользователя вошедшего в систему из переменной auth и использовать его для управления данными, к которым пользователь может получить доступ.

Чтобы получить информацию об игроке пользователя Play Games или получить доступ к сервисам Play Games, используйте API, предоставляемые SDK Google Play Games .

Чтобы выйти из системы, вызовите FirebaseAuth.signOut() :

Джава

FirebaseAuth.getInstance().signOut();

Котлин + KTX

Firebase.auth.signOut()