يجيب هذا المستند عن الأسئلة الشائعة حول حِزم تطوير البرامج (SDK) والنشر في برنامج "ألعاب Google Play على الكمبيوتر".
تحقيق الربح
هل يمكن استخدام مسار الشراء بدون خادم الخلفية؟
من منظور الأمان، تنصح Google باستخدام خادم خلفي.
لمزيد من المعلومات، يُرجى الاطّلاع على المعالجة بدون خادم خلفية.
هل يُسمح باستخدام أنظمة الدفع الحالية المستندة إلى واجهة برمجة التطبيقات بعد تكامل حزمة تطوير البرامج (SDK) لـ "ألعاب Google Play على الكمبيوتر"؟
يجب أن تتم جميع عمليات الدفع من خلال حزمة SDK الخاصة بـ "ألعاب Google Play على الكمبيوتر"، وذلك باستخدام خدمة "الفوترة في Google Play". لا يمكنك استخدام طريقة الدفع الحالية المستندة إلى واجهة برمجة التطبيقات في اللعبة نفسها.
كيف يمكننا استخدام عمليات الشراء في "وضع مطوّر البرامج"؟
يجب استهلاك عملية الشراء في "وضع مطوّر البرامج" في غضون 3 دقائق، وإلا سيتم ردّ الأموال المدفوعة.
هل يمكن إجراء دفعات متكرّرة أو اشتراكات؟
ليس في المستقبل القريب، ولكن يمكنك تقديم حالات استخدام محدّدة لنضيفها إلى خطة تطوير المنتج المستقبلية.
ما هو خطأ الفوترة في مكالمات الشراء؟
BillingError هي استجابة لنتيجة الدفع. ستعرض الدالة LaunchPurchaseFlow النتيجة على الفور بدون حظر، ولكن عليك الانتظار لمعرفة وقت انتهاء العملية والحصول على النتيجة.
كيف يمكنني استخدام ميزة التحقّق من عمليات الشراء من جهة العميل؟
ننصحك باستخدام عملية الشراء من جهة الخادم وعملية إثبات الملكية. تتطلّب معالجة عمليات الشراء من تطبيق العميل أن تكون لعبتك ضمن القائمة المسموح بها. يُرجى التواصل مع شريك Google إذا كانت لعبتك تتطلّب الوصول إلى هذه المعلومات. لمزيد من المعلومات، يُرجى الاطّلاع على المعالجة بدون خادم خلفية.
ما هي الحدود القصوى لطلبات البيانات من واجهة برمجة التطبيقات للاستعلام عن تفاصيل المنتجات؟
الحد الأقصى لعدد المنتجات التي يمكن الاستعلام عنها في طلب واحد إلى واجهة برمجة التطبيقات
QueryProductDetailsهو 50 منتجًا. في حال تجاوزت هذا الحد، عليك تقسيم الطلب إلى عدة طلبات.ما هي المَعلمات المطلوبة عند استدعاء Query Purchases أو Launch Purchase Flow في "مكتبة الفوترة"؟
تقبل الدالة
QueryPurchasesContinuation، وهي دالة ردّ نداء ذات توقيعstd::function<void(QueryPurchasesResult)>. تُرسِل دالة معالجة النتائج النتيجة إليك مع كلProductPurchaseDetails. تتوفّر هذه المعلومات في ملفات عناوين حزمة SDK في الملفincludes/billing/models.h.يحتوي
launch_purchase_flow_resultالناتج على الدالتَينok()وcode(). تعرض الدالةok()ما إذا كان المسار ناجحًا. تعرض الدالةcode()التعدادBillingError(includes/billing/enums.h)، الذي يتضمّن 10 حالات محتملة لحدوث خطأ، مثل إلغاء المستخدم أو حدوث خطأ في الشبكة.هل يمكن استخدام ترتيب مخصّص في Launch Purchase Flow في Billing Client؟
في تصميم حزمة تطوير البرامج (SDK) الحالي، لا يمكن إدخال حمولة خاصة بك. ومع ذلك، يمكنك تقديم أي مجموعة من
obfuscated_account_idوobfuscated_profile_id. يمكنك عدم تقديم أي منهما أو تقديم أحدهما فقط أو كليهما.الحقل
offer_tokenمطلوب ويحدّد عرض الشراء الذي يحاول المستخدم الاستفادة منه في مسار الدفع. في الوقت الحالي، يتضمّن كل رمز تخزين تعريفي (SKU) على Google Play عرضًا واحدًا فقط (على سبيل المثال، شراء منتج واحد مقابل 10 دولار أمريكي). في المستقبل، سيوفّر فريق الفوترة في Play إمكانية الاستفادة من عروض متعددة.لضمان ربط البيانات الوصفية في حال حدوث انقطاعات في مسار الشراء، خزِّن البيانات الوصفية على خادم الخلفية قبل إطلاق مربّع حوار الشراء واربطها برقم تعريف حساب المستخدم ورمز التخزين التعريفي الذي يتم شراؤه والطابع الزمني الحالي. لمزيد من المعلومات، اطّلِع على مقالة ربط عملية شراء بالبيانات الداخلية.
ما هي المتطلبات الأساسية للتبديل من الفوترة في Google باستخدام OAuth إلى الفوترة في Google المستندة إلى ملف DLL؟
يمكن للألعاب مواصلة استخدام ميزة "تسجيل الدخول باستخدام حساب Google" عبر بروتوكول OAuth لإدارة الحساب الذي تم تسجيل الدخول إليه، ولكن تنصح Google بالتوقّف عن استخدام واجهات برمجة التطبيقات القديمة لخدمة الفوترة المستندة إلى REST. يمكن أن يكون التبديل من واجهات برمجة تطبيقات الفوترة المستندة إلى REST (مع تسجيل الدخول باستخدام OAuth2) إلى مسار حزمة تطوير البرامج (SDK) عملية يتم تفعيلها باستخدام علامة ميزة، وبالتالي يمكن أن يتعايش المساران لفترة من الوقت أثناء انتقال اللعبة إلى المسار الجديد.
هل تتم معالجة طلب البيانات من واجهة برمجة التطبيقات Launch Purchase Flow من خلال متصفّح ويب؟
لا، يتم الآن إكمال مسار الشراء بالكامل داخل اللعبة باستخدام تراكب WebView سلس، بدون مغادرة تطبيق اللعبة.
هل على المستخدم تسجيل الدخول بشكل منفصل لكل لعبة لإجراء عملية شراء؟
يتم استخدام حساب المقدّمة في "ألعاب Google Play" لكل جلسة لعب، لذلك لن تحتاج إلى تسجيل الدخول مرة أخرى. الحساب الذي تستخدمه في "ألعاب Google Play" عند بدء جلسة اللعبة هو الحساب الذي يتم إصدار طلبات البيانات من واجهة برمجة التطبيقات منه. سيستخدم مسار الشراء هذا الحساب تلقائيًا.
هل يمكن أن تتوافق إحدى الألعاب مع حزمة تطوير البرامج (SDK) الخاصة بالكمبيوتر وأنظمة الدفع القديمة في الوقت نفسه؟
يعمل نظام الدفع وفقًا لنموذج ثنائي المسار اعتمادًا على إصدار ملف اللعبة الثنائي. سيستمر المستخدمون الذين يستخدمون إصدارات قديمة في اتّباع المسار الحالي، وسيتم نقل المستخدمين الذين يستخدمون إصدارات جديدة إلى نظام الدفع المستند إلى حزمة تطوير البرامج (SDK). يتعايش المستخدمون الذين يتبعون مسارَي الدفع معًا خلال الفترة الانتقالية.
Windows App Bundle
عند إرسال حِزمة تطبيق Windows باستخدام مشغّل تابع لجهة خارجية، هل يجب إرسال حِزمة اللعبة للمراجعة؟
يمكنك إرسال أداة التثبيت فقط، ولن تحتاج إلى إرسال حِزمة اللعبة بأكملها، إذ سيتمكّن المراجع من تنزيل حِزمة اللعبة باستخدام أداة التثبيت.
هل هناك أي قيود على حجم ملف WAB؟
يمكنك تحميل ملف يصل حجمه إلى 10 غيغابايت لتطبيق WAB.
لماذا لا يتم تثبيت لعبتي أو ظهورها بعد تحميل حزمة تطبيق Android (WAB)؟
إذا كانت لعبتك في مرحلة الإعداد بدون توفّر إصدار سابق لها على الكمبيوتر (أي "حزمة تطبيقات Windows للمرة الأولى")، قد يضعها النظام تلقائيًا في حالة تعليق ضمن "النشر المُدار". ويحدث ذلك لأنّه لا توجد مقاييس أساسية حالية لتعديلها. لإصدار حزمة التطبيق القابل للارتداء بالكامل وإتاحة اللعبة للتثبيت، عليك الانتقال إلى Google Play Console وتنفيذ إجراء النشر المطلوب يدويًا (على سبيل المثال، النقر على "نشر التغييرات").
كيف يمكنني تحميل حزمة WAB لإجراء الاختبار الداخلي؟
شارِك حسابات القائمة المسموح بها مع Google كي تتمكّن Google من تفعيلها لإجراء الاختبارات الداخلية. بعد أن تتلقّى Google القائمة، تتأكّد من تضمينها في عملية الإعداد.
أين يجب تحميل حزمة WAB؟
يمكنك تحميل حزمة WAB في الموقع الجغرافي المذكور في السؤال الأول. ومع ذلك، لا يمكنك نشره يدويًا. يجب تزويد موظفي الخلفية في Google بوقت دقيق بالتوقيت العالمي المنسّق (حتى الساعة). بعد ذلك، تحدّد Google الجدول الزمني لإصدار الفيديوهات وتضمن نشره في الوقت المحدّد.
PC SDK
ما هي الاختلافات بين واجهة برمجة التطبيقات القديمة وحزمة تطوير البرامج (SDK) لتطبيق "ألعاب Google Play" على الكمبيوتر؟
- لا توفّر واجهة برمجة التطبيقات القديمة سوى وظيفة الفوترة.
- تتوافق حزمة تطوير البرامج للكمبيوتر مع "خدمة Google للكمبيوتر المكتبي" وكامل الميزات المتاحة على الكمبيوتر.
- لا يلزم استخدام ميزة "تسجيل الدخول باستخدام Google" المستندة إلى المتصفّح مع حزمة تطوير البرامج (SDK) لأجهزة الكمبيوتر.
هل هناك طريقة بديلة لتهيئة حزمة SDK من خلال تشغيل اللعبة مباشرةً باستخدام مشغّل الألعاب، بدون برنامج "ألعاب Google Play على الكمبيوتر"؟
يجب تشغيل لعبتك من خلال برنامج "ألعاب Google Play على الكمبيوتر". لمزيد من التفاصيل، يُرجى الرجوع إلى مستند المطوّرين.
هل تتيح حزمة تطوير البرامج (SDK) لأجهزة الكمبيوتر استخدام أحرف متعددة البايت في ملف شهادة PEM؟
نعم، يتيح حزمة تطوير البرامج (SDK) استخدام أحرف متعددة البايت للحصول على الشهادة.
كيف تعالج حزمة SDK عملية تسجيل الدخول إلى حساب Google في حالات متعددة أو حسابات متعددة؟
يتم التعامل مع كل عملية تشغيل ضمن "ألعاب Google Play" على أنّها "جلسة لعب"، ويمكن ربط حساب بها. ويمكن أن تكون مختلفة. لذا، إذا شغّلت اللعبة باستخدام الحساب "أ"، ثم بدّلت إلى الحساب "ب" وأعدت تشغيل اللعبة، يمكن تشغيل الحسابَين في الوقت نفسه.
هل يعمل دمج واجهة برمجة التطبيقات Play Install Referrer API مع حزمة تطوير البرامج (SDK) لأجهزة الكمبيوتر؟
تتيح حزمة تطوير البرامج (SDK) لأجهزة الكمبيوتر (الإصدار 25.5.409.0 والإصدارات الأحدث) استخدام واجهة برمجة التطبيقات Play Install Referrer API. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة Play Install Referrer API.
مشغِّل التطبيقات
إذا كان أحد اللاعبين يستخدم مشغّلاً تابعًا لجهة خارجية بدلاً من "عميل Google Play"، هل تتم مزامنة حسابه على "خدمات ألعاب Play" تلقائيًا؟
لكي تعمل وظائف حزمة تطوير البرامج (SDK)، يجب تشغيل اللعبة مباشرةً من خلال برنامج "ألعاب Google Play". إذا بدأت عملية أخرى، مثل أداة تثبيت أو تطبيق مشغّل، تشغيل اللعبة، يجب أن يتم تشغيل هذه العملية نفسها من خلال تطبيق "ألعاب Google Play". يجب أن تضبط اللعبة جميع المَعلمات التي تم تلقّيها من العميل ضمن عملية العميل.
كيف يمكنني التعامل مع عملية الإعداد إذا شغّلت "ألعاب Google Play" مشغّل ألعاب تابعًا لجهة خارجية؟
ليس مطلوبًا منك دمج حزمة تطوير البرامج (SDK) مباشرةً في مشغّل التطبيقات. ومع ذلك، يجب تمرير جميع وسيطات سطر الأوامر التي يتلقّاها المشغّل من برنامج ألعاب Google Play مباشرةً إلى العملية الفرعية التي تم إنشاؤها (ملف تنفيذ اللعبة). في حال تعذُّر بدء التشغيل (على سبيل المثال، من خلال عرض
kActionRequiredShutdownClientProcess)، يجب إنهاء جميع العمليات، بما في ذلك المشغّل، حتى تتمكّن "ألعاب Google Play" من محاولة استرداد اللعبة وإعادة تشغيلها تلقائيًا. لمزيد من التفاصيل، يُرجى الاطّلاع على الخطوة 5 في دليل الإعداد.كيف يمكنني التعامل مع التحديثات والصيانة للعبة ومشغّلها بعد طرحهما؟
يجب تنفيذ التحديثات والصيانة اللاحقة من خلال مشغّل التطبيقات. لا يتيح برنامج "ألعاب Google Play" وظائف التحديث، لذا يجب أن يكون المشغّل قادرًا على تحديث كل من اللعبة والمشغّل نفسه.
كيف تتلقّى أداة التثبيت الرمز المميز للجلسة في "ألعاب Google Play" لتفعيل ميزة "التشغيل التلقائي"؟
تُمرِّر أداة GPG الرمز المميز للجلسة باستخدام وسيطة سطر الأوامر
--g_session_token=<token>إلى برنامج التثبيت. لتفعيل هذه الميزة، يجب ضبطacceptsCommandLineArguments="true"فيplay_publishing_config.xml.ويتحمّل برنامج التثبيت مسؤولية استخراج هذا الرمز المميّز واستخدامه لتشغيل اللعبة. في حال تعذُّر إنشاء الرمز المميّز، سيشغّل GPG أداة التثبيت بدون الرمز المميّز (الخيار الاحتياطي).
الإعداد
عند بدء لعبة باستخدام تطبيق "ألعاب Google Play"، هل تتم مزامنة تفاصيل حسابي على Google؟
بعد تشغيل اللعبة من خلال برنامج "ألعاب Google Play"، تتم مزامنة الحساب تلقائيًا، ولن تحتاج إلى تسجيل الدخول إلى Google مرة أخرى.
هل يمكن إعادة استخدام مَعلمات الإعداد عدة مرات؟
ويكون ذلك ممكنًا ما دام تطبيق "ألعاب Google Play" قيد التشغيل ومعلومات تسجيل الدخول صالحة. ومع ذلك، في سيناريوهات مثل السيناريو الموضّح في الدليل، يجب إنهاء جميع العمليات التي تم تشغيلها بواسطة اللعبة عندما يغلق المستخدم اللعبة أو عندما يتم إنهاء اللعبة بسبب تعذُّر تهيئة حزمة SDK، مثل
kActionRequiredShutdownClientProcess.هل هناك أي طريقة لإنشاء اختصار لفتح اللعبة مباشرةً؟
يمكنك استخدام معرّف الموارد المنتظم (URI) التالي لفتح اللعبة مباشرةً:
googleplaygames://launch/?pid=2&id=com.company.gamenameيتيح معرّف الموارد الموحّد (URI) رصد ما إذا كان برنامج "ألعاب Google Play على الكمبيوتر" مفتوحًا. إذا لم يكن عميل ألعاب Google Play مفتوحًا، فسيتم فتحه قبل تشغيل اللعبة أو المشغّل. عليك إدارة اللعبة أو مشغّلها لمنع تشغيل عدة مثيلات.
هل هناك أي طريقة للتحقّق من عملية تثبيت "ألعاب Google Play على الكمبيوتر" بدون استخدام حزمة تطوير البرامج (SDK)؟
يمكنك التحقّق من حالة تثبيت "ألعاب Google Play على الكمبيوتر" بدون دمج حزمة SDK من خلال البحث عن مفتاح سجل Windows التالي:
HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Servicesيشير توفّر هذا المفتاح إلى أنّ خدمات "ألعاب Google Play" (المطلوبة لتشغيل الألعاب على الكمبيوتر) مثبّتة على الجهاز. في حال عدم توفّر المفتاح، عليك توجيه المستخدم إلى صفحة تثبيت "ألعاب Google Play على الكمبيوتر" لتنزيل البرنامج وتثبيته.
الاختبار
هل تتوفّر أي بيئات اختبار مفتوح أو مغلق مشابهة لبيئة الأجهزة الجوّالة؟
على الرغم من عدم توفّر بيئة اختبار شاملة مخصّصة، ندرك حاجة المطوّرين إلى بيئة اختبار شبيهة ببيئة الإنتاج. سنتيح قريبًا حلاً أكثر فعالية.
كيف يمكنني إضافة مختبِرين جدد؟
ينشئ جهة الاتصال في Google مجموعة بريد إلكتروني لكل مشروع في "برنامج التشغيل التجريبي"، ويجب إضافة حسابات المختبِرين على Google إليها. لا يُسمح إلا لأعضاء مجموعة البريد الإلكتروني هذه بتنزيل حِزم الاختبارات من خلال تطبيق "ألعاب Google Play".
متنوعة
هل يمكنني استخدام شبكة VPN؟
بالنسبة إلى المطوّرين الذين يحتاجون إلى اختبار لعبتهم في مناطق لا يتوفّر فيها برنامج "ألعاب Google Play على الكمبيوتر"، ننصح باستخدام شبكة VPN للحصول على عنوان IP من منطقة يتوفّر فيها البرنامج.
تأكَّد من تفعيل وضع TUN على شبكة VPN. يمكنك الاطّلاع على إرشادات حول تفعيل وضع TUN وضبط جدار الحماية في دليل التشغيل الخاص بمزوّد خدمة VPN.
بعد تفعيل وضع TUN، عليك تثبيت برنامج "ألعاب Google Play على الكمبيوتر" والمحاكي لأغراض الاختبار.
كيف يمكنني بدء التطوير لـ "ألعاب Google Play على الكمبيوتر" في Unity أو UE Editor؟
- فعِّل وضع مطوّر البرامج وتابِع عملية الاختبار.
- أضِف الملفَين
manifest.xmlو.dll. لمزيد من المعلومات، يُرجى الاطّلاع على مستند المطوّرين. - سجِّل المعرّف الفريد العالمي (GUID) لشريك برنامج الاستخدام قبل الإطلاق لأغراض الاختبار.
كيف يمكنني استخدام مفاتيح التسجيل بشكل صحيح؟
يجب إنشاء مفاتيح التسجيل استنادًا إلى خلية الجذر. يمكنك ضبط خلية الجذر على
HKEY_LOCAL_MACHINEأوHKEY_CURRENT_USERحسب الغرض وطبيعة البيانات. يتم استخدامHKEY_LOCAL_MACHINEخلية النحل كمثال في الإرشادات.ما هي متطلبات مراجعة حِزم الكمبيوتر الشخصي في Google؟
تخضع حِزم الكمبيوتر لعملية فحص بحثًا عن البرامج الضارة، وبعد ذلك يختبر المراجعون عمليات تثبيت اللعبة وبدء تشغيلها وإلغاء تثبيتها فقط.
هل من الضروري دمج جميع واجهات برمجة التطبيقات؟
لا تكون واجهات برمجة التطبيقات الأخرى مطلوبة، ولكنّها توفّر مزايا إضافية. يجب توفير
google::play::billingلإجراء عمليات شراء داخل التطبيق وبيع المحتوى الرقمي.google::play::install_referrerمطلوبة لتتبُّع بيانات الإحالات الناجحة لمساعدتك في معرفة مصادر الزيارات التي تجذب أكبر عدد من المستخدمين لتنزيل تطبيقك.google::play::games::integrityمطلوبة لحماية تطبيقك من الجهات المسيئة من خلال رصد الأجهزة التي قد تكون محفوفة بالمخاطر والمحاكيات غير المعروفة.لماذا يتم إنهاء بعض عمليات الألعاب عند إغلاق تطبيق "ألعاب Google Play"، بينما لا يتم إنهاء البعض الآخر؟
لا تتحكّم Google في العمليات الفرعية أو عمليات اللعبة قيد التشغيل. ويعتمد السلوك على ما إذا كانت اللعبة هي لعبة Android محاكية أو لعبة كمبيوتر. يتم تثبيت الألعاب المحاكية داخل بيئتها الخاصة، لذا يعتمد سلوكها إلى حد كبير على عملية بدء المحاكي وإيقافه.
هل يجب استخدام ميزة إلغاء تثبيت "ألعاب Google Play" أو أداة إلغاء تثبيت مخصّصة؟
تنصح Google باستخدام إمكانية إلغاء تثبيت تطبيق "ألعاب Google Play".
مساعدة إضافية
إذا كنت بحاجة إلى مزيد من المساعدة غير الموضّحة في هذه الأسئلة الشائعة، يُرجى التواصل معنا على google-play-games-pc@google.com