نقل البيانات من واجهة برمجة التطبيقات إلى حزمة تطوير البرامج (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 في أقرب وقت ممكن. اتّخِذ الإجراءات المناسبة بشأن رمز الخطأ لتوفير بيئة آمنة لوقت تشغيل لعبتك.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إرسال التطبيق للاختبار

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

حزمة الإرسال

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