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

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

البُنى

النماذج

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

تعدادات

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

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

توفّر إمكانية الوصول إلى Recall API في "خدمات ألعاب Google 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.