تخطَّ إلى المحتوى
Documentation

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

الوصول إلى الخطة والحدود المسموح بها

Section titled “الوصول إلى الخطة والحدود المسموح بها”

يجب تمكين RTC في الاشتراك النشط. يعرض عنصر التحكم في الخطة و الاستخدام تُظهر صفحة «التحكم في الخطة» و«الاستخدام» المخصصات المطبقة على مساحة العمل. لا تفترض أن جميع الاشتراكات التي تحمل نفس الاسم التسويقي لها حدود متطابقة. الخطط والفوترة تسرد الفترة التجريبية والمستويات والحزم، و GET /v1/subscription (جلسة عمل وحدة التحكم بعد تسجيل الدخول) يعرض كل الرصيد المتاح.

رمز الميزةعناصر التحكم
max-projectsالحد المسموح به لإنشاء المشاريع
max-participantsالسعة المسموح بها للمشاركين لكل غرفة
participant-minutesالسعة المسموح بها لوقت المشاركين
recording-jobsالحد المسموح به لمهام التسجيل

يستخدم مفتاح الخادم صلاحيات الوصول والامتيازات الخاصة بمساحة العمل المالكة له، وليس اشتراكًا منفصلاً للشخص الذي يحمل المفتاح. لا يمكن لزيادة السعة المطلوبة للغرفة تجاوز الخطة أو السعة المتاحة للوسائط.

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

  • سعة الغرفة هي عدد صحيح لا يقل عن اثنين، ضمن الحد المسموح به للمشاركين في مساحة عمل المضيف. يتم التحقق من سعة الوسائط المتاحة بشكل منفصل عن الخطة. لا يعني الرفض المؤقت للسعة أن هناك حاجة إلى ترقية الخطة.
  • يتم تقسيم القوائم إلى صفحات باستخدام ?limit و ?cursor (انظر API الأعراف) و لا تتوفر فيها ميزة البحث من جانب الخادم. يبحث البحث في وحدة التحكم فقط في القائمة المحملة.
  • الطلبات هي محدود المعدل لكل عنوان IP، APIومفتاح، و منظمة.
  • لا تُدعم حاليًا عمليات إعادة تسمية الغرفة وإعادة فتحها وحذفها كطرق متاحة للعملاء.
  • مفاتيح التبادلية العامة للتحويلات وواجهات برمجة التطبيقات (API) للتصدير المجمّع غير متوفرة.
  • استخدم التوزيعSDK المدعوم على الويب. ستتوفر قريبًا أدلة خاصة بخوادم Python/Node.js SDKsو مكدسات برمجية محددة، وليست إصدارات قابلة للتثبيت.
  • تحتوي التسجيلات على مسارات فردية، وليست مقطع فيديو مركبًا. انظر قيود التسجيل.
  • لا توجد ضمانات عامة لإعادة الاتصال السلس، أو الغرف غير المحدودة، أو الاحتفاظ اللانهائي، أو وقت تشغيل محدد للخدمة في هذه الأدلة.

تحقق من الملفCHAMPREP الشخصي النشط، ثم تأكد من تضمين RTC و تمكينه لاشتراك ذلك الملف الشخصي. CHAMPREPالحساب الذي تم إنشاؤه حديثًا لا يتمتع بالوصول تلقائيًا. حاول تسجيل الدخول مرة أخرى إذا انتهت صلاحية الجلسة. إذا بدت الخطة صحيحة، فاتصل بالدعم مع ذكر الوقت والخطأ المعروض.

تحقق من رمز الخطأ (X-Error-Code)، انتهاء صلاحية المفتاح/إلغاؤه، النطاق المطلوب، اختيار المشروع، حالة المورد، والحد الأقصى للخطة. انسخ معرّفات UUID من وحدة التحكم أو API بدلاً من استخدام الأسماء. يتم رفض خصائص JSON غير المعروفة. لا تحاول إعادة محاولة خطأ التفويض مرارًا وتكرارًا ولا تضف نطاقات غير ذات صلة.

الغرفة متصلة لكنني لا أستطيع سماع أو رؤية أي شخص

Section titled “الغرفة متصلة لكنني لا أستطيع سماع أو رؤية أي شخص”
  • تأكد من أن مشاركًا واحدًا على الأقل يقوم بالنشر وأن صوته غير مكتوم.
  • تحقق من أذونات الميكروفون/الكاميرا في المتصفح ونظام التشغيل، وكذلك الأجهزة المادية المحددة.
  • لا يمكن لرمز التعريف المخصص للاستلام فقط النشر. يجب ألا يتيح تطبيقك لهذا المستخدم إمكانية التحكم في النشر.
  • في عميل مخصص، أرفق كل من مسارات الصوت والفيديو وتعامل مع قيود التشغيل التلقائي للمتصفح من خلال إيماءة من المستخدم.
  • لا تثبت حالة الإشارة المتصلة وحدها تدفق الوسائط. اختبر مع مشاركين معتمدين على أجهزة أو شبكات مختلفة.

الشبكة ضعيفة أو فشل إعادة الاتصال

Section titled “الشبكة ضعيفة أو فشل إعادة الاتصال”

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

يجب أن تقوم نقطة نهاية الانضمام الخاصة بك بإنشاء بيانات اعتماد جديدة عند إعادة الاتصال. إعادة استخدام رمز انتهت صلاحيته أو تم استهلاكه يؤدي إلى الفشل. محاولات SDK«» محدودة؛ اعرض الفشل و اعرض إعادة انضمام متعمدة بعد التحقق من حالة الغرفة والوصول.

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

بالنسبة للمهام الفاشلة، احتفظ بمعرّف التسجيل والطابع الزمني لتقديمه إلى الدعم. لا تقوم بإنشاء مهام جديدة بشكل متكرر دون التحقق مما إذا كانت مهمة سابقة نشطة أم لا.

أحداث Webhook مفقودة أو مرفوضة

Section titled “أحداث Webhook مفقودة أو مرفوضة”

تأكد من أن جهاز الاستقبال الخاص بك يقبل HTTPS POST على المنفذ 443 دون إعادة توجيه وأن نقطة النهاية ممكّنة ومشتركة في نوع الحدث. أرسل حدثًا اختباريًا واقرأ سجل التسليم، ثم تحقق من السر، ومفتاح نظام التوقيع، والتحقق الدقيق من النص الخام، وانحراف الساعة. اسمح بتكرار الأحداث دون تكرار آثارها الجانبية. انظر استكشاف أخطاء webhook وإصلاحها.

ما يجب إرساله إلى الدعم

Section titled “ما يجب إرساله إلى الدعم”

استخدم CHAMPREP صفحة الاتصال. قم بتضمين الطابع الزمني والمنطقة الزمنية، والعملية المتأثرة، والمتصفح/الجهاز، ومعرف المورد عند الاقتضاء، و X-Request-Id الطلب الفاشل، ورمز خطأ محجوب أو حالة HTTP. لا تقم أبدًا بتضمين كلمات المرور، API أو المفاتيح، أو رموز المشاركين، أو عناوين URL للتنزيل، أو أسرار التوقيع، أو الوسائط الخاصة.