تجاوز إلى المحتوى

كيف تضمّن لعبة HTML5 بإذن وحدود واضحة

مثال iframe غير منفّذ مع خطوات لمراجعة الإذن وسياسات الخادم والتحكم ورابط اللعب المباشر البديل.

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

اختر الوجهة المناسبة

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

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

ابدأ بأقل الصلاحيات

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

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

<iframe
  src="https://game.example.com/index.html"
  title="Play your game"
  width="960" height="540"
  style="width: 100%; aspect-ratio: 16 / 9; height: auto; border: 0;"
  loading="lazy"
  allow="fullscreen"
  sandbox="allow-scripts allow-pointer-lock"
></iframe>
<a href="https://game.example.com/index.html">Open the game directly</a>

إذا مُنع عرض الإطار

افحص الرابط المباشر أولًا؛ إذا تعطل بدوره، أصلح تحميل اللعبة قبل الإطار. وإذا عمل خارجه، راجع frame-ancestors ضمن CSP وX-Frame-Options في الوجهة، وسياسة frame-src في الصفحة الحاضنة.

تغيير CORS ليس حلًا عامًا لمشكلات الإطارات. لا تنزع الترويسات أو تستخدم وسيطًا لتجاوز قرار مطوّر آخر. إن لم تكن مخوّلًا بالتحكم، فاحتفظ برابط واضح يفتح اللعبة الأصلية في علامة تبويب جديدة.

اختبر داخل الصفحة الفعلية

افحص تركيز لوحة المفاتيح والدخول في قفل المؤشر والخروج منه وبدء الصوت وأي طلب لملء الشاشة. غيّر حجم الصفحة وتأكد من بقاء التحكم ظاهرًا. نجاح الرابط المباشر لا يثبت أن اللعب داخل الإطار يعمل بالطريقة نفسها.

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

قائمتك

مراجع رسمية

تاريخ مراجعة المراجع: . الغلاف لقطة لعبة منسوبة لمصدرها وليست ناتجًا عن هذا الدليل.

طبّق ما تعلّمته

راجع المعايير التحريرية ثم جهّز مشاركتك. يلزم تسجيل الدخول للإرسال فقط؛ القراءة والتصفح متاحان للجميع.

أرسل لعبة →كيف يعمل