نقل البيانات من واجهة برمجة التطبيقات إلى حزمة تطوير البرامج (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 من أجل: