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

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

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

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

صفوف

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

البُنى

النوع الاسم الوصف
Struct GooglePlayInitializeParams مَعلمات الإعداد الأوّلي لـ "GooglePlayInitialization" يحتوي على PackageName.

تعدادات

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

البُنى

النماذج

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

تعدادات

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

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

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

صفوف

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

النوع الاسم الوصف
Class RecallClient العميل الرئيسي للتفاعل مع خدمة Recall يدير عملية الربط الأصلية بلغة 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.