دليل مستخدم أداة التحقّق من صحة WebRTC

نظرة عامة

أداة التحقّق من WebRTC هي أداة مستندة إلى الويب تهدف إلى محاكاة مشغّل WebRTC المتاح على شاشات Google الذكية التي تعمل بنظام التشغيل Google Assistant. يستفيد تطبيق الويب هذا من WebRTC API المتاحة داخل المتصفّحات الحديثة. بشكل عام، أداة التحقّق من WebRTC هي مشارك WebRTC يمكنك البث منه أو إليه.

الانتقال إلى أداة التحقّق من WebRTC

تخصيص خادم STUN/TURN

تستخدم أداة التحقّق من WebRTC خادم Google STUN تلقائيًا. يمكن لأداة التحقّق من WebRTC استخدام خادم STUN/TURN يحدّده المستخدم.

إضافة خادم STUN/TURN

1. ضَع عنوان خادم STUN أو TURN في مربّع نص STUN أو TURN URI. تأكَّد من أنّ مخطّط URI بالتنسيق التالي scheme:host:[port]. تستخدم الأداة تلقائيًا stun:stun.l.google.com:19302
2. (اختياري) إذا كنت تستخدِم خادم TURN، سيُطلب منك إدخال بيانات الاعتماد في مربّعَي النص اسم مستخدم TURN وكلمة مرور TURN.
3. انقر على إضافة خادم لإضافة تفاصيل الخادم إلى الأداة.

سيتم استخدام خوادم STUN/{/3} بالترتيب الذي تظهر به في القائمة.

إزالة خادم STUN/{/3}

1. اختَر خادم STUN/{/3} الذي تريد إزالته.
2. انقر على إزالة الخادم.

ستستخدم الأداة stun:stun.l.google.com:19302 في حال عدم تحديد أي مثيل آخر من خوادم STUN/TURN.

تفعيل/إيقاف إرسال الصوت

1. تُرسِل الأداة الصوت تلقائيًا كجزء من بث WebRTC. إذا أردت إيقاف إرسال الصوت، أزِل العلامة من مربّع الاختيار تفعيل الصوت.

زر الإرسال

بعد تأكيد خوادم STUN/TURN والإعدادات المفضّلة للصوت، انقر على إرسال.

سيتم عرض إدخال الفيديو من كاميرا الويب في عنصر الفيديو المحلي.

إنشاء عرض SDP

1. انقر على إنشاء عرض SDP لإنشاء عرض SDP. سيتم تنسيق ملف JSON للعرض بالتنسيق التالي:

   {
   "action": "offer",
   "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
   }

2.يمكن الآن تمرير ملف Offer SDP إلى نظير WebRTC. قد يكون هذا وكيل WebRTC للمنزل الذكي في Google أو "أداة التحقّق من صحة WebRTC" التي تعمل على متصفّح آخر.

إرسال ملف تعريف وصف الخدمة (SDP) للإجابة

1. ضَع ملف JSON الخاص بالإجابة في مربّع نص ملف SDP للإجابة وانقر على إرسال الإجابة ملف SDP. يجب أن يكون Answer JSON بالتنسيق التالي:

   {
   "action": "answer",
   "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
   }

2. إذا كان ملف SDP الخاص بالرد صالحًا، سيتم عرض الفيديو (والصوت) من المصدر البعيد في عنصر الفيديو البعيد.

تصحيح أخطاء WebRTC

ننصح بشدة باستخدام "أداة التحقّق من صحة WebRTC" مع متصفّح Chrome (الإصدار 87 أو إصدار أحدث). ستتمكّن الأدوات في متصفّح Chrome من المساعدة في تصحيح أخطاء بث WebRTC.

صفحة Webrtc-Internals

1. افتح علامة تبويب جديدة في متصفّح Chrome.
2. الانتقال إلى العنوان التالي chrome://webrtc-internals

تعرض هذه الصفحة جميع اتصالات WebRTC النشطة الجارية. يتم جمع الإحصاءات والمقاييس التي يتم إنشاؤها في هذه الصفحة من getStats() API.

أدوات مطوّري برامج Chrome

ستكون أدوات مطوّري برامج Chrome مفيدة أيضًا في تحديد أي مشاكل في بث WebRTC وحلّها. ننصح بشدة بفتح Console قبل استخدام أداة التحقّق من WebRTC.