Lorixen.
AR

عنوان الدرس وأزرار التحكم على شاشة القفل: Media Session

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

المستمع لا ينظر إلى صفحتك

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

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

ما الذي تقدمه Media Session

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

  • MediaMetadata: بيانات وصفية غنية للمحتوى الذي يُشغَّل: العنوان، واسم الفنان أو المؤلف، والمجموعة أو الألبوم، وصور الغلاف، ومعلومات الفصول. وتذكر MDN أن النظام يمكن أن يعرض هذه البيانات في مراكز الوسائط والإشعارات وشاشات القفل وغيرها.
  • MediaSession: تتيح للمستخدم التحكم في التشغيل عبر عناصر يعرضها المتصفح أو النظام، والضغط عليها يستدعي معالجات أحداث في صفحتك.

والوصول إلى الواجهة يتم عبر navigator.mediaSession، لا بإنشاء نسخة جديدة منها.

العنوان والصورة

navigator.mediaSession.metadata = new MediaMetadata({
  title: 'الدرس 7: في السوق',
  artist: 'مستوى المبتدئين',
  album: 'دروس الاستماع',
  artwork: [{ src: '/covers/listening-512.png', sizes: '512x512', type: 'image/png' }]
});

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

الصورة تستحق الاهتمام: استخدم صورة مربعة بحجم كافٍ، بشعارك أو بغلاف السلسلة، ويمكن تقديم أكثر من حجم في القائمة ليختار النظام المناسب.

الأزرار وما تفعله

تعرض وثائق MDN أمثلة لمعالجات الأحداث: play وpause وstop وseekbackward وseekforward وseekto وprevioustrack وnexttrack، وغيرها. لكل منها تسجل دالة بـ setActionHandler:

  • seekbackward وseekforward: للرجوع أو التقديم بعدد ثوانٍ تختاره. في دروس اللغة، عشر ثوانٍ للخلف هي الزر الأهم.
  • previoustrack وnexttrack: للانتقال بين الدروس أو الحلقات، إذا كانت لديك قائمة تشغيل.
  • seekto: للانتقال إلى موضع محدد، عندما يسحب المستخدم المؤشر في شاشة القفل.

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

حالة التشغيل

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

العربية في شاشة القفل

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

أين تفيد غير دروس اللغة

  • مراكز تحفيظ القرآن التي تنشر تلاوات للمراجعة.
  • مواقع الجولات الصوتية في المتاحف والمواقع السياحية.
  • البودكاست الذي ينشره نشاطك على موقعه بدل منصة خارجية.
  • المحاضرات المسجلة في مراكز التدريب.
  • مقاطع التأمل أو التمارين الموجهة في مراكز اللياقة.

ما لا تفعله الواجهة

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

تذكر موضع المستمع

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

مثال توضيحي: مركز لغات ودروس الاستماع

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

أسئلة شائعة

ليش شاشة القفل بتطلع اسم الموقع بدل عنوان الدرس؟

لأن الصفحة لم ترسل بيانات وصفية. أضف MediaMetadata بالعنوان والمؤلف والصورة عند تشغيل كل مقطع.

كيف أخلي زر الرجوع يرجع عشر ثواني؟

سجّل معالجاً للحدث seekbackward بـ setActionHandler، يرجع موضع التشغيل بالمقدار الذي تريده.

لازم أعمل تطبيق عشان هالشي؟

لا. Media Session واجهة في المتصفح يستخدمها موقعك مباشرة.

الصوت بيوقف لما أقفل الشاشة، بتحل المشكلة؟

لا. الواجهة تصف المحتوى وتستقبل الأوامر، أما استمرار الصوت فيعتمد على المتصفح والنظام.

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

المصادر

WhatsAppاحجز مكالمة