מפת דוברים

רכיב מפת דוברים מזהה איזו מצלמה מצלמת כל דובר, לפי המיקרופונים של המצלמות עצמן. כך עריכה עם כמה מצלמות עוברת לאדם הנכון בלי שמישהו ימלא טבלה. חברו את התוצאה שלו לקלט מפת דוברים של רכיב מחליף מצלמות, שמציב כל חיתוך במצלמה של האדם שמדבר.

בפודקאסט או בראיון עם כמה מצלמות, לכל אורח יש בדרך כלל מצלמה משלו, ולכל מצלמה יש מיקרופון משלה. בזמן שאורח מדבר, המצלמה שמכוונת אליו שומעת אותו הכי חזק. רכיב מפת דוברים מקבל תמלול עם תוויות דוברים, מאזין לכל מצלמה בזמן התורות של כל דובר, ומחליט איזו מצלמה שייכת למי.

הרכיב רץ מקומית, בלי מודל AI ובלי מפתח ספק, ולכן הוא עובד בכל מהדורה.

מתי להשתמש

• להודיע לרכיב מחליף מצלמות איזו מצלמה שייכת למי בפודקאסט עם מצלמה לכל אורח, בלי למלא את הטבלה דוברים.
• למפות את המצלמות מחדש בכל סשן של ראיון שבו האורחים מחליפים מקומות.

התחלה מהירה

קלטים

פלטים

הפלט מפת דוברים נראה כך:

{
  "version": 1,
  "speakerMap": { "speaker_0": "camA", "speaker_1": "camB", "speaker_2": "" },
  "confidence": {
    "speaker_0": { "camera": "camA", "marginDb": 9.4 },
    "speaker_1": { "camera": "camB", "marginDb": 6.1 },
    "speaker_2": { "camera": "", "marginDb": 1.2 }
  },
  "notes": ["\"speaker_2\": no clear camera (the loudest led by 1.2 dB) — shown on the wide shot; set the map to override."]
}

הגדרות

איך נקבעות המצלמות

לכל דובר, לאורך כל התורות שלו:

• המצלמה החזקה ביותר גוברת. המצלמה ששומעת את הדובר הכי חזק היא שלו, כשהיא מקדימה את המצלמה הבאה לפחות בערך של פער נדרש.
• אין מצלמה ברורה. כשאף מצלמה לא מקדימה במידה הזו, למשל כי הדובר יושב בין שתי מצלמות, הדובר נשאר בלי מצלמה ברורה. רכיב מחליף מצלמות מציג אותו אז בצילום הרחב, או בכל מצלמה עם תמונה כשאין צילום רחב. הערה מציינת את הדובר ובכמה המצלמה החזקה ביותר הקדימה את השאר.
• הצילום הרחב והקלטת המאסטר אף פעם לא זוכים בדובר. הם שומעים את כולם, ולכן הם לא המצלמה של אף אחד.
• מצלמה בלי סאונד היא לא כשל. מצלמה בלי רצועת אודיו, עם מיקרופון מושתק או כזו שלא שמעה אף אחת מהתורות פשוט לא יכולה לזכות בדובר, והערה מציינת אותה.

קרדיטים

רכיב מפת דוברים עולה מחיר קבוע אחד לכל הרצה, בלי קשר לאורך ההקלטות או למספר שלהן. הכפתור הרצה ברכיב מציג את המחיר. מהדורת Community ומהדורת Business באירוח עצמי לא משתמשות בקרדיטים.

אלה נדחים לפני שנגבים קרדיטים:

• פחות מ-2 הקלטות או יותר מ-6, או שתי הקלטות עם אותו מזהה.
• צילום רחב שהוא הקלטה של סאונד בלבד, כגון רכיב אודיו.
• תמלול חסר, או תמלול בלי שום תוויות דוברים. סמנו את תיבת הסימון זיהוי דוברים ברכיב תמלול והריצו אותו שוב.

על הקנבס, מאסטר או צילום רחב שהם לא אחת מההקלטות לא נלקחים בחשבון. דרך ה-API, הבקשה נדחית.

טיפים

• סמנו את המיקרופון הראשי ואת הצילום הרחב. אחרת הסאונד שלהם מתחרה בסאונד של המצלמות, וצילום רחב ששומע את כולם עלול לזכות בדובר.
• חברו את ההיסטים כשההקלטות התחילו בנפרד. בלעדיהם, כל מצלמה נקראת לפי הזמנים של התמלול, ומצלמה שהתחילה מאוחר נשמעת ברגעים הלא נכונים.
• בדקו את ההערות. דובר בלי מצלמה ברורה בדרך כלל יושב בין שתי מצלמות, או שהמיקרופונים של המצלמות כוונו בצורה שונה מאוד. קבעו את המצלמה של הדובר הזה בטבלה דוברים של רכיב מחליף מצלמות: מצלמה שנקבעה שם גוברת על המפה.
• כוונו את הפער. העלו את פער נדרש כשהמפה בוחרת מצלמה שחזקה רק במעט. הורידו אותו כשיותר מדי דוברים נשארים בלי מצלמה ברורה.
• תנו לרכיב פריסת דוברים לעשות את זה. רכיב פריסת דוברים מריץ בשבילכם את סנכרון האודיו, התמלול, מפת הדוברים ומחליף המצלמות, וממסגר כל דובר במצלמה שלו.

פתרון בעיות

דרך ה-API

הנתיב POST /v1/speaker-map מקבל את sources, רשימה של 2–6 אובייקטים עם id ייחודי, url ו-kind אופציונלי, ואת transcript. הוא מקבל גם, באופן אופציונלי, את offsets (תוצאה של סנכרון אודיו), masterSourceId, wideSourceId ו-marginDb, מ-0 עד 30. הערך kind: "audio" מסמן הקלטה של סאונד בלבד, כגון מיקרופון ראשי, שאף פעם לא תהיה המצלמה של אף אחד.

בקשה פגומה נדחית עם 400 validation_error, ותמלול בלי תוויות דוברים נדחה עם 422 no_speakers, בשני המקרים לפני שמשהו משוריין. ב-output_data.json של המשימה שהושלמה נמצאת התוצאה מפת דוברים שלמעלה, וב-output_data.edl נמצאת העריכה.

המתודה ב-SDK היא client.edit.speakerMap, הפקודה ב-CLI היא nodaro edit speaker-map, וכלי ה-MCP הוא speaker_map. כדי להעביר את התוצאה לרכיב מחליף מצלמות, שלחו אותה כ-speakerMapResult ב-SDK, כ---speaker-map-result ב-CLI או כ-speaker_map_result ב-MCP. ראו את דף ה-API קול ומדיה, את הדף עריכה ב-SDK ואת מדריך כלי ה-MCP.