‏‎Build‎‏

اختبار لعبة فورية ونشرها ومشاركتها

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

اختبار اللعبة من خادم محلي

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

تمكين SSL عبر مضيف محلي

نظرًا لأن مشغّل الاختبار المضمّن الذي نوفره يعمل ضمن نطاق facebook.com، فإنه لا يمكن توفيره إلا من خلال https. ولكي تتمكن من تضمين محتوى في صفحة يتم توفيرها عبر https، يجب توفير المحتوى المضمّن أيضًا عبر SSL. ستتناول الخطوات التالية عملية إعداد خادم localhost الذي يعرض محتوى آمنًا. نعرض فيما يلي خيارًا واحدًا فقط، إلا أن هناك العديد من الحلول المتاحة لتمكين هذا السلوك.

> $ npm install -g http-server
  • 2. إنشاء مفتاح خاص وشهادة عبر openssl. يُعد ذلك ضروريًا لتشغيل الخادم المحلي الآمن.
> $ cd path/to/my/game/
> $ openssl genrsa 2048 > key.pem
> $ openssl req -x509 -days 1000 -new -key key.pem -out cert.pem
# Fill out necessary information
  • 3. تشغيل اللعبة من مضيف محلي باستخدام SSL. بمجرد أن يصبح المفتاح والشهادة جاهزين، يمكن توفير المحتوى عبر مضيف محلي باستخدام SSL.
# Starts to serve via HTTPS, with cache disabled
> $ http-server --ssl -c-1 -p 8080 -a 127.0.0.1 
Starting up http-server, serving ./ through https
Available on:
https://127.0.0.1:8080
Hit CTRL-C to stop the server
  • 4. بعد الانتهاء من ذلك، يؤدي توجيه المتصفح الذي تستخدمه إلى https://localhost:8080 إلى عرض لعبتك في وضع التشغيل.

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

على سبيل المثال، قد تحتاج على Chrome إلى الوصول إلى chrome://flags/#allow-insecure-localhost وتمكين "السماح بالشهادات غير صالحة للموارد التي يتم تحميلها من المضيف المحلي." للتخلص من التحذير.

تشغيل المشغّل المضمّن من المتصفح

الآن وبعد أن تم توفير اللعبة من المضيف المحلي عبر اتصال آمن، يمكنك تضمينها في المشغّل الذي نوفره. قم بالإشارة إلى المتصفح هنا:

https://www.facebook.com/embed/instantgames/YOUR_GAME_ID/player?game_url=https://localhost:8080

يجب أن تظهر لعبتك في وضع التشغيل في مشغل الألعاب الفورية، على النحو التالي:

ملاحظة:يجب أن تكون قد لعبت اللعبة مرة واحدة على الأقل fb.gg/play/YOUR_GAME_ID لكي يعمل المشغّل المضمّن بشكل سليم.

في هذه المرحلة، يجب أن تكون قادرًا على استخدام كل الميزات الموجودة في مجموعة SDK للألعاب الفورية من اللعبة التي يتم تشغيلها على الخادم المحلي الذي تستخدمه.

ولأسباب أمنية، يُعد localhost هو النطاق الوحيد المدعوم للاختبار باستخدام مشغّل الاختبار المضمّن.

تشغيل اللعبة من الخادم المحلي في محادثة محددة

يمكنك تشغيل اللعبة من الخادم المحلي في سياق محدد. للقيام بذلك، ما عليك سوى استخدام المشغّل المضمّن بالطريقة الموضّحة أعلاه. يمكنك حينها الاستفادة من أساليب FBInstant.context (مثل switchAsync() وcreateAsync() وchooseAsync()) للتبديل إلى سياقات مختلفة.

يتيح لك ذلك إمكانية تشغيل اللعبة بفعالية من localhost في سياق محادثة واختبار ما إذا كانت تحديثات السياق ترسل بشكل صحيح أم لا.

تحميل الإصدار

تجميع لعبتك بالكامل في ملف واحد مضغوط بتنسيق .zip

تتم استضافة محتوى الألعاب الفورية على البنية الأساسية لفيسبوك، ولذلك لست بحاجة إلى استضافة محتوى اللعبة من جانبك أو الاستعانة بخدمات تابعة لجهة خارجية. بمجرد أن تكون اللعبة جاهزة للاختبار، قم بتجميع كل ملفات اللعبة في ملف واحد بتنسيق ‎.zip. يُرجى ملاحظة أنه يجب أن يكون الملف index.html موجودًا في جذر هذا الأرشيف وليس في أي مجلدات فرعية. تتوفر طريقتان لتحميل حزمتك:

