Catch up on everthing we announced at this year's Firebase Summit. Learn more

Google Play Oyun Hizmetlerini C++ ile Kullanarak Kimlik Doğrulama

Firebase üzerine kurulu ve C++ ile yazılmış bir Android oyununda oyuncularla oturum açmak için Google Play Oyunlar hizmetlerini kullanabilirsiniz. Google Play Oyunlar hizmetlerinde Firebase ile oturum açmak için önce oynatıcıda Google Play Oyunlar ile oturum açın ve bunu yaptığınızda bir OAuth 2.0 kimlik doğrulama kodu isteyin. Sonra, auth kodunu aktaracak PlayGamesAuthProvider Eğer Firebase ile kimlik doğrulaması için kullanabileceğiniz bir Firebase kimlik oluşturmak için.

Sen başlamadan önce

Eğer kullanmadan önce Firebase Authentication , yapmanız gerekenler:

  • C++ projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    C++ projeniz zaten Firebase kullanıyorsa, Firebase için zaten kayıtlı ve yapılandırılmıştır.

  • Ekle Firebase C ++ SDK sizin C ++ projeye.

Not sizin C'ye Firebase ekleyerek bu ++ projesi hem görevleri kapsar Firebase konsoluna (örneğin, daha sonra, konsoldan Firebase yapılandırma dosyalarını indirmek için C ++ projesi içine taşıyabilirsiniz) ve açık C ++ projede.

Firebase projenizi kurun

  1. Zaten yapmadıysanız, içinde oyununuzun SHA-1 parmak izini set Ayarlar Firebase konsolunun sayfa.

    Sen gradle ile imzalama sertifikasının SHA karma alabilirsiniz signingReport komutu:

    ./gradlew signingReport

  2. Google Play Oyunlar'ı oturum açma sağlayıcısı olarak etkinleştirin:

    1. Projenizin web sunucusu istemci kimliğini ve istemci sırrını bulun. Web sunucusu istemci kimliği, Firebase projenizi Google Play kimlik doğrulama sunucularına tanımlar.

      Bu değerleri bulmak için:

      1. İçinde Firebase projesini açın Google API konsolu kimlik bilgileri sayfasında.
      2. OAuth 2.0 istemci kimliği bölümünde, (Google Servisi tarafından oluşturulan otomatik) Web istemcisi sayfasını ayrıntıları açın. Bu sayfa, web sunucusu istemci kimliğinizi ve sırrınızı listeler.
    2. Sonra, içinde Firebase konsolunda , Kimlik Doğrulama bölümünü açın.

    3. Yöntem sekmede yap, Play Games oturum açma sağlayıcıya sağlar. API konsolundan aldığınız projenizin web sunucusu istemci kimliğini ve istemci sırrını belirtmeniz gerekecektir.

  1. Gelen Google Play konsoluna , uygulamayı açıp veya bir tane oluşturun.

  2. Grow adındaki bölümünde, Oyun Hizmetleri> Kurulum ve Yönetim> Yapılandırma oyna tıklayın.

  3. Evet tıklayın, benim oyun zaten kullandığı Google API'leri, listeden Firebase projesinin adını seçin ve Kullan tıklayın.

  4. Oyun Oyna Hizmetler yapılandırma sayfasında, tık Kimlik Bilgisi Ekle.

    1. Oyun sunucusu türünü seçin.
    2. OAuth istemci alanına, projenin web müşteri kimliği seçin. Bunun Play Oyunlar oturum açmayı etkinleştirdiğinizde belirttiğiniz istemci kimliğiyle aynı olduğundan emin olun.
    3. Değişikliklerinizi kaydedin.
  5. Yine Oyun Oyna Hizmetler yapılandırma sayfasında, tıklayın tekrar Kimlik Bilgisi Ekle.

    1. Android türünü seçin.
    2. OAuth istemci alanına, projenin Android müşteri kimliği seçin. (Android istemci kimliğinizi görmüyorsanız oyununuzun SHA-1 parmak izini Firebase konsolunda ayarladığınızdan emin olun.)
    3. Değişikliklerinizi kaydedin.
  6. Test sayfasında, Play mağazasında bırakın önce oyuna giriş yapabilmek için gereken herhangi bir kullanıcının e-posta adreslerini ekleyin.

Play Oyunlar oturum açma özelliğini oyununuza entegre edin

Oyuncuların oyununuzda oturum açabilmesi için önce Google Play Oyunlar oturum açma özelliğini entegre etmeniz gerekir.

