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

نسخ RTC

يمكن لـ RTC تحويل صوت التسجيل إلى نص بعد انتهاء المكالمة. يتم تحويل صوت ميكروفون كل مشارك وصوت كل شاشة مشتركة إلى نص بشكل منفصل، بحيث تحدد كل سطر المتحدث بدقة. ويشترك شخصان يستخدمان ميكروفونًا واحدًا في تسمية المتحدث نفسه.

التعليقات التوضيحية المباشرة أثناء المكالمة غير متاحة للعملاء حتى الآن. transcript.segment و captions.* تظل إشعارات الويب مخطط لها.

  • يجب أن تكون دقائق النسخ متوفرة في الخطة: تشملها باقتا «Growth» و«Business»، ويمكن لأي فئة إضافة حزم.
  • أبلغ المشاركين واحصل على الموافقة التي تتطلبها حالة الاستخدام الخاصة بك، سواء بشأن التسجيل أو النص. يجب أن يعرض تطبيقك مؤشرًا مرئيًا أثناء تشغيل التسجيل الذي سيتم تحويله إلى نص.
  • يشارك المشاركون الذين لا يجب تدوين نصوصهم (مثل الأطفال، أو أي شخص رفض ذلك) مع transcribe: false الطلب.

اطلب نسخة نصية عند بدء التسجيل، أو لاحقًا للحصول على نسخة من تسجيل انتهى.

الطريقة والمسارالنطاقالنتيجة
POST /v1/recordings مع "transcript": truerecordings:writeيبدأ التسجيل؛ ويتم طلب النص عند انتهائه
POST /v1/recordings/{recordingId}/transcriptrecordings:write202 { "recordingId", "status" }
GET /v1/recordings/{recordingId}/transcriptrecordings:readالنص وحالته (مقروء)
GET /v1/recordings/{recordingId}/transcript?format=vttrecordings:readالنص كملف (التنسيقات)
GET /v1/transcriptsrecordings:readنصوصك، الأحدث أولاً، بدون النص نفسه. يتم استبعاد نصوص التسجيلات الموجودة في سلة المهملات، لذا قد تحتوي الصفحة على أقل من limit العناصر؛ تابع X-Next-Cursor

نص الطلب اختياري:

{ "language": "de", "vocabulary": ["CHAMPREP", "Hocuspocus", "Dr. Okonkwo"] }
الحقلالقواعد
languageA رمز اللغة، أو zh-Hant للصينية بالأحرف التقليدية. إذا تم تجاهلها، يقوم RTC باكتشاف لغة كل مشارك.
vocabularyالتلميحات: ما يصل إلى 100 اسم، أو كلمة منتج، أو مصطلح، بحد أقصى 64 حرفًا لكل منها و1 كيلوبايت إجمالًا. تزيد التلميحات من احتمالية ظهور هذه الكلمات؛ لكنها لا تضمن صحة التهجئة.

يمر النص المكتوب بهذه الحالات:

statusالمعنى
waitingالتسجيل لا يزال قيد التشغيل. يبدأ النص عند انتهاء التسجيل.
reservingتقوم RTC بحجز دقائق النص من رصيدك المخصص.
queuedالدقائق المحجوزة؛ في انتظار كاتب النص.
runningقيد النسخ.
doneجاهز للقراءة.
failedلم يتم. error و errorCode اشرح السبب. النص الفاشل مجاني.

يحتوي كل تسجيل على نص واحد. إذا سألت مرة أخرى في حين أن هناك نصًا موجودًا أو قيد التشغيل فستحصل على إجابات 409 TRANSCRIPT_EXISTS. اطلب مرة أخرى a فشل واحد ويقوم RTC بتشغيله مرة أخرى؛ يمكنك تغيير language و vocabulary. التسجيل الذي لا يحتوي على صوت يُرد عليه 409 NO_AUDIO.

عادةً ما تكون مدة الإنجاز أقل بكثير من نصف مدة التسجيل زائد بضع دقائق. استخدم transcript.completed webhook بدلاً من الاستقصاء.

GET /v1/recordings/{recordingId}/transcript تُرجع JSON (Cache-Control: no-store):

