الأسئلة الشائعة

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

تحقيق الربح

1. لماذا يتعذّر إكمال مسار الشراء ويظهر رمز الخطأ 6 بعد إضافة مفتاح فوترة أو ترخيص جديد؟

   تستغرق مفاتيح الترخيص التي تم إنشاؤها حديثًا في Google Play Console عدة ساعات لتخزينها مؤقتًا ونشرها في نظام التجارة الخلفي قبل أن تتم مزامنة ذاكرات التخزين المؤقت الداخلية في Google Play على جميع بيئات العرض. على الرغم من أنّ عميل لعبتك يمكنه طلب تفاصيل المنتج بنجاح، ستتعذّر طلبات الشراء ويظهر رمز الخطأ 6 إلى أن تكتمل المزامنة. يُرجى الانتظار عدة ساعات بعد تحميل مفتاح الترخيص أو تعديله قبل اختبار عمليات الشراء.

2. هل يمكن استخدام مسار الشراء بدون خادم الخلفية؟

   من منظور الأمان، تنصح Google باستخدام خادم الخلفية.

   لمزيد من المعلومات، يُرجى الاطّلاع على المعالجة بدون خادم خلفية.

   ملاحظة: لمعالجة عمليات الشراء بدون خادم خلفية، يجب أن تتوفّر لديك أذونات خاصة. إذا كانت لعبتك تتطلّب هذه الأذونات، يُرجى التواصل مع شريك Google.

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

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

4. كيف يمكننا استخدام عمليات الشراء في "وضع مطوّر البرامج"؟

   يجب استخدام عملية الشراء في "وضع مطوّر البرامج" في غضون 3 دقائق، وإلا سيتم ردّ الأموال المدفوعة.

5. هل يتم دعم الدفعات المتكرّرة أو الاشتراكات؟

   لا في المستقبل القريب، ولكن يُرجى تقديم حالات استخدام محدّدة لنضيفها إلى خارطة الطريق المستقبلية.

6. ما هو خطأ الفوترة في طلبات الشراء؟

   BillingError هي استجابة لنتيجة الدفع. ستعرض الدالة LaunchPurchaseFlow النتيجة على الفور بدون حظر، ولكن عليك الانتظار لمعرفة وقت انتهاء العملية والحصول على النتيجة.

7. كيف يمكنني استخدام ميزة التحقّق من عمليات الشراء من جهة العميل؟

   ننصح باستخدام عملية الشراء من جهة الخادم وعملية التحقّق منها. تتطلّب معالجة عمليات الشراء من تطبيق العميل أن تكون لعبتك مدرَجة في قائمة السماح. يُرجى التواصل مع شريك Google إذا كانت لعبتك تتطلّب الوصول إلى هذه الميزة. لمزيد من المعلومات، يُرجى الاطّلاع على المعالجة بدون خادم خلفية.

8. ما هي الحدود القصوى لواجهة برمجة التطبيقات لطلب تفاصيل المنتج؟

   الحد الأقصى لعدد المنتجات التي يمكن طلبها في طلب واحد من واجهة برمجة التطبيقات QueryProductDetails هو 50 منتجًا. وفي حال تجاوزت هذا الحد، عليك تقسيم الطلب إلى طلبات متعددة.

9. ما هي المَعلمات المطلوبة عند استدعاء Query Purchases أو Launch Purchase Flow في Billing Client؟

   تقبل الدالة 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 حالات خطأ محتملة، مثل إلغاء المستخدم أو خطأ في الشبكة.

10. هل يتم دعم ترتيب مخصّص لمسار الشراء في Billing Client؟

    في تصميم حزمة تطوير البرامج (SDK) الحالية، لا يمكن إرسال حمولة خاصة بك. ومع ذلك، يمكنك تقديم أي مجموعة من obfuscated_account_id وobfuscated_profile_id. يمكنك عدم تقديم أي منهما أو تقديم أحدهما أو كليهما.

    الحقل offer_token مطلوب ويحدّد عرض الشراء الذي يحاول المستخدم شراؤه في مسار الدفع. في الوقت الحالي، يتضمّن كل رمز SKU في Google Play عرضًا واحدًا فقط (على سبيل المثال، شراء منتج واحد مقابل 10 دولارات أمريكية). في المستقبل، سيقدّم فريق "الفوترة في Play" دعمًا لعروض متعددة.

    لضمان ربط البيانات الوصفية في حال حدوث انقطاعات في مسار الشراء، عليك تخزين البيانات الوصفية على خادم الخلفية قبل بدء مربّع حوار الشراء وربطها برقم تعريف حساب المستخدم ورمز SKU الذي يتم شراؤه والطابع الزمني الحالي. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ربط عملية شراء ببيانات داخلية.

