Lorixen.
AR

الكاميرا لا تعمل في جلسة الفيديو من موقعك: أخطاء getUserMedia

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

المشكلة كما تصل إلى الاستقبال

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

المطور يرى في السجلات أخطاء متنوعة، والمراجع يرى شاشة سوداء. الفجوة بين الطرفين هي ما يجب سده.

لماذا الأخطاء ليست نوعاً واحداً

توضح MDN أن getUserMedia تطلب من المستخدم إذن استخدام جهاز إدخال وسائط، وتعيد وعداً يتحقق ببث الوسائط عند النجاح. وإن رفض المستخدم الإذن أو لم تتوفر الوسائط المطابقة، يُرفض الوعد بـ NotAllowedError أو NotFoundError على التوالي.

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

دليل الأخطاء الشائعة وما تعنيه

NotAllowedError: بحسب MDN يُرمى هذا الخطأ إذا تعذّر استخدام الجهاز المطلوب في هذا الوقت. ويحدث إذا كانت الصفحة محمّلة عبر HTTP لا HTTPS، أو إذا حدد المستخدم أن هذه الصفحة لا يُسمح لها بالوصول، أو رفض الوصول في الجلسة الحالية، أو رفض الوصول لكل أجهزة الوسائط بشكل عام. وفي المتصفحات التي تدير أذونات الوسائط بسياسة الأذونات Permissions Policy، يظهر أيضاً إن لم تكن السياسة مضبوطة للسماح بالوصول.

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

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

OverconstrainedError: يُرمى إذا لم يوجد جهاز يحقق الشروط المطلوبة، ويحمل الخطأ خاصية constraint باسم الشرط الذي تعذّر تحقيقه. هذا خطأ يصلحه المطور، بتخفيف الشروط.

AbortError: تصفه MDN بأنه مشكلة منعت استخدام الجهاز رغم منح المستخدم والنظام الإذن ورغم عدم وجود خلل في العتاد يسبب NotReadableError.

شرطان على الصفحة قبل أن تصل إلى المراجع

الأول: HTTPS. تذكر MDN أن getUserMedia متاحة فقط في السياقات الآمنة. إن كانت صفحة الجلسة تُفتح عبر HTTP في أي حالة، مثلاً رابط قديم في رسالة تذكير، فسيظهر الخطأ لكل من يفتحها.

الثاني: الإطار المضمّن. إن كانت أداة الفيديو مضمّنة في صفحتك داخل iframe من مزود خارجي، فتوضح MDN أن الإطار لا يستطيع طلب الإذن إلا إذا منحته الصفحة الأم الإذن صراحة عبر سياسة الأذونات، وإلا فلن يُسأل المستخدم أصلاً. ومثال MDN خاصية allow="camera; microphone" على عنصر iframe. هذا من أكثر الأسباب التي تضيع فيها ساعات: المراجع لا يرى أي طلب إذن، ويظن أن جهازه معطل.

مثال توضيحي لرسائل واضحة بالعربية

مثال توضيحي لطريقة تحويل اسم الخطأ إلى رسالة يفهمها المراجع:

try {
  const stream = await navigator.mediaDevices.getUserMedia({ video: true, audio: true });
  startSession(stream);
} catch (err) {
  const msg = {
    NotAllowedError: 'لم يُسمح للصفحة باستخدام الكاميرا أو الميكروفون. اضغط على رمز القفل بجانب العنوان واسمح بهما، ثم أعد تحميل الصفحة.',
    NotFoundError: 'لم نجد كاميرا أو ميكروفوناً في جهازك. جرّب من الجوال أو وصّل سماعة بميكروفون.',
    NotReadableError: 'الكاميرا مستخدمة أو متعذرة الآن. أغلق أي تطبيق آخر يستخدمها ثم حاول مجدداً.'
  }[err.name] || 'تعذّر تشغيل الكاميرا. اتصل بالعيادة لنساعدك.';
  showHelp(msg);
}

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

صفحة «اختبر جهازك» قبل الموعد

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

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

ما يحتاجه فريق الاستقبال

موظفة الاستقبال ليست مطالبة بفهم الأخطاء البرمجية. أعطها ورقة من أربعة أسئلة:

  1. هل تفتح الرابط من الرابط الأصلي في رسالة الحجز؟
  2. هل ظهر لك طلب إذن للكاميرا وماذا اخترت؟
  3. هل هناك تطبيق اجتماعات أو كاميرا مفتوح الآن؟
  4. هل جرّبت صفحة اختبار الجهاز؟

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

أسئلة شائعة

المراجع ضغط «رفض» بالخطأ، كيف يعود؟

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

لماذا لا يظهر طلب الإذن أصلاً؟

من أسبابه الشائعة أن الأداة داخل iframe بلا إذن camera وmicrophone، أو أن الصفحة غير آمنة، أو أن المستخدم رفض سابقاً.

هل أطلب الكاميرا فور فتح الصفحة؟

الأفضل أن تشرح أولاً لماذا تحتاجها، ثم تطلبها عند ضغط زر واضح مثل «ابدأ اختبار الكاميرا».

هل الأخطاء نفسها في كل المتصفحات؟

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

إذا كانت جلسات الفيديو في موقعك تتعثر بسبب الكاميرا والميكروفون، تواصل معنا لنراجع صفحة الجلسة ورسائلها.

المصادر

WhatsAppاحجز مكالمة