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