11. ما هي المتطلبات الأساسية للتبديل من "الفوترة في Google" باستخدام OAuth إلى "الفوترة في Google" المستندة إلى ملف DLL؟

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

12. هل تتم معالجة طلب بيانات من واجهة برمجة التطبيقات لمسار الشراء من خلال متصفّح ويب؟

    لا، يتم الآن إكمال مسار الشراء بالكامل داخل اللعبة باستخدام طبقة WebView سلسة، بدون مغادرة عميل اللعبة.

13. هل على المستخدم تسجيل الدخول بشكل منفصل لكل لعبة لإجراء عملية شراء؟

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

14. هل يمكن أن تدعم اللعبة حزمة تطوير البرامج (SDK) للكمبيوتر وأنظمة الدفع القديمة في الوقت نفسه؟

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

Windows App Bundle

1. عند إرسال حزمة تطبيق Windows باستخدام مشغّل تابع لجهة خارجية، هل يجب إرسال حزمة اللعبة للمراجعة؟

   يمكنك إرسال أداة التثبيت فقط ولست بحاجة إلى إرسال حزمة اللعبة بالكامل، وسيتمكّن المراجع من تنزيل حزمة اللعبة باستخدام أداة التثبيت.

   **ملاحظة:** هذه الإرشادات مخصّصة للمطوّرين الذين يستخدمون مشغّلًا تابعًا لجهة خارجية لتشغيل لعبتك.

2. هل هناك أي قيود على حجم ملف حزمة تطبيق Windows؟

   يمكنك تحميل ملف يصل حجمه إلى 10 غيغابايت لحزمة تطبيق Windows.

3. لماذا لا يتم تثبيت لعبتي أو ظهورها بعد تحميل حزمة تطبيق Windows؟

   إذا كانت لعبتك يتم إعدادها بدون إصدار سابق على الكمبيوتر (حزمة تطبيق Windows لأول مرة)، قد يضعها النظام تلقائيًا في حالة الانتظار للنشر المُدار. يحدث ذلك لأنّه لا توجد قاعدة أساسية حالية لتعديلها. لإصدار حزمة تطبيق Windows بالكامل وإتاحة اللعبة للتثبيت، عليك الانتقال إلى Google Play Console وتنفيذ إجراء النشر المطلوب يدويًا (على سبيل المثال، النقر على "نشر التغييرات").

4. كيف يمكنني تحميل حزمة تطبيق Windows للاختبار الداخلي؟

   يُرجى مشاركة حسابات قائمة السماح مع Google لكي تتمكّن Google من تفعيلها للاختبار الداخلي. بعد أن تحصل Google على القائمة، تتأكّد من تضمينها في عملية الإعداد.

5. أين يجب تحميل حزمة تطبيق Windows؟

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

حزمة تطوير البرامج (SDK) للكمبيوتر

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

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

2. هل هناك طريقة بديلة لتهيئة حزمة SDK من خلال تشغيل اللعبة مباشرةً باستخدام مشغّل الألعاب، بدون برنامج "ألعاب Google Play على الكمبيوتر"؟

   يجب تشغيل لعبتك من خلال برنامج "ألعاب Google Play على الكمبيوتر". لمزيد من التفاصيل، يُرجى الرجوع إلى مستند المطوّرين هذا.

3. هل تتوافق حزمة تطوير البرامج (SDK) للكمبيوتر مع الأحرف المتعددة البايتات في ملف شهادة PEM؟

   نعم، تتوافق حزمة تطوير البرامج (SDK) مع الأحرف المتعددة البايتات للشهادة.

