أستكشاف أخطاء مكالمات WebRTC وإصلاحها على أجهزة RoomOS Webex

المقدمة

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

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• بنية Cisco RoomOS وإطار عمل مستعرض WebEngine.
• إدارة جهاز Cisco Webex Control Hub، ملفات تعريف التكوين، وتحليلات أستكشاف الأخطاء وإصلاحها.
• تحليل التقاط حزمة الشبكة باستخدام Wireshark لفحص تدفقات SSRC وتنسيقات الحمولة.

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:

• سلسلة غرف Cisco (شريط الغرفة، مجموعة أدوات الغرفة، مجموعة أدوات الغرفة Pro، مجموعة الغرفة EQ) التي تعمل بنظام التشغيل RoomOS 26.x أو إصدار أحدث
• سلسلة لوحات Cisco (لوحة PRO 55/75، لوحة PRO G2) التي تعمل بنظام التشغيل RoomOS 26.x
• سلسلة مكتب Cisco (Desk Pro، Desk Mini)
• Cisco Webex Control Hub
• خدمات تعاون WebRTC: انضمام الضيف المباشر إلى Microsoft Teams (DGJ) و Google Meet و WebRTC للتكبير/التصغير و Webex Instant Connect

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.

معلومات أساسية

ما هو WebRTC؟

يعد WebRTC (إتصالات Web Real-time) أحد معايير المصادر المفتوحة التي تم تضمينها في مستعرضات الويب الحديثة. فهو يتيح إمكانية تدفق الفيديو والصوت والبيانات في الوقت الفعلي بين نقاط النهاية دون الحاجة إلى مكونات إضافية خاصة.

• واجهات برمجة تطبيقات JavaScript: يوفر واجهات برمجة تطبيقات (API) قياسية (مثل GetUserMedia و RTCPirConnection و RTCDataChannel) تتفاعل مباشرة مع أجهزة الصوت/الفيديو.
• دعم برنامج الترميز الأصلي: تضمين برامج فك تشفير الصوت والفيديو الحديثة عالية الدقة، بما في ذلك OPUS و G.711 و VP8 و VP9 و H.264.
• تبعية المكون الإضافي صفر: إلغاء متطلبات الوظائف الإضافية أو ملفات سطح المكتب القابلة للتنزيل أو امتيازات التثبيت الإداري.

كيفية عمل WebRTC على Cisco RoomOS (WebEngine)

في أجهزة التعاون بالفيديو من Cisco التي تعمل بنظام التشغيل RoomOS، لا تعمل تطبيقات WebRTC كتطبيقات البرامج الثابتة المحولة الأصلية C/C++. بدلا من ذلك، فإنها تنفذ داخل بيئة مستعرض WebEngine المضمنة، والتي تقوم على نواة الكروم عالية الأداء المحسنة لأجهزة معالجة الفيديو من Cisco.

التكوين 

لتمكين إمكانيات التشخيص الشاملة لجلسات عمل WebRTC و WebEngine على أجهزة Cisco RoomOS، يجب على المسؤولين تمكين تصحيح الأخطاء عن بعد في Cisco Webex Control Hub أو عبر واجهة برمجة التطبيقات الخاصة بالجهاز xAPI.

الخطوة 1: تمكين تصحيح أخطاء WebEngine عن بعد في محور التحكم في التعاون من Cisco

1. قم بتسجيل الدخول إلى Cisco Webex Control Hub.
2. انتقل إلى الإدارة > الأجهزة وحدد نقطة نهاية الفيديو الهدف.
3. انقر فوق جميع التكوينات من اللوحة اليمنى.
4. ابحث عن WebEngine وحدد موقع المعلمة RemoteDebuing.
5. قم بتعيين WebEngine RemoteDebuing إلى تشغيل وانقر فوق حفظ.

بدلا من ذلك، قم بتمكين تصحيح الأخطاء عن بعد مباشرة من خلال واجهة سطر أوامر الجهاز (CLI):

xConfiguration WebEngine RemoteDebugging: On
xConfiguration WebEngine Features WebRTC: On

الخطوة 2: التحقق من الصحة

أستخدم هذا القسم لتأكيد تهيئة WebEngine بشكل صحيح ومعالجتها بشكل نشط لقنوات وسائط WebRTC أثناء المكالمة.

تنفيذ أوامر xStatus عبر الوحدة الطرفية أثناء وجود إجتماع WebRTC قيد التقدم:

xStatus WebEngine
xStatus WebRTC MediaChannels

الجدول 1: يصف حقول التشغيل الأساسية التي تم إرجاعها بواسطة أمر حالة WebRTC:

