Di chuyển sang Dịch vụ trò chơi của Play phiên bản 2 (Unity)

Tài liệu này mô tả cách di chuyển các trò chơi hiện có từ SDK games v1 sang SDK games v2. Trình bổ trợ Play Games cho Unity (phiên bản 10 trở về trước) sử dụng SDK của phiên bản 1.

Trước khi bắt đầu

  • Đảm bảo rằng bạn đã thiết lập Play Console và cài đặt Unity Hub.

Tải trình bổ trợ Google Play Games cho Unity xuống

Để tận dụng các tính năng mới nhất trong Dịch vụ Play Games, hãy tải và cài đặt phiên bản trình bổ trợ mới nhất. Tải xuống qua kho lưu trữ gitHub.

Xoá trình bổ trợ cũ

Trong Unity Hub, hãy xoá các thư mục hoặc tệp sau.

Assets/GooglePlayGames

Assets/GeneratedLocalRepo/GooglePlayGames

Assets/Plugins/Android/GooglePlayGamesManifest.androidlib

Assets/Plugins/Android
Xoá các thư mục được đánh dấu trong dự án Unity.
Xoá các thư mục được đánh dấu trong dự án Unity của bạn (nhấp để phóng to).

Nhập trình bổ trợ mới vào dự án Unity

Để nhập trình bổ trợ vào dự án Unity, hãy làm theo các bước sau:

  1. Mở dự án trò chơi của bạn.
  2. Trong Unity Hub, hãy nhấp vào Assets > Import Package > Custom Package (Nội dung > Nhập gói > Gói tuỳ chỉnh) để nhập tệp unitypackage đã tải xuống vào nội dung của dự án.

  3. Hãy đảm bảo nền tảng bản dựng hiện tại của bạn được đặt là Android.

    1. Trong trình đơn chính, hãy nhấp vào File > Build Settings (Tệp > Cài đặt bản dựng).

    2. Chọn Android rồi nhấp vào Switch Platform (Chuyển nền tảng).

    3. Sẽ có một mục mới trong trình đơn tại Window > Google Play Games (Cửa sổ > Google Play Games). Nếu không có, hãy làm mới nội dung bằng cách nhấp vào Assets > Refresh (Nội dung > Làm mới), sau đó thử đặt lại nền tảng bản dựng.

  4. Trong Unity Hub, hãy nhấp vào File > Build Settings > Player Settings > Other Settings (Tệp > Cài đặt bản dựng > Cài đặt trình phát > Các chế độ cài đặt khác).

  5. Trong hộp Cấp API mục tiêu, hãy chọn một phiên bản.

  6. Trong hộp Scripting backend, hãy nhập IL2CPP.

  7. Trong hộp Target architectures (Kiến trúc mục tiêu), hãy chọn một giá trị.

  8. Ghi lại tên gói package_name.Bạn có thể sử dụng thông tin này sau.

    Phần Player Settings (Cài đặt trình phát) trong dự án Unity
    Phần cài đặt trình phát trong dự án Unity.

  9. Sao chép tài nguyên Android từ Play Console

  10. Thêm tài nguyên Android vào dự án Unity

Cập nhật mã tự động đăng nhập

Thay thế lớp khởi tạo PlayGamesClientConfiguration bằng lớp PlayGamesPlatform.Instance.Authenticate(). Bạn không cần khởi chạy và kích hoạt PlayGamesPlatform. Khi gọi PlayGamesPlatform.Instance.Authenticate(), hệ thống sẽ tìm nạp kết quả của tính năng đăng nhập tự động.

C#

Trong Unity Hub, hãy tìm các tệp có lớp PlayGamesClientConfiguration.

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();
}

Và cập nhật nó như sau:

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).
    }
}

Chọn một nền tảng mạng xã hội

Để chọn một nền tảng mạng xã hội, hãy xem phần chọn một nền tảng mạng xã hội.

Truy xuất mã xác thực máy chủ

Để lấy mã truy cập phía máy chủ, hãy xem phần truy xuất mã xác thực máy chủ.

Xoá mã đăng xuất

Xoá mã đăng xuất. Dịch vụ trò chơi của Play không còn yêu cầu nút đăng xuất trong trò chơi nữa.

Xoá mã xuất hiện trong ví dụ sau:

C#

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

Kiểm thử trò chơi

Đảm bảo trò chơi của bạn hoạt động như thiết kế bằng cách kiểm thử trò chơi. Các bài kiểm thử mà bạn thực hiện sẽ tuỳ thuộc vào các tính năng của trò chơi.

Sau đây là danh sách các kiểm thử thường gặp cần chạy.

  1. Đăng nhập thành công.

    1. Tính năng tự động đăng nhập hoạt động. Người dùng phải đăng nhập vào Dịch vụ trò chơi của Play khi khởi chạy trò chơi.

    2. Cửa sổ bật lên chào mừng sẽ xuất hiện.

      Cửa sổ bật lên chào mừng mẫu.
      Ví dụ về cửa sổ bật lên chào mừng (nhấp để phóng to).

    3. Thông báo nhật ký thành công sẽ xuất hiện. Chạy lệnh sau trong dòng lệnh:

      adb logcat | grep com.google.android.

      Thông báo nhật ký thành công xuất hiện trong ví dụ sau:

      [$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc
number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup.
[CONTEXT service_id=1 ]

  2. Đảm bảo tính nhất quán của thành phần giao diện người dùng.

    1. Cửa sổ bật lên, bảng xếp hạng và thành tích hiển thị chính xác và nhất quán trên nhiều kích thước màn hình và hướng trong giao diện người dùng (UI) của Dịch vụ trò chơi Play.

    2. Lựa chọn đăng xuất không xuất hiện trong giao diện người dùng của Dịch vụ Play Games.

    3. Đảm bảo bạn có thể truy xuất Mã nhận dạng người chơi thành công và nếu có, các chức năng phía máy chủ hoạt động như dự kiến.

    4. Nếu trò chơi sử dụng phương thức xác thực phía máy chủ, hãy kiểm thử kỹ quy trình requestServerSideAccess. Đảm bảo máy chủ nhận được mã xác thực và có thể trao đổi mã đó để lấy mã truy cập. Kiểm thử cả trường hợp thành công và không thành công đối với lỗi mạng, trường hợp client ID không hợp lệ.

Nếu trò chơi của bạn đang sử dụng bất kỳ tính năng nào sau đây, hãy kiểm thử để đảm bảo rằng các tính năng đó hoạt động giống như trước khi di chuyển:

  • Bảng xếp hạng: Gửi điểm số và xem bảng xếp hạng. Kiểm tra thứ hạng và cách hiển thị tên cũng như điểm số của người chơi.
  • Thành tích: Mở khoá thành tích và xác minh rằng thành tích được ghi lại và hiển thị chính xác trong giao diện người dùng Play Games.
  • Trò chơi đã lưu: Nếu trò chơi sử dụng tính năng trò chơi đã lưu, hãy đảm bảo rằng việc lưu và tải tiến trình chơi diễn ra suôn sẻ. Điều này đặc biệt quan trọng khi kiểm thử trên nhiều thiết bị và sau khi cập nhật ứng dụng.

Các việc cần làm sau khi di chuyển

Hãy hoàn tất các bước sau khi bạn đã di chuyển sang SDK trò chơi phiên bản 2.

  1. Sử dụng Tính năng ký ứng dụng của Play

  2. Tạo tệp AAB

  3. Tạo bản phát hành kiểm thử nội bộ

  4. Xác minh thông tin đăng nhập để ký ứng dụng