مرجع API

این صفحه کلاس‌ها، رابط‌ها، ساختارها و شمارش‌های موجود در Google Play Games PC SDK برای Unity API را فهرست می‌کند.

فضای نام: PlayPcSdkManaged.Initialization

چرخه حیات اتصال بین بازی Unity و زمان اجرای Play Games PC SDK را مدیریت می‌کند.

کلاس‌ها

نوع نام توضیحات
Class GooglePlayInitialization نقطه ورود استاتیک برای SDK. شامل متدهایی برای مقداردهی اولیه اتصال به صورت غیرهمزمان.
Class InitializeResult نتیجه عملیات مقداردهی اولیه را نشان می‌دهد.

انوم‌ها

نوع نام توضیحات
Enum InitializationError کدهای خطایی که هنگام مقداردهی اولیه برگردانده می‌شوند (مثلاً SdkRuntimeUnavailable ، SdkRuntimeUpdateRequired ).

فضای نام: PlayPcSdkManaged.Billing

دسترسی به ویژگی‌های پرداخت گوگل پلی، از جمله خریدهای درون برنامه‌ای (IAP) و اشتراک‌ها را فراهم می‌کند.

کلاس‌ها

مشتریان و نتایج

نوع نام توضیحات
Class BillingClient کلاینت اصلی برای تعامل با سرویس صورتحساب. اتصال بومی C++ را مدیریت می‌کند و باید از دسترس خارج شود.
Class QueryProductDetailsResult نتیجه‌ای که توسط QueryProductDetailsAsync برگردانده می‌شود. شامل لیستی از جزئیات محصول در صورت موفقیت است.
Class LaunchPurchaseFlowResult نتیجه‌ای که توسط LaunchPurchaseFlowAsync برگردانده می‌شود. شامل جزئیات خرید در صورت موفقیت‌آمیز بودن آن است.
Class QueryPurchasesResult نتیجه‌ای که توسط QueryPurchasesAsync برگردانده می‌شود. شامل لیستی از خریدهای متعلق به کاربر است.
Class AcknowledgePurchaseResult نتیجه‌ای که توسط AcknowledgePurchaseAsync برگردانده می‌شود.
Class ConsumePurchaseResult نتیجه‌ای که توسط ConsumePurchaseAsync برگردانده می‌شود.

ساختارها

پارامترها و مدل‌ها

نوع نام توضیحات
Struct QueryProductDetailsParams پارامترهای ورودی برای جستجوی جزئیات محصول، شامل فهرست شناسه‌های محصول.
Struct LaunchPurchaseFlowParams پارامترهایی را برای شروع خرید وارد کنید، از جمله OfferToken ، Quantity و شناسه‌های مبهم.
Struct AcknowledgePurchaseParams پارامترهایی را برای تأیید خرید وارد کنید که به PurchaseToken نیاز دارند.
Struct ConsumePurchaseParams پارامترهای ورودی برای مصرف یک خرید، که به PurchaseToken نیاز دارند.
Struct ProductId نشان دهنده شناسه محصول و نوع آن ( InApp یا Subs ) است.
Struct ProductDetails اطلاعات دقیق در مورد یک محصول، شامل عنوان، توضیحات و پیشنهادات موجود.
Struct ProductOffer نشان دهنده یک پیشنهاد قیمت گذاری خاص برای یک محصول، شامل FormattedPrice و OfferToken است.
Struct ProductPurchaseDetails جزئیات یک تراکنش، شامل OrderId ، PurchaseState و PurchaseToken .

انوم‌ها

نوع نام توضیحات
Enum BillingError کدهای وضعیتی که نتیجه عملیات صدور صورتحساب را نشان می‌دهند (مثلاً Ok ، UserCanceled ، ItemAlreadyOwned ).
Enum ProductType نوع محصول را تعریف می‌کند: InApp (1) یا Subs (اشتراک).
Enum PurchaseState وضعیت خرید: Unspecified (0)، Purchased (1) یا Pending (2).

فضای نام: PlayPcSdkManaged.Integrity

دسترسی به API یکپارچگی بازی (Play Integrity API) را برای جلوگیری از سوءاستفاده و شناسایی کلاهبرداری فراهم می‌کند.

کلاس‌ها

مشتریان و نتایج

نوع نام توضیحات
Class IntegrityClient کلاینت اصلی برای تعامل با API یکپارچگی. اتصال بومی C++ را مدیریت می‌کند و باید دور ریخته شود.
Class PrepareIntegrityTokenResult نتیجه‌ای که توسط PrepareIntegrityTokenAsync برگردانده می‌شود.
Class RequestIntegrityTokenResult نتیجه‌ای که توسط RequestIntegrityTokenAsync برگردانده می‌شود. در صورت موفقیت، شامل بایت‌های توکن امضا شده است.

ساختارها (پارامترها و مدل‌ها)

نوع نام توضیحات
Struct PrepareIntegrityTokenParams پارامترهایی را برای مرحله آماده‌سازی وارد کنید که به CloudProjectNumber نیاز دارند.
Struct RequestIntegrityTokenParams پارامترهای ورودی برای مرحله درخواست، که به RequestTokenData و RequestHash نیاز دارند.
Struct RequestTokenData داده‌های میانی که توسط مرحله آماده‌سازی (حاوی WarmUpSessionId ) برگردانده می‌شوند و برای درخواست بعدی مورد نیاز هستند.

انوم‌ها

نوع نام توضیحات
Enum IntegrityError کدهای وضعیتی که نتیجه یک عملیات یکپارچگی را نشان می‌دهند (مثلاً Ok ، CloudProjectNumberIsInvalid ، NetworkError ).

فضای نام: PlayPcSdkManaged.Unity

کمک‌کننده‌ها و آداپتورهای مخصوص یونیتی برای SDK.

کلاس‌ها

نوع نام توضیحات
Class PlayPcSdkFactory کلاس factory که برای ایجاد نمونه‌هایی از BillingClient و IntegrityClient و بازیابی InitializationHandler استفاده می‌شود. این کلاس، تولید callback مخصوص Unity را مدیریت می‌کند.

فضای نام: PlayPcSdkManaged.Core

زیرساخت اصلی بین ماژول‌های SDK مشترک است.

کلاس‌ها

نوع نام توضیحات
Class Result<TError, TValue> کلاس پایه برای تمام نتایج API. ویژگی‌های IsOk ، Code ، ErrorMessage و Value را ارائه می‌دهد.