{
"recordingId": "REC_UUID",
"status": "done",
"language": "en",
"billedMinutes": 42,
"truncated": false,
"durationMs": 2512000,
"model": "faster-whisper-small",
"completedAt": "2026-11-08T12:44:10.000Z",
"segments": [
{ "participantId": "PARTICIPANT_UUID", "identity": "user-123", "source": "microphone", "startMs": 61000, "endMs": 63400, "text": "Let's start with the roadmap." }
],
"createdAt": "2026-11-08T12:00:00.000Z"
}
الحقلالمعنى
segmentsالسطور مرتبة زمنيًا: من (participantId، و identity عندما يكون لدى المشارك واحد)، الصوت source (microphone أو screen_audio)، متى (startMs, endMs من بداية التسجيل) و text
languageاللغة السائدة، أو اللغة التي طلبتها (zh-Hant للصينية التقليدية)
billedMinutesالدقائق التي تم احتسابها لهذه الجلسة (الفوترة)
truncatedtrue عندما ينفد الرصيد أثناء تشغيل يتسم بتداخل صوتي شديد؛ يتوقف النص عند هذا الحد
error, errorCodeأسباب فشل التشغيل: RTC_ALLOWANCE_EXHAUSTED, BILLING_UNAVAILABLE, CANCELLED, RECORDING_LENGTH_UNKNOWN (وقت بدء التسجيل أو نهايته مفقود، لذا لا يمكن قياس أي شيء أو إصدار فاتورة)، أو عدم وجود رمز بسبب فشل في المعالجة
requestما تم طلبه في هذه الجلسة: language (غير موجود عند اكتشافه) و vocabulary، لذا يمكن إعادة المحاولة لإرسالها مرة أخرى

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

إضافة format لتصدير النص النهائي كملف. الإجابة عبارة عن مرفق باسم transcript-{recordingId}.{format}. النص المكتوب الذي لا done الإجابات 409 TRANSCRIPT_NOT_READY لكل تنسيق باستثناء json.

formatنوع المحتوىالمتحدثون
json (افتراضي)application/jsonidentity و participantId لكل مقطع
vtttext/vttعلامات الصوت في WebVTT: <v user-123>text
srtapplication/x-subripقبل كل إشارة: user-123: text
txttext/plainسطر واحد لكل مقطع: [00:01:01] user-123: text

في حالة عدم وجود identity، يتم استخدام participantId يُستخدم.

تدعم خدمة النسخ حوالي 100 لغة. وتُقدَّم هذه اللغات على مستويين، بناءً على دقة قياسية في مجموعات الاجتماعات العامة ومجموعات قراءة النصوص:

المستوىاللغات
متاح بشكل عامالإنجليزية (en)، الإسبانية (es)، البرتغالية (pt)، الألمانية (de)، الإيطالية (it)، الروسية (ru)، اليابانية (ja)، الفرنسية (fr)، الصينية (zh، الأحرف المبسطة؛ zh-Hant للنسخة التقليدية)
نسخة تجريبيةجميع اللغات الأخرى، بما في ذلك العربية (ar) والهندية (hi)

تعمل اللغات في مرحلة بيتا، ولكن بدقة أقل وأقل قابلية للتنبؤ. في صوت الاجتماعات الحقيقية (عدة أشخاص، كلام عفوي)، توقع معدلات خطأ في الكلمات الإنجليزية تبلغ حوالي 20٪؛ أما القراءة الصوتية والمتحدثون الفرديون الواضحون فيحققون نتائج أفضل بكثير.

GET /v1/capabilities تسرد الرموز تحت transcription.languages، تلك المتاحة بشكل عام تحت transcription.gaLanguages، التنسيقات و حدود المفردات.

تُكتب اللغة الصينية بالأحرف المبسطة ما لم تطلب zh-Hant.

تستخدم النصوص rtc-transcription-minutes البدل.

  • الوحدة: واحد لكل دقيقة بدأت من الأطول بين مدة التسجيل وإجمالي الكلام لجميع المشاركين. الاجتماع العادي، حيث يتحدث شخص واحد في كل مرة، يتم احتساب تكلفته حسب مدته. عندما يتحدث العديد من الأشخاص في الوقت نفسه، يتم احتساب إجمالي الكلام بدلاً من ذلك.
  • عمليات التشغيل الفاشلة مجانية. لا يتم فرض أي رسوم على الجلسة التي تفشل أو يتم إلغاؤها؛ ويتم تحرير الدقائق المحجوزة لها.
  • محجوز أولاً: يحتفظ RTC بمدة التسجيل من رصيدك المخصص قبل وضع النص في قائمة الانتظار. في حالة عدم توفر دقائق كافية، يفشل الطلب مجانًا مع errorCode: "RTC_ALLOWANCE_EXHAUSTED" و transcript.failed تسرد قائمة الأحداث الحزم والترقيات في offers.
  • التداخل: أثناء نسخ التسجيلات التي تحتوي على تداخل صوتي كثيف، تحتفظ RTC بدقائق إضافية مع زيادة مدة الكلام. إذا نفد الرصيد المخصص، يتوقف النص عند هذا الحد، ويتم وضع علامة عليه truncated: true، ولا يتم احتساب تكلفة سوى ما تم نسخه.
  • إذا تعذر الوصول إلى نظام الفوترة، ينتظر الطلب ثم يفشل تلقائيًا مع BILLING_UNAVAILABLE. لا تقوم RTC أبدًا بالنسخ دون فوترة.
  • يتم تسليم النص النهائي دائمًا. إذا لم تتمكن خدمة الفوترة من تأكيد الدقائق بعد ذلك، تواصل RTC المحاولة، وبعد بضع ساعات، تسجل كل دقيقة مستخدمة كاستخدام. الدقائق المستخدمة ليست مجانية أبدًا.