Bir C ++ Android projeye oturum açma Play Oyunlar için destek eklemek için en kolay ve tavsiye edilen bir yol kullanmaktır Google Sign-in C ++ SDK .

Google Sign-in C++ SDK'sını kullanarak oyununuza Play Oyunlar oturum açma özelliğini eklemek için aşağıdakileri yapın:

  1. Klon indirmek veya Google Unity Oturum Açma eklenti depoyu da C ++ SDK içerir.

  2. İçerdiği projeyi oluşturun staging/native/ Android Studio kullanılarak veya iki dizine, gradlew build .

    İnşa kopyalar bir dizin adında için çıkış google-signin-cpp .

  3. Google Sign-in C++ SDK'sını oyununuzun yerel kod oluşturma dosyasına ekleyin:

    CMake

    Üst düzey olarak CMakeLists.txt dosyası:

    set(GSI_PACKAGE_DIR "/path/to/google-signin-cpp")
    add_library(lib-google-signin-cpp STATIC IMPORTED) set_target_properties(lib-google-signin-cpp PROPERTIES IMPORTED_LOCATION     ${GSI_PACKAGE_DIR}/lib/${ANDROID_ABI}/libgoogle-signin-cpp.a )
    ...
    target_link_libraries(     ...     lib-google-signin-cpp)

    ndk-build

    Senin içinde Android.mk dosyası:

    include $(CLEAR_VARS)
    LOCAL_MODULE := google-signin-cpp
    GSI_SDK_DIR := /path/to/google-signin-cpp
    LOCAL_SRC_FILES := $(GSI_SDK_DIR)/lib/$(TARGET_ARCH_ABI)/libgoogle-signin-cpp.a
    LOCAL_EXPORT_C_INCLUDES := $(GSI_SDK_DIR)/include
    include $(PREBUILT_STATIC_LIBRARY)
    

  4. Ardından, C++ SDK'nın gerektirdiği Java yardımcı bileşenini ekleyin.

    Proje düzeyi içinde, Bunu yapmak için build.gradle dosyası, yerel bir depo olarak SDK oluşturma çıkış dizinini ekleyin:

    allprojects {
        repositories {
            // ...
            flatDir {
                dirs 'path/to/google-signin-cpp'
            }
        }
    }
    

    Ve, senin Modül düzeyinde de build.gradle dosyası, bir bağımlılık olarak yardımcı bileşeni ilan:

    dependencies {
        implementation 'com.google.android.gms:play-services-auth:19.2.0'
        // Depend on the AAR built with the Google Sign-in SDK in order to add
        // the Java helper classes, which are used by the C++ library.
        compile(name:'google-signin-cpp-release', ext:'aar')
    }
    
  5. Ardından, oyunda, yapılandırmak bir GoogleSignIn nesne kullanımı Play'e Oyun oturum açma ve bir sunucu kimlik doğrulama kodunu almak:

    #include "google_signin.h"
    #include "future.h"
    
    using namespace google::signin;
    
    // ...
    
    GoogleSignIn::Configuration config = {};
    config.web_client_id = "YOUR_WEB_CLIENT_ID_HERE";
    config.request_id_token = false;
    config.use_game_signin = true;
    config.request_auth_code = true;
    
    GoogleSignIn gsi = GoogleSignIn(GetActivity(), GetJavaVM());
    gsi.Configure(config);
    
  6. Son olarak, çağrı SignIn() Play Oyunlar'da oyuncu imzalamak için:

    Future<GoogleSignIn::SignInResult> &future = gsi.SignIn();
    

    Gelecek tarafından döndüğünde SignIn() giderir, sen sonucundan sunucu kimlik doğrulama kodunu alabilirsiniz:

    if (!future.Pending()) {
        const GoogleSignIn::StatusCode status =
                static_cast<GoogleSignIn::StatusCode>(future.Status());
        if (status == GoogleSignIn::kStatusCodeSuccess) {
            // Player successfully signed in to Google Play! Get auth code to
            //   pass to Firebase
            const GoogleSignIn::SignInResult result =
                    static_cast<GoogleSignIn::SignInResult>(future.Result());
            const char* server_auth_code = result.User.GetServerAuthCode();
        }
    }
    

Firebase ile kimlik doğrulaması yapın

