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

تعرض هذه الصفحة قائمة بالفئات والواجهات والبِنى والتعدادات المتوفّرة في 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.