مسح حمولة QR غير موثوقة وفحصها
التقط حمولة واحدة بأقل تعرض للكاميرا، وافحصها كنص، ثم استخدم validator مناسبًا قبل التنقل أو الاستيراد.
- تشغيل الكاميرا صراحة
- فك رمز واحد
- إيقاف tracks
- فحص النص
- التحقق قبل الفعل
الماسحات
ماسح رمز QR
يمسح رموز QR مباشرة من كاميرا الجهاز باستخدام jsQR محلياً. مفيد للمسح السريع للروابط والبيانات في الوقت الفعلي. يدعم التعرف على多种 أنواع الحمولة.
أدوات QR
camera title
camera description
عدسة ماسح الكاميرا غير متصلة
باختصار
الوصول للكاميرا بإجراء المستخدم: تُفحص الإطارات محليًا ويوقف كل track بعد أول نتيجة ولا تُرفع البكسلات.
ما الذي تدعمه الأداة
- يطلب getUserMedia للفيديو بعد زر التفعيل فقط، ويفضل facingMode environment ولا يطلب الصوت.
- يرسم الإطارات الجاهزة إلى Canvas ويحاول jsQR البكسلات العادية والمعكوسة ويوقف loop وكل tracks بعد أول نتيجة.
- يوفر إيقاف الكاميرا وبديل ملف محلي عند فشل الإذن أو العتاد أو التركيز أو الإضاءة.
- يعرض وينسخ النص، ويوفر رابطًا صريحًا لنص يبدأ http، ويخزن عشرة عناصر سجل اختياريًا.
كيفية استخدام ماسح رمز QR
اتبع سير العمل الخاص بتنفيذ ماسح رمز QR؛ فكل خطوة تعكس عناصر التحكم والحدود الفعلية في مساحة عمل المتصفح.
- 1
الخطوة 1
أدخل المصدر بدقة
افتح في secure context واضغط تفعيل ثم اسمح بالكاميرا عندما تكون مستعدًا فقط.
- 2
الخطوة 2
اختر العملية
وجّه الكاميرا الخلفية نحو رمز كامل بتركيز وإضاءة وتباين وquiet zone.
- 3
الخطوة 3
اضبط الخيارات المتاحة
انتظر أول حمولة؛ عندها تلغى حلقة الإطارات وتتوقف كل tracks.
- 4
الخطوة 4
نفّذ العملية محليًا
راجع القيمة الدقيقة والنوع قبل النسخ أو فتح أي URL صراحةً.
- 5
الخطوة 5
تحقق من النتيجة ثم تابع
استخدم ملف صورة عند فشل البث وامسح السجل الحساس.
الأخطاء الشائعة
توقع الكاميرا على origin غير آمن أو محظور
النتيجة: يحتاج getUserMedia secure context وإذن المتصفح/النظام وقد يكون غير موجود.
الإصلاح: استخدم HTTPS أو localhost موثوقًا واسمح عبر الزر فقط.
فتح أول رابط بلا فحص
النتيجة: قد يخفي QR مضيفًا مضللًا أو مسار اعتماد أو look-alike؛ البادئة ليست أمانًا.
الإصلاح: اقرأ URL وحققه ثم افتح بعد التأكد من scheme والمضيف والنية.
تقريب الرمز أو قصه أو تحريكه تحت وهج
النتيجة: تمنع الحركة والوهج وغياب المساحة والتركيز استعادة الشبكة.
الإصلاح: زد المسافة وثبت الجهاز وحسن الضوء أو استخدم صورة حادة.
أفضل الممارسات
- امنح الإذن للمسح النشط فقط واضغط إيقاف عند الانتهاء.
- افحص المحتوى المجهول كنص وحقق URL أو token أو Wi-Fi أو contact قبل الفعل.
- امسح إذن الموقع والسجل المحلي على جهاز مشترك.
سير العمل المرتبط
قيود المتصفح
- يتطلب getUserMedia وsecure context وإذنًا وعتادًا؛ قد تمنعه iframe أو سياسة المؤسسة.
- تُقرأ إطارات كاملة على main thread مع requestAnimationFrame وقد تستهلك CPU والبطارية.
- أول QR فقط، بلا torch أو zoom أو اختيار كاميرا أو multi-code أو barcode أو confidence.
المراجع الموثوقة
أمثلة عملية
- الإدخال
- إطار كاميرا يحوي WIFI:T:WPA;S:Guest;P:ExamplePass123;;
- النتيجة
- النوع wifi وتتوقف tracks بعد أول فك.
يعيد jsQR النص وتصنف بادئة WIFI: كـwifi؛ لا يحدث اتصال أو تحقق من كلمة المرور.
الأسئلة الشائعة
متى تطلب الصفحة إذن الكاميرا؟
بعد الضغط على تفعيل الماسح فقط؛ لا طلب عند تحميل الصفحة.
هل يرسل الماسح الفيديو إلى خادم؟
لا. يُرسم كل إطار ويُفك داخل الصفحة بلا مسار رفع أو تسجيل.
لماذا توقفت الكاميرا بعد قراءة رمز واحد؟
هذا مقصود لتقليل الاستخدام: تلغى الحلقة وتتوقف كل tracks عند أول نتيجة.
هل أختار كاميرا أو أشغّل المصباح؟
لا. يُفضل environment فقط ولا توجد أجهزة أو zoom أو focus أو torch.
ماذا أفعل إذا رُفض الإذن؟
استخدم ملف صورة حادًا أو صحح إذن الموقع/النظام ثم ابدأ صراحةً من جديد.
الخصوصية والعمل دون اتصال
تُعالج الإطارات والبكسلات محليًا في Canvas ولا تُسجل أو تُرفع. تتوقف tracks عند النتيجة أو زر الإيقاف أو cleanup؛ السجل الاختياري في هذا المتصفح فقط.