Oyuncu Play Oyunlar ile oturum açtıktan sonra, Firebase ile kimlik doğrulaması yapmak için yetkilendirme kodunu kullanabilirsiniz.

  1. Oyuncu, Play Oyunlar'da başarıyla oturum açtıktan sonra, oyuncunun hesabı için bir yetkilendirme kodu alın.

  2. Ardından, Play Oyunlar hizmetlerinden bir Firebase kimlik bilgisi için kimlik doğrulama kodunu değiştirin ve oyuncunun kimliğini doğrulamak için Firebase kimlik bilgisini kullanın:

    firebase::auth::Credential credential =
        firebase::auth::PlayGamesAuthProvider::GetCredential(server_auth_code);
    firebase::Future<firebase::auth::User*> result =
        auth->SignInWithCredential(credential);
    
  3. Programınız düzenli çalışır (saniyede 30 veya 60 kez söylemek) o bir güncelleme döngüsü var ise, bir kere ile güncelleme başına sonuçları kontrol edebilirsiniz Auth::SignInWithCredentialLastResult :

    firebase::Future<firebase::auth::User*> result =
        auth->SignInWithCredentialLastResult();
    if (result.status() == firebase::kFutureStatusComplete) {
      if (result.error() == firebase::auth::kAuthErrorNone) {
        firebase::auth::User* user = *result.result();
        printf("Sign in succeeded for `%s`\n", user->display_name().c_str());
      } else {
        printf("Sign in failed with error '%s'\n", result.error_message());
      }
    }

    Programınız olay sürülüyorsa Ya da, tercih edebilir Geleceği Üzerine Bir geri arama kayıt .

Bir Gelecek için bir geri arama kaydedin

Bazı programlar var Update saniyede 30 veya 60 kez denir işlevleri. Örneğin birçok oyun bu modeli takip ediyor. Bu programlar çağırabilir LastResult asenkron aramaları yoklamak için işlevler. Ancak, programınız olay odaklıysa, geri arama işlevlerini kaydetmeyi tercih edebilirsiniz. Geleceğin tamamlanması üzerine bir geri arama işlevi çağrılır.
void OnCreateCallback(const firebase::Future<firebase::auth::User*>& result,
                      void* user_data) {
  // The callback is called when the Future enters the `complete` state.
  assert(result.status() == firebase::kFutureStatusComplete);

  // Use `user_data` to pass-in program context, if you like.
  MyProgramContext* program_context = static_cast<MyProgramContext*>(user_data);

  // Important to handle both success and failure situations.
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::User* user = *result.result();
    printf("Create user succeeded for email %s\n", user->email().c_str());

    // Perform other actions on User, if you like.
    firebase::auth::User::UserProfile profile;
    profile.display_name = program_context->display_name;
    user->UpdateUserProfile(profile);

  } else {
    printf("Created user failed with error '%s'\n", result.error_message());
  }
}

void CreateUser(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::User*> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // `&my_program_context` is passed verbatim to OnCreateCallback().
  result.OnCompletion(OnCreateCallback, &my_program_context);
}
İsterseniz geri çağırma işlevi de, bir lambda olabilir.
void CreateUserUsingLambda(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::User*> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // The lambda has the same signature as the callback function.
  result.OnCompletion(
      [](const firebase::Future<firebase::auth::User*>& result,
         void* user_data) {
        // `user_data` is the same as &my_program_context, below.
        // Note that we can't capture this value in the [] because std::function
        // is not supported by our minimum compiler spec (which is pre C++11).
        MyProgramContext* program_context =
            static_cast<MyProgramContext*>(user_data);

        // Process create user result...
        (void)program_context;
      },
      &my_program_context);
}

Sonraki adımlar

Bir kullanıcı ilk kez oturum açtıktan sonra yeni bir kullanıcı hesabı oluşturulur ve Play Oyunlar Kimliğine bağlanır. Bu yeni hesap, Firebase projenizin bir parçası olarak depolanır ve projenizdeki her uygulamada bir kullanıcıyı tanımlamak için kullanılabilir.

Oyununuz, içinden kullanıcının Firebase UID alabilirsiniz firebase::auth::User nesnesi:

firebase::auth::User* user = auth->current_user();
if (user != nullptr) {
  std::string 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 firebase::auth::User::Token() instead.
  std::string uid = user->uid();
}

Senin Firebase Gerçek Zamanlı Veritabanı ve Bulut Depolama Güvenliği Kuralları, sen alabilirsiniz, kullanıcının benzersiz bir kullanıcı kimliği imzalı auth değişkeni ve hangi verilerin kullanıcı teneke erişimi kontrol etmek için kullanabilirsiniz.

Bir kullanıcının Play Oyunlar oyuncu bilgi almak veya erişim Play Oyunlar hizmetlerine için sağladığı API'leri kullanmak Google Play Oyunlar hizmetleri C ++ SDK .

Bir kullanıcı Oturumu kapatmak için çağrı SignOut() :

auth->SignOut();