Trang này được dịch bởi Cloud Translation API.

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 trò chơi v1 sang SDK trò chơi v2. Trình bổ trợ Play Games cho Unity, phiên bản 10 trở về trước, sử dụng SDK games v1.

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

Để hưởng lợi từ các tính năng mới nhất trong Dịch vụ trò chơi của Play, hãy tải xuống và cài đặt phiên bản trình bổ trợ mới nhất. Tải xuống từ 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 làm nổi bật trong dự án Unity (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:

Mở dự án trò chơi của bạn.
Trong Unity Hub, hãy nhấp vào Assets > Import Package > Custom Package (Thành phần > Nhập gói > Gói tuỳ chỉnh) để nhập tệp unitypackage đã tải xuống vào thành phần của dự án.
Đả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.
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 người chơi > Cài đặt khác).
Trong hộp Target API level (Cấp độ API mục tiêu), hãy chọn một phiên bản.
Trong hộp Scripting backend (Phần phụ trợ tập lệnh), hãy nhập IL2CPP.
Trong hộp Target architectures (Kiến trúc mục tiêu), hãy chọn một giá trị.
Lưu ý tên gói package_name.Bạn có thể sử dụng thông tin này sau.

Chế độ cài đặt trình phát trong dự án Unity.
Sao chép tài nguyên Android từ Play Console
Thêm tài nguyên Android vào dự án Unity

Thay thế lớp khởi chạy PlayGamesClientConfiguration bằng lớp PlayGamesPlatform.Instance.Authenticate(). Bạn không cần khởi chạy và kích hoạt PlayGamesPlatform. Thao tác gọi PlayGamesPlatform.Instance.Authenticate() 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, 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ủ

Để nhận 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.

Xoá mã trong ví dụ sau:

C#

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

Kiểm thử trò chơi

Kiểm thử để đảm bảo trò chơi của bạn hoạt động như dự kiến. Các bài kiểm thử bạn thực hiện phụ thuộc vào tính năng của trò chơi.

Dưới đây là danh sách các kiểm thử phổ biến cần chạy.

Đă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.
  
  Mẫu 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 được hiển thị trong ví dụ sau:
```
[$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc
number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup.
[CONTEXT service_id=1 ]
```
Đả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 của Play.
2. Tuỳ chọn Đăng xuất không xuất hiện trong giao diện người dùng của Dịch vụ trò chơi của Play.
3. Đảm bảo bạn có thể truy xuất thành công Mã nhận dạng người chơi và các tính năng phía máy chủ hoạt động như mong đợi (nếu có).
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ỹ lưỡng 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ử các tính năng đó để đảm bảo rằng chúng hoạt động giống như trước khi di chuyển:

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

Đăng các tác vụ di chuyển

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