تسجيلات RTC
قبل التسجيل
Section titled “قبل التسجيل”تأكد من أن التسجيل مدرج في RTC الخاص بمساحة العمل الخطة. أبلغ المشاركين واحصل على أي موافقة مطلوبة لحالة الاستخدام الخاصة بك. يجب أن يوفر تطبيقك مؤشر تسجيل مرئي خاص به وتجربة الحصول على الموافقة.
يجب أن يكون المشاركون قد بدأوا بالفعل في نشر المسارات التي تريد التقاطها عند بدء التسجيل. الإصدار الحالي يلتقط تلك المسارات المحددة؛ وهو لا يضيف تلقائيًا مشاركين جدد أو مسارات تبدأ في النشر لاحقًا. الجلسة الصامتة أو الفارغة لا تُعد اختبارًا مفيدًا للتسجيل.
التسجيل في وحدة التحكم
Section titled “التسجيل في وحدة التحكم”- انضم إلى غرفة مفتوحة وانشر ملف الصوت/الفيديو المقصود.
- اختر ابدأ التسجيل في عناصر التحكم في الاستدعاء.
- فتح التسجيلات لفحص المهمة. استخدم تحديث لإعادة تحميل الحالة.
- اختر إيقاف على التسجيل النشط عند الانتهاء، أو قم بإنهاء الغرفة.
- انتظر حتى تكتمل المهمة
ready، ثم استخدم أزرار تنزيل المقطوعات الخاصة به.
مغادرة المكالمة بنفسك لا تعني إيقاف التسجيل صراحةً أو إنهاء الغرفة. بالنسبة للتكاملات، استخدم التسجيل API. لتحويل صوت التسجيل إلى نص، انظر النسخ.
دورة الحياة
Section titled “دورة الحياة”| الحالة | المعنى |
|---|---|
queued | تم قبول طلب البدء |
recording | التسجيل نشط أو قيد البدء |
processing | انتهى التسجيل ويجري حالياً إنهاء الإخراج |
ready | ملفات المقاطع متاحة للتنزيل المصرح به |
failed | لم يكتمل التسجيل أو المعالجة بنجاح |
لا يجوز وجود سوى مهمة واحدة في قائمة الانتظار أو قيد التسجيل أو المعالجة لغرفة ما في كل مرة. لا تعامل 202 استجابة البدء أو طلب إيقاف ناجح كإكمال. استخدم قائمة التسجيلات أو الملف الموقّع recording.ready حدث.
النتائج والقيود الحالية
Section titled “النتائج والقيود الحالية”والناتج هو المسارات الفردية بتنسيق MKV، وليس مقطع فيديو واحدًا مركبًا للاجتماع. تحدد كل مقطوعة نوع الوسائط ومصدرها والمشارك وحجمها ومعرف المقطوعة. يختلف دعم التشغيل؛ استخدم مشغلًا متوافقًا أو سير عمل معالجة الوسائط الخاص بك عندما تحتاج إلى تنسيق آخر أو تخطيط مدمج.
تحدد الإصدارات الحالية من ميزة التسجيل مدة التسجيل بساعة واحدة وحوالي 1 جيجابايت لكل مسار. ولا يتم تسجيل المسارات التي تنضم متأخرة تلقائيًا.
حذف التسجيلات أو الاحتفاظ بها أو تسليمها
Section titled “حذف التسجيلات أو الاحتفاظ بها أو تسليمها”حذف تسجيل باستخدام DELETE /v1/recordings/{recordingId}: يتم إرسالها إلى سلة المهملات، ويتم حذفها تلقائيًا بعد 30 يومًا، ويمكنك استعادتها حتى ذلك الحين باستخدام
POST /v1/recordings/{recordingId}/restore. التسجيل الموجود في سلة المهملات لا يزال يُحتسب من سعة تخزين التسجيلات الخاصة بك. لإزالته نهائيًا في وقت أقرب، احذفه من سلة المهملات باستخدام POST /v1/recordings/{recordingId}/purge: RTC تجيب 202
(status: "deleting")، ويكتمل الحذف قريبًا و recording.purged
فيما يلي.
CHAMPREP يحتفظ بالتسجيلات طوال فترة الاحتفاظ الخاصة بخطتك؛ وعند انتهائها، يتم إرسال التسجيل إلى سلة المهملات بنفس الطريقة. في الخطط التي تتضمن هذه الميزة، يقوم RTC أيضًا بنسخ كل تسجيل منتهي إلى سلة التخزين الخاصة بك، ولا يتم حذف هذه النسخ أبدًا بواسطة RTC. انظر حذف تسجيل و استخدم مساحة التخزين الخاصة بك.
التنزيل بأمان
Section titled “التنزيل بأمان”تستخدم الخلفية الخاصة بك مفتاحًا مع recordings:read لطلب رابط تنزيل المقطع المحدد. تقوم بالتحققAPI من التسجيل وحق الوصول إلى المشروع الخاص بالمفتاح. ثم تُرجع رابطًا من نطاق RTC تنتهي صلاحيته بعد خمس دقائق.
يمكن لأي شخص يمتلك رابط URL المؤقت هذا استخدامه طالما ظل صالحًا. ولا يتطلب ذلك تسجيل دخول منفصل عبر المتصفح. قم بتسليمه فقط إلى مستخدم أذن له تطبيقك، أو قم ببث الملف عبر الخلفية الخاصة بك بعد المصادقة إذا كنت بحاجة إلى ربط كل عملية تنزيل بجلسة تطبيقك.
- لا تضع روابط التنزيل في الصفحات العامة أو أدوات التحليل أو السجلات أو الرسائل المشتركة.
- احصل على الرابط بالضبط كما تم إرجاعه بدلاً من إنشاء مسار كائن.
- إذا انتهت صلاحيته، فاطلب رابطًا جديدًا بعد التحقق من حق الوصول مرة أخرى.
- يؤدي إلغاء APIالمفتاح المُصدر إلى إبطال أذونات التنزيل المعلقة الخاصة به.
- تنزيل نسخة مرخصة لا يجعل تلك النسخة المحفوظة قابلة للإلغاء.
الاستخدام webhooks لإعلام تطبيقك بأن المعالجة قد اكتملت دون طلب أذونات التنزيل بشكل متكرر.