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

تسرد هذه الصفحة الفئات والواجهات والبِنى والتعدادات المتاحة في واجهة برمجة التطبيقات (API) الخاصة بحزمة تطوير البرامج (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

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 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 العميل الرئيسي للتفاعل مع خدمة Install Referrer. يدير عملية الربط الأصلية بلغة C++ ويجب التخلّص منه.
Class GetInstallReferrerResult النتيجة التي تعرضها GetInstallReferrerAsync يحتوي على معلومات الإحالة الناجحة.

Structs

النماذج

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

تعدادات

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

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

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

صفوف

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

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

Structs

النماذج

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