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

تسرد هذه الصفحة الفئات والواجهات والبِنى والتعدادات المتاحة في واجهة برمجة التطبيقات الخاصة بحزمة تطوير البرامج (SDK) لتطبيق "ألعاب Google Play" على الكمبيوتر لنظام Unity.

مساحة الاسم: 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.Unity

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

صفوف

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

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

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

صفوف

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