1. تحميل الملف المضغوط بتنسيق ‎.zip إلى موقع ويب المطوّر

لتحميل الملف المضغوط بتنسيق ‎.zip، انقر على علامة التبويب استضافة الويب في منتج الألعاب الفورية ضمن لوحة معلومات التطبيق. من هنالك، انقر على تحميل الإصدار وهو الخيار الذي يتيح لك تحميل ملف ‎.zip إلى خدمة الاستضافة التي يوفرها فيسبوك.

بعد هذه الخطوة، يقوم الإصدار بمعالجة الملف، وهي عملية يجب ألا تستغرق سوى ثوانٍ قليلة. عندما تتغير الحالة إلى "جاهز"، يكون التطبيق جاهزًا للإرسال إلى مرحلة الإنتاج!

2. تحميل ملف الأرشيف عبر Graph API

يمكنك، كطريقة بديلة، تحميل حزمة لعبتك عبر استدعاء Graph API. يكون هذا الإجراء مفيدًا إذا كنت تستخدم نظام نشر تلقائي. للقيام بذلك، يجب طلب رمز التحميل من قسم استضافة الويب، عن طريق النقر على الزر الحصول على رمز وصول تحميل الأصل في الجزء العلوي.

باستخدام رمز الوصول الذي حصلت عليه في مربع الحوار، يمكنك إرسال الاستدعاء التالي إلى Graph API لتقديم ملف ‎.zip. يُرجى العلم أننا نستخدم النطاق الفرعي للفيديو، ولكن ذلك مقصود، حيث يتم تكوين عنوان URL ليتمكن من استلام عمليات تحميل كبيرة الحجم.

curl -X POST https://graph-video.facebook.com/{App ID}/assets 
  -F 'access_token={ASSET UPLOAD ACCESS TOKEN}' 
  -F 'type=BUNDLE' 
  -F 'asset=@./{YOUR GAME}.zip' 
  -F 'comment=Graph API upload'

بعد ذلك، يتم عرض لعبتك بالوضع الطبيعي في قائمة الحزم التي تم تحميلها. يمكنك استخدام هذا الاستدعاء للدمج مع نظام الإصدار الحالي الذي تستخدمه.

تقييدات الاستضافة

يُرجى العلم أن هناك مجموعة من التقييدات المرتبطة بالاستضافة على فيسبوك، والتي يعتبر من أهمها ما يلي:

  • المنطق من جهة الخادم (مثل php) غير مدعوم.
  • يجب ألا يتجاوز إجمالي حجم الملفات التي يتم تحميلها 200 ميجابايت.
  • يجب ألا يتجاوز عدد الملفات داخل عملية تحميل التطبيق الواحد 500 ملف.

راجع وثائق استضافة الويب لمزيد من التفاصيل.

اختبار الإصدار الذي تم تحميله

تحويل الإصدار إلى مرحلة الإنتاج

لاختبار التحميل في بيئة إنتاج، يجب أولاً تحضير الإصدار لمرحلة الإنتاج. انقر على الزر "★" لإرسال الإصدار إلى مرحلة الإنتاج.

ملاحظة:

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

ملاحظة: لا تنشئ تطبيقًا اختباريًا للعبتك باستخدام الزر "إنشاء تطبيق اختباري". ويُعد تحضير إصدار اللعبة للاختبار هو الطريقة المتبّعة لاستخدام الألعاب الفورية.

بمجرد توفر الإصدار في مرحلة الإنتاج، احرص دائمًا على اختبار إصدار الإنتاج بدلاً من الإصدار الذي يعمل على خادمك المحلي. يمكنك اختبار إصدار الإنتاج باستخدام أحد الأساليب التالية.

1. تشغيل اللعبة على فيسبوك

لمشاركة اللعبة في الموجز، انقر على الزر مشاركة في قسم مشاركة لعبتك. ويتيح لك هذا الخيار مشاركة اللعبة في الموجز واختبارها من أي جهاز (الكمبيوتر أو نظام iOS أو Android).



2. تشغيل اللعبة على Messenger

في قائمة الألعاب الفورية في Messenger، يجب أن يتوفر لديك ولدى فريقك (الأشخاص الذين تم منحهم أدوار "مسؤول" أو "مطوّر" أو "مختبِر" في تطبيقك) قائمة بكل الألعاب التي لا تزال تحت الإنشاء. يطلق على هذه القائمة اسم قيد التطوير. يساعدكم ذلك في اختبار الألعاب في Messenger حتى وإن لم يكن قد تم نشرها بعد.

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

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

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

الخطوات التالية

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