Tài liệu tham khảo API

Trang này liệt kê các lớp, giao diện, cấu trúc và kiểu liệt kê có trong API SDK Google Play Games trên máy tính cho Unity.

Không gian tên: PlayPcSdkManaged.Initialization

Xử lý vòng đời kết nối giữa trò chơi Unity và thời gian chạy Play Games PC SDK.

Lớp

Loại	Tên	Mô tả
Class	GooglePlayInitialization	Điểm truy cập tĩnh cho SDK. Chứa các phương thức để khởi tạo kết nối không đồng bộ.
Class	InitializeResult	Biểu thị kết quả của một thao tác khởi chạy.

Liệt kê

Loại	Tên	Mô tả
Enum	InitializationError	Mã lỗi được trả về trong quá trình khởi chạy (ví dụ: SdkRuntimeUnavailable, SdkRuntimeUpdateRequired).

Không gian tên: PlayPcSdkManaged.Billing

Cung cấp quyền truy cập vào các tính năng của Google Play Billing, bao gồm cả giao dịch mua hàng trong ứng dụng (IAP) và gói thuê bao.

Lớp

Khách hàng và kết quả

Loại	Tên	Mô tả
Class	BillingClient	Ứng dụng chính để tương tác với dịch vụ Thanh toán. Quản lý kết nối C++ gốc và phải được xử lý.
Class	QueryProductDetailsResult	Kết quả do QueryProductDetailsAsync trả về. Chứa danh sách thông tin chi tiết về sản phẩm khi thành công.
Class	LaunchPurchaseFlowResult	Kết quả do LaunchPurchaseFlowAsync trả về. Chứa thông tin chi tiết về giao dịch mua khi thành công.
Class	QueryPurchasesResult	Kết quả do QueryPurchasesAsync trả về. Chứa danh sách các giao dịch mua do người dùng sở hữu.
Class	AcknowledgePurchaseResult	Kết quả do AcknowledgePurchaseAsync trả về.
Class	ConsumePurchaseResult	Kết quả do ConsumePurchaseAsync trả về.

Cấu trúc

Tham số và mô hình

Loại	Tên	Mô tả
Struct	QueryProductDetailsParams	Các thông số đầu vào để truy vấn thông tin chi tiết về sản phẩm, chứa danh sách mã sản phẩm.
Struct	LaunchPurchaseFlowParams	Tham số đầu vào để bắt đầu một giao dịch mua, bao gồm OfferToken, Quantity và các mã nhận dạng bị làm rối.
Struct	AcknowledgePurchaseParams	Tham số đầu vào để xác nhận giao dịch mua, yêu cầu PurchaseToken.
Struct	ConsumePurchaseParams	Tham số đầu vào để sử dụng giao dịch mua, yêu cầu PurchaseToken.
Struct	ProductId	Biểu thị giá trị nhận dạng sản phẩm và loại của giá trị nhận dạng đó (InApp hoặc Subs).
Struct	ProductDetails	Thông tin chi tiết về một sản phẩm, bao gồm tiêu đề, nội dung mô tả và các ưu đãi hiện có.
Struct	ProductOffer	Thể hiện một mức giá cụ thể cho một sản phẩm, bao gồm cả FormattedPrice và OfferToken.
Struct	ProductPurchaseDetails	Thông tin chi tiết về một giao dịch, bao gồm OrderId, PurchaseState và PurchaseToken.

Liệt kê

Loại	Tên	Mô tả
Enum	BillingError	Mã trạng thái đại diện cho kết quả của một thao tác thanh toán (ví dụ: Ok, UserCanceled, ItemAlreadyOwned).
Enum	ProductType	Xác định loại sản phẩm: InApp (1) hoặc Subs (Gói thuê bao).
Enum	PurchaseState	Trạng thái của giao dịch mua: Unspecified (0), Purchased (1) hoặc Pending (2).

Không gian tên: PlayPcSdkManaged.Integrity

Cung cấp quyền truy cập vào API Tính toàn vẹn của Play để chống hành vi sai trái và phát hiện hành vi gian lận.

Lớp

Khách hàng và kết quả

Loại	Tên	Mô tả
Class	IntegrityClient	Ứng dụng chính để tương tác với API Tính toàn vẹn. Quản lý kết nối C++ gốc và phải được xử lý.
Class	PrepareIntegrityTokenResult	Kết quả do PrepareIntegrityTokenAsync trả về.
Class	RequestIntegrityTokenResult	Kết quả do RequestIntegrityTokenAsync trả về. Chứa các byte mã thông báo đã ký khi thành công.

Cấu trúc (Tham số và mô hình)

Loại	Tên	Mô tả
Struct	PrepareIntegrityTokenParams	Tham số đầu vào cho bước chuẩn bị, yêu cầu CloudProjectNumber.
Struct	RequestIntegrityTokenParams	Tham số đầu vào cho bước yêu cầu, yêu cầu RequestTokenData và RequestHash.
Struct	RequestTokenData	Dữ liệu trung gian do bước chuẩn bị trả về (chứa WarmUpSessionId) cần thiết cho yêu cầu tiếp theo.

Liệt kê

Loại	Tên	Mô tả
Enum	IntegrityError	Mã trạng thái biểu thị kết quả của một thao tác về tính toàn vẹn (ví dụ: Ok, CloudProjectNumberIsInvalid, NetworkError).

Không gian tên: PlayPcSdkManaged.Unity

Các trình trợ giúp và bộ chuyển đổi dành riêng cho Unity cho SDK.

Lớp

Loại	Tên	Mô tả
Class	PlayPcSdkFactory	Lớp nhà máy dùng để tạo các thực thể của BillingClient và IntegrityClient, đồng thời truy xuất InitializationHandler. Lớp này xử lý việc tạo lệnh gọi lại dành riêng cho Unity.

Không gian tên: PlayPcSdkManaged.Core

Cơ sở hạ tầng cốt lõi được chia sẻ trên các mô-đun SDK.

Lớp

Loại	Tên	Mô tả
Class	Result<TError, TValue>	Lớp cơ sở cho tất cả kết quả API. Cung cấp các thuộc tính IsOk, Code, ErrorMessage và Value.