4. كيف تتعامل حزمة تطوير البرامج (SDK) مع ميزة "تسجيل الدخول باستخدام حساب Google" لعدة مثيلات أو حسابات؟

   يتم التعامل مع كل عملية تشغيل ضمن "ألعاب Google Play" على أنّها "جلسة لعب"، ويمكن ربط حساب بها. يمكن أن تكون الحسابات مختلفة. لذا، إذا شغّلت اللعبة باستخدام الحساب "أ"، ثم بدّلت إلى الحساب "ب" وأعدت تشغيل اللعبة، يمكن تشغيل الحسابَين في الوقت نفسه.

5. هل تتوافق عملية دمج Play Install Referrer مع حزمة تطوير البرامج (SDK) للكمبيوتر؟

   تتوافق حزمة تطوير البرامج (SDK) للكمبيوتر (الإصدار 25.5.409.0 والإصدارات الأحدث) مع واجهة برمجة التطبيقات Play Install Referrer API. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة Play Install Referrer API.

مشغِّل التطبيقات

1. إذا استخدم أحد اللاعبين مشغّلًا تابعًا لجهة خارجية بدلاً من عميل Google Play، هل ستتم مزامنة حسابه على "خدمات ألعاب Play" تلقائيًا؟

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

2. كيف يمكنني التعامل مع عملية الإعداد إذا شغّل برنامج "ألعاب Google Play" مشغّل ألعاب تابعًا لجهة خارجية؟

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

3. كيف يمكنني التعامل مع التحديثات والصيانة للعبة والمشغّل بعد طرحهما؟

   يجب تنفيذ التحديثات والصيانة اللاحقة من خلال المشغّل. لا يتيح برنامج "ألعاب Google Play" وظائف التحديث، لذا يجب أن يكون المشغّل قادرًا على تحديث كل من اللعبة والمشغّل نفسه.

4. كيف تتلقّى أداة التثبيت الرمز المميز لجلسة خدمات ألعاب Google Play لميزة "التشغيل التلقائي"؟

   يمرّر برنامج "ألعاب Google Play" الرمز المميز للجلسة إلى أداة التثبيت باستخدام وسيطة سطر الأوامر --g_session_token=<token>. لتفعيل هذه الميزة، عليك ضبط acceptsCommandLineArguments="true" في ملف play_publishing_config.xml.

   أداة التثبيت مسؤولة عن استخراج هذا الرمز واستخدامه لتشغيل اللعبة. إذا تعذّر إنشاء الرمز، يشغّل برنامج "ألعاب Google Play" أداة التثبيت بدون الرمز (الإجراء الاحتياطي).

الإعداد

1. عند بدء لعبة باستخدام برنامج "ألعاب Google Play"، هل تتم مزامنة تفاصيل حسابي على Google؟

   بعد تشغيل اللعبة من خلال برنامج "ألعاب Google Play"، تتم مزامنة الحساب تلقائيًا، ولن تحتاج إلى تسجيل الدخول إلى Google مرة أخرى.

2. هل يمكن إعادة استخدام مَعلمات الإعداد عدة مرات؟

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

3. هل هناك أي طريقة لإنشاء اختصار لفتح اللعبة مباشرةً؟

   يمكنك استخدام URI التالي لفتح اللعبة مباشرةً:

   googleplaygames://launch/?pid=2&id=com.company.gamename

   يتيح URI رصد ما إذا كان برنامج "ألعاب Google Play على الكمبيوتر" مفتوحًا. إذا لم يكن برنامج ألعاب Google Play مفتوحًا، يتم فتحه قبل تشغيل اللعبة أو المشغّل. عليك إدارة اللعبة أو المشغّل لمنع تشغيل عدة مثيلات.

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

   يمكنك التحقّق من حالة تثبيت "ألعاب Google Play على الكمبيوتر" بدون دمج حزمة تطوير البرامج (SDK) من خلال التحقّق من وجود مفتاح "سجلّ Windows" التالي:

   HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

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

الاختبار

1. هل تتوفّر أي بيئات اختبار مفتوح أو مغلق مشابهة لبيئات الأجهزة الجوّالة؟

   على الرغم من عدم توفّر بيئة وضع الحماية مخصّصة وشاملة، ندرك حاجة المطوّرين إلى بيئة اختبار مشابهة لبيئة الإنتاج. سيتوفّر حل أكثر فعالية قريبًا.

