دليل مستخدم أداة التحقّق من صحة 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/TURN بالترتيب الذي تظهر به في القائمة.

إزالة خادم STUN/TURN

1. اختَر خادم STUN/TURN الذي تريد إزالته.
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 Smart Home أو أداة التحقّق من WebRTC التي تعمل على متصفّح آخر.

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

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

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

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

تصحيح أخطاء WebRTC

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

صفحة Webrtc-Internals

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

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

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

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