معلمة xStatus	الحالة المتوقعة	الوصف والتأثير التشخيصي
حالة WebEngine	ركض	الإشارة إلى ما إذا كان نواة مستعرض الكروم نشطة ويتم تصويرها.
عميل WebRTC MediaChannels	نشط / متصل	يشير إلى نقل الوسائط النشط بين برنامج الترميز وجسر وسائط السحابة.
إتجاه	الصادر / الوارد	يحدد ما إذا كانت قناة الوسائط تمثل بث الكاميرا/الميكروفون المحلي أو إستقبال الفيديو عن بعد.
TargetBitrate	150000 بت في الثانية (1.5 ميجابت في الثانية)	تم تخصيص النطاق الترددي الهدف بواسطة WebEngine استنادا إلى سعة الشبكة المتوفرة.

استكشاف الأخطاء وإصلاحها

يوفر هذا القسم إجراءات شاملة لاستكشاف الأخطاء وإصلاحها خطوة بخطوة وتعليمات تجميع السجلات وتقنيات إرتباط تدفق وسائط SSRC لمشكلات WebRTC.

1. تجميع السجلات من WebEngine وواجهة اللمس

عند حدوث مشكلة في الجودة أو الاتصال أثناء إستدعاء WebRTC نشط، قم بتنفيذ الإجراء مباشرة من لوحة Cisco Room Navigator / Touch 10. أثناء إجتماع WebRTC النشط، المس قائمة التحكم في الجهاز وحدد الإعدادات.

1. انتقل إلى المشاكل والتشخيصات.
2. تبديل التسجيل الموسع إلى تشغيل. (الطوابع الزمنية للحزم عالية الدقة لسجلات التسجيل الموسعة، وتقارير مرسل/مستقبل RTCP، وإحصاءات تدفق الوسائط).
3. مباشرة بعد أن يتم نسخ مشكلة الصوت/الفيديو، حدد إرسال سجلات WebRTC.

بمجرد تحميل السجلات بنجاح إلى سحابة Cisco، تقوم الواجهة بإنشاء معرفات تعقب فريدة:

• معرف WebRTC: يتم تنسيق هذا المعرف خصيصا لمزودي خدمة المؤتمرات التابعين لجهة خارجية (على سبيل المثال، دعم Microsoft ل Teams Direct Guest Join أو دعم Google Cloud ل Google Meeting). قم بتوفير هذا المعرف عند فتح حالة دعم مع موفر الاستضافة.

• معرف السجل / معرف الملاحظات: تتم فهرسة هذا المعرف في Cisco Webex Control Hub. يستخدم مهندسو Cisco TAC معرف السجل هذا لتحديد موقع الحزمة التشخيصية لنظام نقطة النهاية الكاملة وفك تشفيرها وتحليلها.

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

 

2. تعيين تدفقات الوسائط وتعريف SSRC (xStatus Correlation)

في بنيات بروتوكول النقل في الوقت الفعلي (RTP) و WebRTC، يعد مصدر المزامنة (SSRC) معرفا رقميا بالغ الأهمية إصدار 32 بت يعمل على تسمية أصل تدفق الوسائط. تستخدم أجهزة الاستقبال SSRC لتسلسل الحزم وحساب الرجفان ومزامنة الصوت مع الفيديو.

لتعيين دفق فيديو أو صوت معين بين سجلات xStatus للجهاز والتقاط حزمة Wireshark، قم بتحويل معرف القناة العشرية من xstatus.txt إلى المكافئ السداسي العشري الخاص به:

(416917557)10  =  (0x18D9A835)16

Wireshark Display Filter: rtp.ssrc== 0x18D9A835

يوضح قصاصة السجل قناة فيديو صادرة ل Live WebRTC تم إستخراجها من ملف تشخيص نقطة النهاية xstatus.txt:

*s WebRTC MediaChannels Client Channel 7 Direction: Incoming
*s WebRTC MediaChannels Client Channel 7 Id: "IT01V416917557"
*s WebRTC MediaChannels Client Channel 7 Netstat BytesSent: 89661904
*s WebRTC MediaChannels Client Channel 7 Netstat PacketsSent: 84431
*s WebRTC MediaChannels Client Channel 7 QualityLimitation NetworkBandwidthLimited: 50
*s WebRTC MediaChannels Client Channel 7 QualityLimitation NotLimited: 497
*s WebRTC MediaChannels Client Channel 7 TargetBitrate: 1500000
*s WebRTC MediaChannels Client Channel 7 Transport RTCP Local IpAddress: ""
*s WebRTC MediaChannels Client Channel 7 Transport RTCP Local Port: 1742
*s WebRTC MediaChannels Client Channel 7 Transport RTCP Local Protocol: UDP
*s WebRTC MediaChannels Client Channel 7 Transport RTCP Remote IpAddress: ""
*s WebRTC MediaChannels Client Channel 7 Transport RTCP Remote Port: 3478
*s WebRTC MediaChannels Client Channel 7 Transport RTCP Remote Protocol: UDP
*s WebRTC MediaChannels Client Channel 7 Type: Video
*s WebRTC MediaChannels Client Channel 7 Video EncoderImplementation: "ExternalEncoder"
*s WebRTC MediaChannels Client Channel 7 Video FrameHeight: 540
*s WebRTC MediaChannels Client Channel 7 Video FrameWidth: 960
*s WebRTC MediaChannels Client Channel 7 Video FramesPerSecond: 30
*s WebRTC MediaChannels Client Channel 7 Video Protocol: "video/VP8"