2. كيف يمكنني إضافة مختبِرين جدد؟

   ينشئ جهة الاتصال في Google مجموعة بريد إلكتروني لكل مشروع على الكمبيوتر، ويجب إضافة حسابات Google الخاصة بالمختبِرين إليها. لا يُسمح إلا لأعضاء مجموعة البريد الإلكتروني هذه بتنزيل حِزم الاختبار ضمن "ألعاب Google Play".

متنوعة

1. هل يمكنني استخدام شبكة VPN؟

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

   تأكَّد من تفعيل وضع TUN على شبكة VPN. يمكنك العثور على إرشادات حول تفعيل وضع TUN وضبط جدار الحماية في دليل تشغيل شبكة VPN.

   بعد تفعيل وضع TUN، عليك تثبيت برنامج "ألعاب Google Play على الكمبيوتر" و الـ محاكي لأغراض الاختبار.

2. كيف يمكنني بدء التطوير لـ "ألعاب Google Play على الكمبيوتر" في Unity أو UE Editor؟

   • فعِّل وضع مطوّر البرامج وتابِع عملية الاختبار.
   • أضِف ملفَي manifest.xml و.dll. لمزيد من المعلومات، يُرجى الاطّلاع على مستند المطوّرين.
   • سجِّل المعرّف الفريد العالمي (GUID) لشريك برنامج الاستخدام قبل الإطلاق لأغراض الاختبار.

3. كيف يمكنني استخدام مفاتيح "سجلّ Windows" بشكل صحيح؟

   عليك إنشاء مفاتيح "سجلّ Windows" استنادًا إلى الخلية الجذرية. يمكنك ضبط الخلية الجذرية على HKEY_LOCAL_MACHINE أو HKEY_CURRENT_USER استنادًا إلى الغرض من البيانات وطبيعتها. يتم استخدام الخلية HKEY_LOCAL_MACHINE كمثال في الإرشادات.

4. ما هي متطلبات مراجعة Google لحِزم الكمبيوتر؟

   تخضع حِزم الكمبيوتر لعملية فحص بحثًا عن البرامج الضارة، وبعد ذلك يختبر المراجعون عمليات تثبيت اللعبة وبدء تشغيلها وإلغاء تثبيتها بنجاح فقط.

5. هل من الضروري دمج جميع واجهات برمجة التطبيقات؟

   ليست هناك حاجة إلى واجهات برمجة التطبيقات الأخرى، ولكنها تقدّم مزايا إضافية. تُعدّ google::play::billing مطلوبة لعمليات الشراء داخل التطبيق وبيع المحتوى الرقمي. تُعدّ google::play::install_referrer مطلوبة لتتبُّع بيانات الإحالة لمساعدتك في فهم مصادر الزيارات التي تجذب أكبر عدد من المستخدمين لتنزيل تطبيقك. وتُعدّ google::play::games::integrity مطلوبة لحماية تطبيقك من الجهات السيئة من خلال رصد الأجهزة التي قد تكون محفوفة بالمخاطر والمحاكيات غير المعروفة.

6. لماذا يتم إنهاء بعض عمليات اللعبة عند إغلاق برنامج "ألعاب Google Play"، بينما لا يتم إنهاء عمليات أخرى؟

   لا تتحكّم Google في العمليات الفرعية أو عمليات اللعبة قيد التشغيل. يعتمد السلوك على ما إذا كانت اللعبة لعبة Android محاكاة أو لعبة كمبيوتر. يتم تثبيت الألعاب المحاكاة داخل بيئتها الخاصة، لذا يعتمد سلوكها إلى حد كبير على عملية إعداد المحاكي وإيقافه.

7. هل عليّ استخدام إمكانية إلغاء تثبيت "ألعاب Google Play" أو أداة إلغاء تثبيت مخصّصة؟

   تنصح Google باستخدام إمكانية إلغاء تثبيت "ألعاب Google Play".

مساعدة إضافية

إذا كنت بحاجة إلى مزيد من المساعدة غير المشمولة في هذه الأسئلة الشائعة، يُرجى التواصل مع [e-mail].