نقل البيانات من واجهة برمجة التطبيقات إلى حزمة تطوير البرامج (SDK)

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

بناءً على محرّك الألعاب الذي تستخدمه، يمكنك دمج C++ SDK أو الـ C# SDK. راجِع المشاريع النموذجية التي تعرض أمثلة يمكن استخدامها لنقل لعبتك الأصلية إلى حزمة تطوير البرامج (SDK).

الإعداد والتحضير

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

وسيطات سطر الأوامر

تعتمد حزمة تطوير البرامج (SDK) الأصلية لتطبيق "ألعاب Google Play على الكمبيوتر" على بعض وسيطات سطر الأوامر التي يتم تمريرها أثناء بدء عملية لعبتك لمصادقة المستخدمين. يجب تمرير هذه الوسيطات إلى العملية التي تستدعي Initialize SDK. إذا كان بدء تشغيل لعبتك يتضمّن عمليات متعدّدة، عليك التأكّد من تمرير جميع الوسيطات إلى العملية التي تستخدم حزمة تطوير البرامج (SDK) في النهاية. راجِع خطوة دعم عمليات الألعاب المتعدّدة في عملية الإعداد.

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

لإكمال عملية نقل البيانات، عليك إزالة جميع طلبات واجهة برمجة التطبيقات المباشرة إلى خوادم Play. تتوفّر استدعاءات وظائف مقابلة في حزمة تطوير البرامج (SDK) لتحقيق الوظيفة نفسها. يسرد هذا القسم عملية الربط لكل وظيفة.

ميزة "تسجيل الدخول باستخدام حساب Google"

ميزة "تسجيل الدخول باستخدام حساب Google"، المعروفة أيضًا باسم تسجيل الدخول باستخدام حساب Google، هي طريقة مصادقة OAuth توفّر خيار مصادقة بنقرة واحدة للمستخدمين الذين لديهم حساب Google. في المشاريع المستندة إلى واجهة برمجة التطبيقات، يمكنك ربط حساب اللاعب بعمليات الشراء التي يجريها. لا تتطلّب الحلول المستندة إلى حزمة تطوير البرامج (SDK) هذا الربط.

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

بدلاً من ميزة "تسجيل الدخول باستخدام حساب Google"، استدعِ Initialize SDK في أقرب وقت ممكن. اتّخِذ إجراءً بشأن رمز الخطأ وفقًا لذلك لتوفير بيئة آمنة لوقت تشغيل لعبتك.

الحصول على قائمة المنتجات

في الحلّ المستند إلى واجهة برمجة التطبيقات، يستردّ خادم الخلفية قائمة المنتجات باستخدام نقطة نهاية Play Developer API inappproduct.gets.

في حزمة تطوير البرامج (SDK)، استردّ قائمة المنتجات داخل التطبيق مباشرةً على العميل باستخدام الدالة QueryProductDetails.

تحقيق عمليات شراء

في الحلّ المستند إلى واجهة برمجة التطبيقات، يستردّ خادم الخلفية عمليات شراء المستخدمين باستخدام نقطة نهاية Play Developer API purchases.products.get.

في حزمة تطوير البرامج (SDK)، استخدِم الدالة QueryPurchases مباشرةً من برنامج لعبتك.

بدء مسار الشراء

في الحلّ المستند إلى واجهة برمجة التطبيقات، يتطلّب بدء مسار الشراء استدعاء نقاط نهاية متعدّدة للإعداد والحصول على الرموز المميّزة اللازمة.

في حزمة تطوير البرامج (SDK)، ابدأ العملية من خلال استدعاء الدالة BillingClient's LaunchPurchaseFlow. تتولّى حزمة تطوير البرامج (SDK) جميع المهام اللازمة.

معالجة عملية الشراء

تتضمّن معالجة عملية شراء المستخدم الإقرار بعملية الشراء واستخدامها بعد التحقّق بنجاح من أنّها مشروعة. يقدّم كلّ من الحلّ المستند إلى واجهة برمجة التطبيقات والحلّ المستند إلى حزمة تطوير البرامج (SDK) الخطوات التي يجب إكمالها من خادم الخلفية لأغراض أمنية.

تكون العملية متشابهة لكلّ من الحلّ المستند إلى واجهة برمجة التطبيقات والحلّ المستند إلى حزمة تطوير البرامج (SDK):

بعد استرداد purchaseToken من عملية الشراء، مثل ProductPurchase.purchaseToken في الحلّ المستند إلى واجهة برمجة التطبيقات أو ProductPurchaseDetails's purchase_token في الحلّ المستند إلى حزمة تطوير البرامج (SDK)، أرسِله إلى خادم الخلفية لإجراء التحقّق.

بعد التحقّق منه، يمكن لخادم الخلفية الإقرار بعملية الشراء أو استخدامها بأمان بعد منح الاستحقاق.

الإرسال للاختبار

لإرسال لعبتك للاختبار، اتّبِع الخطوات التالية.

تجميع اللعبة لإرسالها

يجب تجميع الألعاب التي تستخدم حزمة تطوير البرامج (SDK) بتنسيق Windows App Bundle وتحميلها من خلال Play Console. راجِع المستندات لتجميع لعبتك في Windows App Bundle من أجل: