הפניית API

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

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

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

קורסים

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

Structs

סוג	שם	תיאור
Struct	GooglePlayInitializeParams	פרמטרים של אתחול עבור GooglePlayInitialization. מכיל PackageName.

טיפוסים בני מנייה (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	הלקוח העיקרי לאינטראקציה עם השירות Install Referrer. מנהל את החיבור המקורי של 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.