v2 Native C veya C++'ı ayarlama

Bu belge, C++ projenizi v2 Native C veya C++ için ayarlamanıza ve kimlik doğrulama hizmetini doğrulamanıza yardımcı olur.

Başlamadan önce

Google Play Console'da Play Games Hizmetleri'ni ayarlamanız gerekir.

Uygulama ön koşulları

Uygulamanızın derleme dosyasında aşağıdaki değerlerin kullanıldığından emin olun:

  • 19 veya daha yüksek bir minSdkVersion
  • 28 veya daha yüksek bir compileSdkVersion

Oyun projenizi oluşturma

Oyun projenizi oluşturmak için aşağıdaki adımları tamamlayın.

build.gradle dosyasını güncelleme

Uygulama düzeyindeki build.gradle dosyanızda şunları yapın:

  • Prefabrik oluşturma özelliğinin etkinleştirildiğinden emin olun.

  • v2 Native SDK'sının (beta) bağımlılığını ekleyin:

    • com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1

Aşağıda bununla ilgili bir örnek verilmiştir:

  android {
    ...
    buildFeatures {
      prefab true
    }
    ...
  }
  dependencies {
    ...
    implementation "com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1"
  }

CMakeLists.txt dosyasını güncelleme

CMakeLists.txt dosyanıza aşağıdaki kodu ekleyin:

  find_package(com.google.android.gms.games.v2.c REQUIRED CONFIG)

  // link games_static for -DANDROID_STL=c++_static or default
  // link games_shared for -DANDROID_STL=c++_shared
  target_link_libraries(
    app PUBLIC com.google.android.gms.games.v2.c::games_static)

AndroidManifest.xml dosyasını güncelleyin

  1. AndroidManifest.xml dosyanızda Play Games Hizmetleri proje kimliğinizi tanımlamak için aşağıdaki satırları ekleyin:

    <manifest>
  <application>
    <meta-data android:name="com.google.android.gms.games.APP_ID"
               android:value="@string/game_services_project_id"/>
  </application>
</manifest>

  2. Proje kimliğiniz için bir dize kaynağı oluşturun. Bu sayede oyununuz, derleme sırasında kimliğe erişebilir. Kaynağı oluşturmak için dosyayı oluşturun project_root/app/src/main/res/values/games-ids.xml, ve aşağıdakileri ekleyin:

    <?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="game_services_project_id"
            translatable="false">add your Project ID here</string>
</resources>

  3. Oyununuzu oluşturun ve test edin. Başarılı olursa oyununuzu başlattığınızda oturum açma istemi veya başarılı oturum açma banner'ı gösterilir.

Oturum açma istemini yeniden başlatma

Bir oyuncu, oyununuz başlatıldığında otomatik olarak gösterilen ilk Google Play Games Hizmetleri oturum açma istemini reddederse oyun oturumu sırasında fikrini değiştirebilir. Hiçbir oyuncunun kimliği doğrulanmadığı sürece PgsGamesSignInClient_signIn çağrısı yaparak oturum açma istemini yeniden başlatabilirsiniz.

Oyun sunucusu yetkilendirmesi

Bir oyuncu Play Games Hizmetleri'nde kimliğini başarıyla doğruladıktan sonra oyun istemciniz, arka uç oyun sunucunuzun Play Games Hizmetleri ile güvenli bir şekilde iletişim kurmak için kullanabileceği bir sunucu yetkilendirme kodu isteyebilir. Bu sayede oyun sunucunuz, kimliği doğrulanmış oyuncu için verileri alabilir, güncelleyebilir ve depolayabilir. PgsGamesSignInClient_requestServerSideAccess işlevini çağırarak sunucu yetkilendirme kodunu alabilirsiniz.

Daha fazla bilgi için sunucu erişimi kılavuzuna bakın.