הפניית 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

הגישה ל-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.