הפניית API

בדף הזה מפורטים המחלקות, הממשקים, המבנים והספירות שזמינים ב-Google Play Games PC SDK for Unity API.

מרחב שמות: PlayPcSdkManaged.Initialization

מטפל במחזור החיים של החיבור בין משחק Unity לבין זמן הריצה של Play Games PC SDK.

קורסים

סוג שם תיאור
Class GooglePlayInitialization נקודת הכניסה הסטטית ל-SDK. מכיל שיטות לאתחול החיבור באופן אסינכרוני.
Class InitializeResult מייצג את התוצאה של פעולת אתחול.

טיפוסים בני מנייה (enum)

סוג שם תיאור
Enum InitializationError קודי שגיאה שמוחזרים במהלך האתחול, כמו SdkRuntimeUnavailable ו-SdkRuntimeUpdateRequired.

מרחב שמות: PlayPcSdkManaged.Billing

השירות מספק גישה לתכונות של חיוב ב-Google Play, כולל רכישות באפליקציה (IAP) ומינויים.

קורסים

לקוחות ותוצאות

סוג שם תיאור
Class BillingClient הלקוח הראשי לאינטראקציה עם שירות החיוב. הוא מנהל את החיבור המקורי של C++‎ וחובה להשמיד אותו.
Class QueryProductDetailsResult התוצאה שמוחזרת על ידי QueryProductDetailsAsync. אם הפעולה מצליחה, התגובה מכילה את רשימת פרטי המוצרים.
Class LaunchPurchaseFlowResult התוצאה שמוחזרת על ידי LaunchPurchaseFlowAsync. הוא מכיל פרטי רכישה במקרה של הצלחה.
Class QueryPurchasesResult התוצאה שמוחזרת על ידי QueryPurchasesAsync. מכיל את רשימת הרכישות שבבעלות המשתמש.
Class AcknowledgePurchaseResult התוצאה שמוחזרת על ידי AcknowledgePurchaseAsync.
Class ConsumePurchaseResult התוצאה שמוחזרת על ידי ConsumePurchaseAsync.

Structs

פרמטרים ומודלים

סוג שם תיאור
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)

סוג שם תיאור
Enum BillingError קודי סטטוס שמייצגים את התוצאה של פעולת חיוב, כמו Ok, UserCanceled ו-ItemAlreadyOwned.
Enum ProductType הגדרה של סוג המוצר: InApp (1) או Subs (מינוי).
Enum PurchaseState מצב הרכישה: Unspecified (0),‏ Purchased (1) או Pending (2).

מרחב שמות: PlayPcSdkManaged.Integrity

גישה ל-Play Integrity API לזיהוי ניצול לרעה והונאה.

קורסים

לקוחות ותוצאות

סוג שם תיאור
Class IntegrityClient הלקוח הראשי לאינטראקציה עם Integrity API. הוא מנהל את החיבור המקורי של C++‎ וחובה להשמיד אותו.
Class PrepareIntegrityTokenResult התוצאה שמוחזרת על ידי PrepareIntegrityTokenAsync.
Class RequestIntegrityTokenResult התוצאה שמוחזרת על ידי RequestIntegrityTokenAsync. מכיל את הבייטים של הטוקן החתום במקרה של הצלחה.

מבנים (פרמטרים ומודלים)

סוג שם תיאור
Struct PrepareIntegrityTokenParams פרמטרים של קלט לשלב ההכנה, שנדרש בהם CloudProjectNumber.
Struct RequestIntegrityTokenParams פרמטרים של קלט לשלב הבקשה, שדורשים RequestTokenData ו-RequestHash.
Struct RequestTokenData נתוני ביניים שמוחזרים משלב ההכנה (כולל WarmUpSessionId) שנדרשים לבקשה הבאה.

טיפוסים בני מנייה (enum)

סוג שם תיאור
Enum IntegrityError קודי סטטוס שמייצגים את התוצאה של פעולת יושרה, כמו Ok, CloudProjectNumberIsInvalid ו-NetworkError.

מרחב שמות: PlayPcSdkManaged.InstallReferrer

ה-API מספק גישה ל-Play Install Referrer API, שמאפשר למשחק לזהות את המקור שהפנה את ההתקנה מחנות Google Play.

קורסים

לקוחות ותוצאות

סוג שם תיאור
Class InstallReferrerClient הלקוח הראשי לאינטראקציה עם שירות המפנה להתקנה. מנהל את החיבור המקורי של C++ וצריך להשמיד אותו.
Class GetInstallReferrerResult התוצאה שמוחזרת על ידי GetInstallReferrerAsync. מכיל את פרטי ההפניה במקרה של הצלחה.

Structs

מודלים

סוג שם תיאור
Struct GetInstallReferrerResultValue מייצג את התוצאה המוצלחת של שאילתה, שמכילה את המחרוזת InstallReferrer ואת InstallTimeEpochSeconds.

טיפוסים בני מנייה (enum)

סוג שם תיאור
Enum InstallReferrerError קודי סטטוס שמייצגים את התוצאה של פעולת הפניה להתקנה, כמו Ok ו-Error.

מרחב שמות: PlayPcSdkManaged.Recall

ההרשאה מספקת גישה ל-Recall API של Google Play Games Services, שמאפשר לקשר בין חשבונות במשחק לבין חשבונות ב-Google Play Games Services.

קורסים

לקוחות ותוצאות

סוג שם תיאור
Class RecallClient הלקוח הראשי לאינטראקציה עם שירות Recall. מנהל את החיבור המקורי של C++‎ וצריך להשמיד אותו.
Class RequestRecallAccessResult התוצאה שמוחזרת על ידי RequestRecallAccessAsync. מכיל את מזהה הסשן של האחזור במקרה של הצלחה.

Structs

מודלים

סוג שם תיאור
Struct RequestRecallAccessResultValue מייצג את התוצאה של בקשת גישה שאושרה, ומכיל את RecallSessionId.

טיפוסים בני מנייה (enum)

סוג שם תיאור
Enum GamesRecallError קודי סטטוס שמייצגים את התוצאה של פעולת ביטול שליחה, כמו Ok ו-Error.

מרחב שמות: PlayPcSdkManaged.Unity

מתאמים ועזרים ספציפיים ל-Unity עבור ה-SDK.

קורסים

סוג שם תיאור
Class PlayPcSdkFactory מחלקת היצרן שמשמשת ליצירת מופעים של BillingClient, IntegrityClient, InstallReferrerClient ו-RecallClient, ולאחזור InitializationHandler. המחלקות האלה מטפלות ביצירת קריאות חוזרות שספציפיות ל-Unity.

מרחב שמות: PlayPcSdkManaged.Core

תשתית ליבה משותפת בין מודולי SDK.

קורסים

סוג שם תיאור
Class Result<TError, TValue> מחלקת הבסיס לכל התוצאות של ה-API. השירות מספק את המאפיינים IsOk,‏ Code,‏ ErrorMessage ו-Value.