ย้ายข้อมูลไปยังบริการเกมของ Play v2 (Unity)

เอกสารนี้อธิบายวิธีย้ายข้อมูลเกมที่มีอยู่จาก SDK v1 ของ Games ไปยัง SDK v2 ของ Games ปลั๊กอิน Play Games สำหรับ Unity เวอร์ชัน 10 และก่อนหน้าใช้ SDK v1 ของ Games

ก่อนเริ่มต้น

• ตรวจสอบว่าคุณได้ตั้งค่า Play Console และ ติดตั้ง Unity Editor แล้ว

ดาวน์โหลดปลั๊กอิน Google Play Games สำหรับ Unity

หากต้องการใช้ประโยชน์จากฟีเจอร์ล่าสุดในบริการเกมของ Play ให้ดาวน์โหลดและติดตั้งปลั๊กอินเวอร์ชันล่าสุด ดาวน์โหลดได้จากที่เก็บ GitHub

นำปลั๊กอินเก่าออก

ใน Unity Editor ให้นำโฟลเดอร์หรือไฟล์ต่อไปนี้ออก

Assets/GooglePlayGames

Assets/GeneratedLocalRepo/GooglePlayGames

Assets/Plugins/Android/GooglePlayGamesManifest.androidlib

Assets/Plugins/Android

นำเข้าปลั๊กอินใหม่ไปยังโปรเจ็กต์ Unity

หากต้องการนำเข้าปลั๊กอินไปยังโปรเจ็กต์ Unity ให้ทำตามขั้นตอนต่อไปนี้

1. เปิดโปรเจ็กต์เกม
2. ใน Unity Editor ให้คลิกชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง เพื่อนำเข้าไฟล์unitypackage ที่ดาวน์โหลดแล้วไปยังชิ้นงานของโปรเจ็กต์

3. ตรวจสอบว่าแพลตฟอร์มบิลด์ปัจจุบันตั้งค่าเป็น Android

   1. คลิกไฟล์ > การตั้งค่าการสร้างในเมนูหลัก

   2. เลือก Android แล้วคลิกเปลี่ยนแพลตฟอร์ม

   3. คุณควรเห็นรายการเมนูใหม่ในส่วนหน้าต่าง > Google Play Games หากไม่มี ให้รีเฟรชชิ้นงานโดยคลิกชิ้นงาน > รีเฟรช แล้ว ลองตั้งค่าแพลตฟอร์มบิลด์อีกครั้ง

4. ใน Unity Editor ให้คลิก File > Build Settings > Player Settings > Other Settings

5. เลือกเวอร์ชันในช่องระดับ API เป้าหมาย

6. ในช่องแบ็กเอนด์การเขียนสคริปต์ ให้ป้อน IL2CPP

7. เลือกค่าในช่องสถาปัตยกรรมเป้าหมาย

8. จดชื่อแพ็กเกจ package_name คุณสามารถใช้ข้อมูลนี้ ในภายหลังได้

   

9. คัดลอกทรัพยากร Android จาก Play Console

10. เพิ่มทรัพยากร Android ลงในโปรเจ็กต์ Unity

เส้นทางการย้ายข้อมูล

เส้นทางการย้ายข้อมูลที่ถูกต้องสำหรับเกมของคุณจะขึ้นอยู่กับวิธีที่เกมใช้บริการเกมของ Play เวอร์ชัน 1 และ จัดการข้อมูลประจำตัวของผู้เล่น ระบุสถานการณ์ที่ตรงกับการตั้งค่าที่มีอยู่มากที่สุดและทำตามขั้นตอนที่เกี่ยวข้องเพื่อให้การเปลี่ยนผ่านเป็นไปอย่างราบรื่นและป้องกันไม่ให้ข้อมูลผู้เล่นสูญหาย

ตัวเลือกที่ 1: สำหรับเกมที่ IGA เชื่อมโยงกับรหัสผู้เล่นของบริการเกมของ Play

สถานการณ์นี้ใช้กับเกมที่ใช้บริการเกมของ Play Player ID เป็นตัวระบุเพียงอย่างเดียวสำหรับบัญชีในเกม (IGA) ของผู้เล่น และไม่ได้ขอหรือจัดเก็บ OpenID ไว้ก่อนหน้านี้ ความท้าทายหลักคือการลิงก์ IGA ที่มีอยู่ กับตัวระบุหลัก (OpenID) โดยไม่สูญเสียการเชื่อมต่อกับ ความคืบหน้าของผู้เล่น