الفوائد التشخيصية الرئيسية من تحليل قناة الوسائط هذا:

• إرتباط SSRC: يمثل لاحقة معرف القناة 416917557" SSRC 0x18D9A835. تؤدي تصفية Wireshark ل SSRC هذا إلى عزل جميع حزم الفيديو الصادرة.
• النقل والترحيل: تتصل نقطة النهاية المحلية (<عنوان IP المحلي) مباشرة مع خادم STUN/TURN عن بعد ل Google (عنوان خادم IP العام على منفذ UDP 3478).
• دقة الوضوح والترميز: يتم تشفير الدفق بشكل فعال باستخدام VP8 الذي يعمل على زيادة سرعة الأجهزة بدقة 960 × 540 بكسل بمعدل 30 إطارا في الثانية.
• عداد حدود الجودة: يشير العداد QualityLimit NetworkBandwidthLimited الخاص ب 50 إلى أن خوارزمية التحكم في إزدحام WebEngine قد تم تطويرها بسبب قيود مؤقتة على عرض النطاق الترددي للتدفق.

3. أستكشاف الأخطاء وإصلاحها المتقدم من Cisco Webex Control Hub

يمكن للمسؤولين تحليل مقاييس إجتماعات WebRTC المباشرة والتاريخية ضمن Cisco Webex Control Hub:

1. انتقل إلى Control Hub (لوحة التحكم) > Troubleshooting (أستكشاف الأخطاء وإصلاحها) > Meetings & Call (الاجتماعات والمكالمات).
2. التصفية حسب عنوان MAC أو الرقم التسلسلي أو اسم الجهاز أو معرف السجل لنقطة النهاية.

    

    
3. حدد جلسة الاجتماع الهدف من نتائج البحث حسب الترتيب الزمني.
4. راجع الرسومات البيانية للقياس عن بعد خطوة بخطوة في الوقت الفعلي: فقدان الحزمة (الصوت/الفيديو)، مخزن مؤقت للرجفان، زمن الوصول (RTT)، قياس الدقة الديناميكية.

 

 

الجدول 2: أوضاع فشل WebRTC الشائعة ومصفوفة الإصلاح

العرض	سبب جذري محتمل	التحقق التشخيصي	خطوة الإصلاح
فشل الاتصال في الانضمام / الدوران بشكل مستمر	حظر جدار الحماية لمنافذ STUN/Turn UDP الصادرة (3478، 5004-65535)	يعرض Wireshark طلبات ربط STUN المتكررة بدون استجابات ملزمة	فتح منافذ UDP الصادرة لنطاقات IP لوسائط موفر WebRTC.
تجميد الصوت/الفيديو أحادي الإتجاه	مهلة NAT أو UDP المتناسقة على جدار حماية المؤسسة المعبر عن الحالة	تظهر xStatus زيادة سريعة في QualityLimit NetworkBandwidthLimited	تكوين مهلة حالة UDP لجدار الحماية >= 60 ثانية؛ تمكين رسائل تنشيط الاتصال STUN.
شاشة سوداء أو عطل في وحدة USB-C BYOM	فشل تفاوض الوضع البديل ل DisplayPort عبر الكبل غير المعتمد	Messages.Log يعرض مهلة تفاوض طاقة USB ل Kernel	إستخدام كابل USB-IF معتمد من النوع C بسرعة 10 جيجابت في الثانية؛ تعيين MonitorRole لموصل خرج الفيديو على "تلقائي".

معلومات ذات صلة

• دليل مرجع أوامر Cisco RoomOS (تكوين xAPI و WebEngine)
• إدارة الأجهزة في موزع التعاون من Cisco
• مرجع واجهة برمجة تطبيقات Webrtc
• أفضل الممارسات ل WebEngine

محفوظات المراجعة

المراجعة	تاريخ النشر	التعليقات
1.0	20-Oct-2026	الإصدار الأولي