خطة بدون دقائق للنسخ الصوتي 403 RTC_FEATURE_NOT_IN_PLAN؛ رصيد مستنفد يستجيب 402 RTC_ALLOWANCE_EXHAUSTED. كلاهما يحمل feature: "rtc-transcription-minutes" و offers التي تعمل على إصلاح ذلك. انظر الخطط والفوترة للاطلاع على الباقات، وأسعار الباقات وأسعار الدفع حسب الاستخدام.

المشارك الذي رمز الانضمام تحمل "transcribe": false لا يتم نسخها أبدًا: يتم تسجيل مساراتها كالمعتاد ولكن يتم تخطيها في عملية النسخ. استخدمها للأطفال، أو لأي شخص رفض المشاركة، أو في أي حالة تتطلبها شروطك. لن تحتوي النسخة النصية ببساطة على أي سطور منهم.

الحدثdata
transcript.queuedrecordingId, roomId, reservedMinutes
transcript.completedrecordingId, roomId, segments (عدد)، durationMs, billedMinutes, truncated
transcript.failedrecordingId, roomId, error، ولأسباب تتعلق بالفوترة code (RTC_ALLOWANCE_EXHAUSTED, BILLING_UNAVAILABLE أو CANCELLED) مع offers، أو RECORDING_LENGTH_UNKNOWN

لا تحمل Webhooks أبدًا نص النص المكتوب؛ اقرأه باستخدام API. انظر webhooks.

التسليم إلى مساحة التخزين الخاصة بك

Section titled “التسليم إلى مساحة التخزين الخاصة بك”

عندما توفير مساحة تخزين خاصة بك مفعّلاً، يتم تسليم النص النهائي مع ملفات التسجيل الخاصة به، على النحو التالي transcript.json و transcript.vtt، من خلال نفس الوجهات، قالب المسار ({artifact} و {file})، والمحاولات المتكررة والأحداث (recording.delivered مع artifact: "transcript:json" أو "transcript:vtt"). التسجيلات الموجودة في سلة المهملات لا يتم تسليمها.

الاحتفاظ والملف المهملات

Section titled “الاحتفاظ والملف المهملات”

يُرفق النص المسجل بالتسجيل:

  • سلة المهملات: عندما ينتقل التسجيل إلى سلة المهملات، يتم إخفاء النص المكتوب أيضًا (404). تؤدي استعادة التسجيل إلى إعادة النص.
  • تم الحذف نهائيًا: حذف التسجيل من سلة المهملات، أو الحذف التلقائي بعد 30 يومًا من دخوله سلة المهملات، يؤدي إلى حذف النص المكتوب معه.
  • لا شيء آخر يؤدي إلى انتهاء صلاحية النص. يتم الاحتفاظ به طالما تم الاحتفاظ بالتسجيل، وفقًا لفترة الاحتفاظ بالتسجيلات المحددة في خطتك.

النسخ التي تم تسليمها بالفعل إلى مساحة التخزين الخاصة بك هي ملكك ولن يتم حذفها أبدًا.

الخصوصية ومعالجة البيانات

Section titled “الخصوصية ومعالجة البيانات”
  • CHAMPREP معالجة التسجيلات والنصوص بصفتها معالج البيانات الخاص بك، بناءً على تعليماتك.
  • النسخ هو استضافة ذاتية: يعمل في حساب RTC الخاص CHAMPREPبـ AWS في الولايات المتحدة (us-east-1). لا يتم إرسال الملفات الصوتية والنصوص إلى أي طرف ثالث، ولا يشارك أي معالج فرعي في العملية.
  • ملفاتك الصوتية ونصوصك هي لا تُستخدم أبدًا لتدريب نماذج.
  • لا يظهر نص النصوص أبدًا في السجلات أو webhooks أو أدوات CHAMPREPالدعم.
  • أنت مسؤول عن توفير الأساس القانوني وموافقة الأشخاص الذين تم تسجيلهم ونسخ نصوصهم، وعن عرض مؤشر مرئي للتسجيل والنسخ ، وعن القوانين التي تحمي القاصرين (مثل COPPA أو FERPA). الاستخدام transcribe: false بشأن أي شخص لا يجب كتابة نصوصه.