ขั้นตอนการย้ายข้อมูลมีดังนี้

1. เมื่อเปิดเกม SDK บริการเกมของ Play เวอร์ชัน 2 จะตรวจสอบสิทธิ์แพลตฟอร์มโดยอัตโนมัติและเงียบๆ

2. เกมจะแสดงหน้าจอเข้าสู่ระบบ หน้าจอนี้ต้องมีปุ่มลงชื่อเข้าใช้ ด้วย Google (SiWG) แทนที่ปุ่ม Google Play วิธีผสานรวม

   1. ดาวน์โหลด CredManBridge.java ไปยังโฟลเดอร์ของคุณ คลาส Java นี้ทำหน้าที่เป็น บริดจ์ระหว่าง Unity กับไลบรารี androidx.credentials

      CredManBridge.java

      
      package com.wickedcube.trivialkart;
      import android.accounts.Account;
      import android.content.Context;
      import android.util.Log;
      import android.os.CancellationSignal;
      import androidx.credentials.CredentialManager;
      import androidx.credentials.GetCredentialRequest;
      import androidx.credentials.GetCredentialResponse;
      import androidx.credentials.exceptions.GetCredentialException;
      import androidx.credentials.exceptions.NoCredentialException;
      import com.google.android.libraries.identity.googleid.GetGoogleIdOption;
      import com.google.android.libraries.identity.googleid.GoogleIdTokenCredential;
      import com.google.android.gms.auth.api.identity.AuthorizationClient;
      import com.google.android.gms.auth.api.identity.AuthorizationRequest;
      import com.google.android.gms.auth.api.identity.AuthorizationResult;
      import com.google.android.gms.common.api.ApiException;
      import com.google.android.gms.auth.api.identity.Identity;
      import com.google.android.gms.common.api.Scope;
      import com.unity3d.player.UnityPlayer;
      import java.util.Collections;
      import java.util.List;
      import java.util.concurrent.Executor;
      import java.util.concurrent.Executors;
      
      
      public class CredManBridge {
      
      // --- MODE 1: SILENT SIGN-IN (Called on Awake) ---
      // Tries to auto-select an authorized account. If it fails, it does NOT show UI.
      public static void signInSilent(Context context, String webClientId) {
        CredentialManager credentialManager = CredentialManager.create(context);
        CancellationSignal cancellationSignal = new CancellationSignal();
        Executor executor = Executors.newSingleThreadExecutor();
      
      Log.d("CredMan", "Attempting Silent Sign-In...");
      
      GetGoogleIdOption silentOption = new GetGoogleIdOption.Builder()
          .setFilterByAuthorizedAccounts(true) // Strict: Only authorized accounts
          .setServerClientId(webClientId)
          .setAutoSelectEnabled(true)          // Auto-select if possible
          .build();
      
      GetCredentialRequest silentRequest = new GetCredentialRequest.Builder()
          .addCredentialOption(silentOption)
          .build();
      
      credentialManager.getCredentialAsync(
          context,
          silentRequest,
          cancellationSignal,
          executor,
          new androidx.credentials.CredentialManagerCallback<GetCredentialResponse, GetCredentialException>() {
              @Override
              public void onResult(GetCredentialResponse result) {
                  Log.d("CredMan", "Silent Sign-In Successful!");
                  handleSignInResult(context, result, webClientId);
              }
          @Override
          public void onError(GetCredentialException e) {
              // Send a specific error code so Unity knows to just stay on the Start Screen
              Log.d("CredMan", "Silent sign-in failed. Keeping UI hidden.");
              UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "SilentFailed");
          }
      }
      
      );
      }
      
      // --- MODE 2: INTERACTIVE SIGN-IN (Called on Button Click) ---
      // Forces the Account Selection / "Add Account" sheet to appear.
      public static void signInInteractive(Context context, String webClientId) {
        CredentialManager credentialManager = CredentialManager.create(context);
        CancellationSignal cancellationSignal = new CancellationSignal();
        Executor executor = Executors.newSingleThreadExecutor();
      
      Log.d("CredMan", "Starting Interactive Sign-In...");
      
      GetGoogleIdOption interactiveOption = new GetGoogleIdOption.Builder()
          .setFilterByAuthorizedAccounts(false) // Show ALL accounts (and "Add Account")
          .setServerClientId(webClientId)
          .setAutoSelectEnabled(false)          // Force the UI to show
          .build();
      
      GetCredentialRequest interactiveRequest = new GetCredentialRequest.Builder()
          .addCredentialOption(interactiveOption)
          .build();
      
      credentialManager.getCredentialAsync(
          context,
          interactiveRequest,
          cancellationSignal,
          executor,
          new androidx.credentials.CredentialManagerCallback<getcredentialresponse, getcredentialexception="">() {
              @Override
              public void onResult(GetCredentialResponse result) {
                  Log.d("CredMan", "Interactive Sign-In Successful!");
                  handleSignInResult(context, result, webClientId);
              }</getcredentialresponse,>
          @Override
          public void onError(GetCredentialException e) {
              Log.e("CredMan", "Interactive Sign-In Canceled or Failed", e);
              UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Canceled");
          }
      }
      
      );
      }
      
      private static void handleSignInResult(Context context, GetCredentialResponse result, String webClientId) {
        try {
          GoogleIdTokenCredential credential = GoogleIdTokenCredential.createFrom(result.getCredential().getData());
          String email = credential.getId();
      Account account = new Account(email, "com.google");
      // Requesting GAMES_LITE scope to check for pre-existing V1 grants
      List<Scope> requestedScopes = Collections.singletonList(new Scope("https://www.googleapis.com/auth/games_lite"));
      
      AuthorizationRequest authRequest = new AuthorizationRequest.Builder()
          .setRequestedScopes(requestedScopes)
          .setAccount(account)
          .requestOfflineAccess(webClientId)
          .build();
      
      AuthorizationClient authClient = Identity.getAuthorizationClient(context);
      
      authClient.authorize(authRequest)
          .addOnSuccessListener(authorizationResult -> {
              if (authorizationResult.getServerAuthCode() != null) {
                  // CASE 1: RETURNING USER (Success)
                  // The user has already granted GAMES_LITE in the past.
                  // We got the code directly without showing UI.
                  Log.i("CredMan", "PGS v1: Existing grant found. Returning user detected. Auth Code retrieved.");
                  UnityPlayer.UnitySendMessage("AuthManager", "OnSignInSuccess", authorizationResult.getServerAuthCode());
              }
              else if (authorizationResult.hasResolution()) {
                  // CASE 2: NEW USER (PendingIntent)
                  // The user has NOT granted GAMES_LITE before. The API returned a PendingIntent
                  // (authorizationResult.getPendingIntent()) to show the consent screen.
                  // As per your flow, we DISCARD this intent and do not show UI.
                  Log.i("CredMan", "PGS v1: No existing grant (PendingIntent returned). This is a NEW user or they revoked access.");
                  Log.i("CredMan", "PGS v1: Discarding PendingIntent. Proceeding as New User.");
      
                  // Notify Unity that this is a "New User" so it can trigger V2 logic instead of failing
                  UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "NewUser_NoGrant");
              }
              else {
                  // Edge Case: No code and no resolution?
                  Log.e("CredMan", "PGS v1: Authorization success but no Auth Code or Resolution returned.");
                  UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "No Auth Code returned");
              }
          })
          .addOnFailureListener(e -> {
              // CASE 3: GENERIC FAILURE
              Log.e("CredMan", "PGS v1: Authorization failed completely.", e);
              UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Authorization Failed: " + e.getMessage());
          });
      
      } catch (Exception e) {
          UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Parsing Error: " + e.getMessage());
      }
      }
      }
      
      
      
      

   2. การผสานรวม Credential Manager:

      • ใช้ GetGoogleIdOption กับ setFilterByAuthorizedAccounts(true) สำหรับการลงชื่อเข้าใช้แบบเงียบเพื่อลงชื่อเข้าใช้เฉพาะผู้ใช้ที่เคย ให้สิทธิ์แอปไว้ก่อนหน้านี้
      • ใช้ setFilterByAuthorizedAccounts(false) สำหรับการลงชื่อเข้าใช้แบบอินเทอร์แอกทีฟ เพื่ออนุญาตให้ผู้ใช้เลือกบัญชีหรือเพิ่มบัญชีใหม่

   3. คำขอขอบเขต:

      • หลังจากได้รับข้อมูลเข้าสู่ระบบพื้นฐานของ Google แล้ว ระบบจะสร้าง AuthorizationRequest โดยขอขอบเขตเดิมที่เฉพาะเจาะจง: https://www.googleapis.com/auth/games_lite
      • ขอบเขตนี้มีความสําคัญอย่างยิ่งเนื่องจากเป็นการให้สิทธิ์เซิร์ฟเวอร์ในการค้นหา PlayerID เดิมของผู้ใช้

   4. การจัดการผลลัพธ์:

      • หากผู้ใช้ให้สิทธิ์ (หรือเคยให้สิทธิ์ไว้ก่อนหน้านี้) Bridge จะส่ง ServerAuthCode กลับไปยัง Unity
      • หากผู้ใช้ไม่ได้ให้สิทธิ์ (สถานการณ์ผู้ใช้ใหม่) API จะ แสดงผล PendingIntent ในตัวอย่างนี้ ระบบจะทิ้ง Intent และ ถือว่าผู้ใช้เป็นผู้ใช้ใหม่เพื่อลดความซับซ้อนของโฟลว์

