مرجع واجهة برمجة تطبيقات

تعرض هذه الصفحة قائمة بالفئات والواجهات والبِنى والتعدادات المتوفّرة في Google Play Games PC SDK for Unity API.

مساحة الاسم: PlayPcSdkManaged.Initialization

تتعامل هذه المساحة مع دورة حياة الاتصال بين لعبة Unity ووقت تشغيل حزمة تطوير البرامج (SDK) لألعاب Play على الكمبيوتر الشخصي.

صفوف

النوع	الاسم	الوصف
Class	GooglePlayInitialization	نقطة الإدخال الثابتة لحزمة تطوير البرامج (SDK) تحتوي على طُرق لتهيئة الاتصال بشكل غير متزامن.
Class	InitializeResult	تمثّل نتيجة عملية تهيئة.

تعدادات

النوع	الاسم	الوصف
Enum	InitializationError	رموز الخطأ التي يتم عرضها أثناء التهيئة، مثل SdkRuntimeUnavailable وSdkRuntimeUpdateRequired.

مساحة الاسم: PlayPcSdkManaged.Billing

توفّر هذه المساحة إمكانية الوصول إلى ميزات "الفوترة في Google Play"، بما في ذلك عمليات الشراء داخل التطبيق والاشتراكات.

صفوف

العملاء والنتائج

النوع	الاسم	الوصف
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

توفّر هذه المساحة إمكانية الوصول إلى 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	IntegrityError	رموز الحالة التي تمثّل نتيجة عملية التحقّق من التكامل، مثل Ok وCloudProjectNumberIsInvalid وNetworkError

مساحة الاسم: PlayPcSdkManaged.InstallReferrer

توفّر هذه المساحة إمكانية الوصول إلى Play Install Referrer API، ما يسمح للعبتك بتحديد المصدر الذي أحال عملية التثبيت من "متجر Google Play".

صفوف

العملاء والنتائج

النوع	الاسم	الوصف
Class	InstallReferrerClient	العميل الرئيسي للتفاعل مع خدمة "المُحيل لعملية التثبيت" يدير الاتصال الأصلي بلغة C++ ويجب التخلّص منه.
Class	GetInstallReferrerResult	النتيجة التي تعرضها الدالة GetInstallReferrerAsync تحتوي على معلومات الإحالة في حال النجاح.

بِنى

النماذج

النوع	الاسم	الوصف
Struct	GetInstallReferrerResultValue	تمثّل النتيجة الناجحة لطلب بحث، والتي تحتوي على السلسلة InstallReferrer وInstallTimeEpochSeconds

تعدادات

النوع	الاسم	الوصف
Enum	InstallReferrerError	رموز الحالة التي تمثّل نتيجة عملية "المُحيل لعملية التثبيت"، مثل Ok وError

مساحة الاسم: PlayPcSdkManaged.Recall

توفّر هذه المساحة إمكانية الوصول إلى Play Games Services Recall API، ما يسمح لك بربط الحسابات داخل اللعبة بحسابات "خدمات ألعاب Google Play".

صفوف

العملاء والنتائج

النوع	الاسم	الوصف
Class	RecallClient	العميل الرئيسي للتفاعل مع خدمة "الاستدعاء" يدير الاتصال الأصلي بلغة C++ ويجب التخلّص منه.
Class	RequestRecallAccessResult	النتيجة التي تعرضها الدالة RequestRecallAccessAsync تحتوي على معرّف جلسة "الاستدعاء" في حال النجاح.

بِنى

النماذج

النوع	الاسم	الوصف
Struct	RequestRecallAccessResultValue	تمثّل النتيجة الناجحة لطلب الوصول، والتي تحتوي على RecallSessionId

تعدادات

النوع	الاسم	الوصف
Enum	GamesRecallError	رموز الحالة التي تمثّل نتيجة عملية "الاستدعاء"، مثل Ok وError

مساحة الاسم: PlayPcSdkManaged.Unity

مساعدون ومحوّلات خاصة بـ Unity لحزمة تطوير البرامج (SDK)

صفوف

النوع	الاسم	الوصف
Class	PlayPcSdkFactory	فئة المصنع المستخدَمة لإنشاء مثيلات من BillingClient وIntegrityClient وInstallReferrerClient وRecallClient، ولاسترداد InitializationHandler تتعامل هذه الفئة مع إنشاء معاودة الاتصال الخاصة بـ Unity.

مساحة الاسم: PlayPcSdkManaged.Core

البنية الأساسية المشترَكة بين وحدات حزمة تطوير البرامج (SDK)

صفوف

النوع	الاسم	الوصف
Class	Result<TError, TValue>	الصنف الأساسي لجميع نتائج واجهة برمجة التطبيقات توفّر الخصائص IsOk وCode وErrorMessage وValue.