Tích hợp Google Play Games PC SDK với Unity

Hướng dẫn này cung cấp từng bước về cách tích hợp SDK Google Play Games trên máy tính vào dự án Unity.

Bước 1: Tải SDK xuống

Tải phiên bản mới nhất của Gói Unity xuống bằng đường liên kết tải xuống.

Tải xuống: SDK Unity của Play Games trên máy tínhUnity

Bước 2: Nhập gói

SDK được phân phối dưới dạng tệp tar tương thích với Trình quản lý gói Unity (UPM). Để biết thêm thông tin, xem Cài đặt gói UPM từ tệp tar cục bộ

Bước 3: Định cấu hình chế độ cài đặt bản dựng

Để xác minh rằng các thư viện gốc tải đúng cách, bạn phải định cấu hình dự án để sử dụng phần phụ trợ tập lệnh IL2CPP và nhắm đến kiến trúc chính xác.

  1. Tạo hồ sơ bản dựng với Windows làm nền tảng.

  2. Chọn chế độ cài đặt nền tảng là Windows. Đối với kiến trúc, hãy sử dụng các lựa chọn sau:

    • Intel 64 bit (Nên dùng)
    • Intel 32 bit

    Lưu ý: Nền tảng Google Play Games trên máy tính chạy trên môi trường 64 bit. Bạn có thể tạo trò chơi ở dạng 32 bit (x86) hoặc 64 bit (x64).

  3. Đặt Scripting Backend (Phần phụ trợ tập lệnh) thành IL2CPP. Để biết thêm thông tin, hãy xem bài viết Tạo dự án bằng IL2CPP.

    • Đặt Api Compatibility Level (Cấp độ tương thích của API) thành .NET Standard 2.0 (hoặc .NET Framework).

Bước 4: Tạo tệp kê khai ứng dụng

Trước khi có thể sử dụng SDK trong trò chơi, bạn phải liên kết tệp thực thi trò chơi với tên gói Play mà bạn đã xác nhận quyền sở hữu trong Play Console. Bạn có thể thực hiện việc này bằng cách thêm tệp manifest.xml vào cùng thư mục với tệp thực thi của trò chơi.

Lưu ý: Đây là bước thủ công mà bạn phải thực hiện.

  1. Để tạo tệp thực thi trò chơi, hãy chọn File > Build and Run (Tệp > Tạo và chạy) hoặc nhấp vào Ctrl+B.
  2. Mở trình chỉnh sửa văn bản rồi tạo một tệp mới có tên manifest.xml.

  3. Sao chép và dán mã XML sau đây vào tệp:

    <?xml version="1.0" encoding="utf-8"?>
<?Manifest version="1">
   <?Application>
     <?PackageName>com.example.package<?/PackageName>
   <?/Application>
<?/Manifest>

  4. Lưu tệp dưới dạng manifest.xml.

  5. Di chuyển tệp này vào cùng thư mục với tệp thực thi trò chơi đã tạo.

    Ví dụ: Nếu trò chơi của bạn nằm ở Builds/MyGame.exe, thì tệp kê khai phải nằm ở Builds/manifest.xml.

Lưu ý: Nếu bạn muốn sử dụng SDK trên máy tính trong khi phát triển trong Trình chỉnh sửa Unity mà không cần ký kỹ thuật số tệp thực thi trò chơi hoặc chạy tệp đó từ Google Play Games. Để biết thêm các bước định cấu hình tệp kê khai, hãy xem hướng dẫn thiết lập chế độ nhà phát triển.

Bước 5: Khởi chạy SDK

Bạn phải khởi chạy SDK trước khi truy cập vào bất kỳ tính năng nào, chẳng hạn như Thanh toán hoặc Tính toàn vẹn. Sử dụng PlayPcSdkFactory để tạo trình xử lý khởi chạy và bắt đầu kết nối.

Tạo tập lệnh C# mới, ví dụ: SdkInitialization.cs rồi thêm mã sau:

using UnityEngine;
using System;
using System.Threading.Tasks;
// Import the SDK namespaces
using PlayPcSdkManaged.Initialization;
using PlayPcSdkManaged.Unity;

public class GooglePlayPCSDKInit : MonoBehaviour
{
    // Prevent double-initialization if this script is reloaded
    private static bool _isInitialized = false;

    private void Start()
    {
        // Use the "Safe Runner" pattern to fire the async method
        _ = InitializeSdkAsync();
    }

    private async Task InitializeSdkAsync()
    {
        if (_isInitialized)
        {
            Debug.LogWarning("Google Play PC SDK is already initialized. Skipping.");
            return;
        }

        try
        {
            Debug.Log("Initializing Google Play PC SDK...");

            // 1. Get the Unity-specific initialization handler from the factory
            var initHandler = PlayPcSdkFactory.InitializationHandler;

            // 2. Call InitializeAsync to start the connection
            var result = await GooglePlayInitialization.InitializeAsync(initHandler);

            // 3. Check the result
            if (result.IsOk)
            {
                _isInitialized = true;
                Debug.Log("<color=green>Google Play PC SDK Initialized Successfully!</color>");
                // You can now create BillingClient or IntegrityClient instances
            }
            else
            {
                Debug.LogError($"<color=red>Initialization Failed!</color>");
                Debug.LogError($"Error Code: {result.Code}");
                Debug.LogError($"Message: {result.ErrorMessage}");
            }
        }
        catch (Exception ex)
        {
            // Catch unexpected crashes or task failures
            Debug.LogError($"Exception during initialization: {ex.Message}");
            Debug.LogException(ex);
        }
    }
}

Đính kèm tập lệnh này vào GameObject trong cảnh đầu tiên. Khi chạy trò chơi, hãy kiểm tra Bảng điều khiển để xem thông báo "SDK Initialized Successfully!" (Đã khởi chạy SDK thành công!).