3. หากต้องการรองรับบริการ Credential Manager และ Google Identity ให้ตรวจสอบว่าได้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในการกำหนดค่า mainTemplate.gradlegradle แล้ว

   dependencies {
   // Standard Unity dependencies
   implementation fileTree(dir: 'libs', include: ['*.jar'])
   
   // Credential Manager and Identity Libraries
   implementation 'androidx.credentials:credentials:1.3.0'
   implementation 'androidx.credentials:credentials-play-services-auth:1.3.0'
   implementation 'com.google.android.libraries.identity.googleid:googleid:1.1.1'
   
   // Play Services Auth for legacy scope handling
   implementation 'com.google.android.gms:play-services-auth:21.2.0'
   }

   • เครื่องมือจัดการข้อมูลเข้าสู่ระบบ: จัดการการจัดระเบียบข้อมูลประจำตัวหลักและ UI สำหรับ การเลือกบัญชี
   • ไลบรารี GoogleID: มีไว้เพื่อ เรียกโทเค็น OpenID Connect โดยเฉพาะGetGoogleIdOption
   • การตรวจสอบสิทธิ์บริการ Google Play: ต้องใช้เพื่อรักษาความเข้ากันได้และขอขอบเขต GAMES_LITE สำหรับการดึงข้อมูล Player ID รุ่นเดิม

