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

نظرة عامة

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

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

صورة عامة لأداة WebRTC Validator

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

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

مربّع اختيار خادم STUN/TURN

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

  1. ضَع عنوان خادم STUN أو TURN في مربّع النص معرّف الموارد المنتظم (URI) لخادم STUN أو TURN. تأكَّد من أنّ نظام معرّف الموارد المنتظم (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) للعرض. سيتم تنسيق Offer JSON بالتنسيق التالي: 
    {
"action": "offer",
"sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

‫2.يمكن الآن تمرير وصف جلسة العرض (SDP) إلى جهاز WebRTC آخر. يمكن أن يكون ذلك وكيل Google Smart Home WebRTC أو أداة WebRTC Validator Tool التي تعمل على متصفّح آخر.

إرسال الإجابة SDP

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

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

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

تصحيح أخطاء WebRTC

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

صفحة Webrtc-Internals

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

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

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

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