4. เมื่อผู้เล่นแตะปุ่ม SiWG และเลือกบัญชี Google เกม ต้องดึงตัวระบุที่แตกต่างกัน 2 รายการ ดังนี้

   • OpenID ซึ่งเป็นตัวระบุหลักสำหรับการผูก IGA
   • Player IDบริการเกมของ PlayGAMES_LITE ที่ดึงข้อมูลโดยใช้ขอบเขต GAMES_LITE เพื่อค้นหา IGA ของผู้เล่นในระบบแบ็กเอนด์และทำการเชื่อมโยง

5. ในการเปิดตัวเกมครั้งต่อๆ ไป ผู้เล่นจะเข้าถึง IGA ได้โดยใช้ขั้นตอน SiWG โดยไม่ต้องให้เกมใช้ Player ID เป็นตัวระบุหลัก

using GooglePlayGames;
using GooglePlayGames.BasicApi;
using UnityEngine.SocialPlatforms;

public void Start() {
    PlayGamesClientConfiguration config =
        new PlayGamesClientConfiguration.Builder()
    // Enables saving game progress
    .EnableSavedGames()
    // Requests the email address of the player be available
    // will bring up a prompt for consent
    .RequestEmail()
    // Requests a server auth code be generated so it can be passed to an
    // associated backend server application and exchanged for an OAuth token
    .RequestServerAuthCode(false)
    // Requests an ID token be generated. This OAuth token can be used to
    // identify the player to other services such as Firebase.
    .RequestIdToken()
    .Build();

    PlayGamesPlatform.InitializeInstance(config);
    // recommended for debugging:
    PlayGamesPlatform.DebugLogEnabled = true;
    // Activate the Google Play Games platform
    PlayGamesPlatform.Activate();
}

using GooglePlayGames;

public void Start() {
    PlayGamesPlatform.Instance.Authenticate(ProcessAuthentication);
}

internal void ProcessAuthentication(SignInStatus status) {
    if (status == SignInStatus.Success) {
        // Continue with Play Games Services
    } else {
        // Disable your integration with Play Games Services or show a login
        // button to ask users to sign-in. Clicking it should call
        // PlayGamesPlatform.Instance.ManuallyAuthenticate(ProcessAuthentication).
    }
}

// sign out
PlayGamesPlatform.Instance.SignOut();