# רצף שוטים

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

Source: https://nodaro.ai/he/docs/mcp/shot-sequence

**רצף שוטים** הוא סרטון גרפיקת תנועה עם קריינות, שבו כל פיסת טקסט על המסך, כל צורה וכל תמונה מופיעות ברגע שהקריינות אומרת את הביטוי שמתאים להן. אתם, או עוזר, כותבים **בריף**: הקריינות, סימני הזמן שלה, והסצנות, השוטים והחשיפות. Nodaro מיישר את הקריינות המוקלטת מילה אחר מילה ומקבע כל סימן זמן לפריים מדויק, כך שהתזמון דטרמיניסטי. [במאי הווידאו](https://nodaro.ai/docs/mcp/video-director) בנוי על הפייפליין הזה וכותב לכם את הבריף.

## הפייפליין
Workflow: טקסט הקריינות מוקרא, מיושר מילה אחר מילה, מומר לתוכנית מדויקת ברמת הפריים ומרונדר.

- generate_speech → forced_alignment (אודיו)
- forced_alignment → resolve_shot_sequence (יישור)
- resolve_shot_sequence → render_shot_sequence (תוכנית)

### הקראת הקריינות
קראו ל-[`generate_speech`](https://nodaro.ai/docs/mcp/tools/audio#generate_speech) עם תסריט הקריינות. קחו את כתובת האודיו מהפלט של המשימה. עם ElevenLabs v3, השלב הזה עולה 5–33 קרדיטים.

### יישור המילים
קראו ל-`forced_alignment` עם האודיו ועם אותו תסריט בדיוק בתור `transcript`. התוצאה נמצאת ב-`output_data.alignment`: רשימה של `{ word, start, end }` בשניות. היישור עולה 33 קרדיטים.

### המרת הבריף לתוכנית
קראו ל-`resolve_shot_sequence` עם הבריף, עם כתובת האודיו ועם היישור. הכלי עונה מיד עם `plan` מוכן לרינדור, ועם `warnings` אם יש. הכלי חינמי.

### רינדור
קראו ל-`render_shot_sequence` עם התוכנית. המשימה מרנדרת את ה-MP4, שהכרטיס מנגן והספרייה שלכם שומרת. הרינדור עולה 55 קרדיטים, בכל גודל פריים.

קראו קודם ל-[`start_video_director`](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director#start_video_director): הכלי מחזיר את המדריך לכתיבת הקריינות כביטויים שמשמשים סימני זמן ולבניית בריף טוב.

## כתיבת בריף
בבריף יש `narration`, עם `script` ו-`cues`, ו-`scenes` שמכילות `shots`, שמכילים `reveals`. **סימן זמן** הוא ביטוי מתוך התסריט. **חשיפה** ממקמת אלמנט ברגע שסימן זמן נאמר.

```json
{
"fps": 30, "width": 1920, "height": 1080, "backgroundColor": "#0b0b0f",
"narration": {
"script": "Ship faster. Nodaro turns your idea into video.",
"cues": [
{ "id": "c_ship", "text": "Ship faster" },
{ "id": "c_idea", "text": "your idea into video" }
]
},
"scenes": [
{
"id": "scene_hook",
"shots": [{
"id": "shot_1",
"reveals": [
{
"id": "rv_title",
"element": { "id": "t1", "type": "text", "text": "Ship faster", "fontFamily": "Inter", "fontSize": 120, "fontWeight": 900, "color": "#ffffff", "x": 200, "y": 450 },
"revealAt": { "kind": "cue", "cueId": "c_ship", "edge": "start" },
"enter": { "motion": "slide-up", "durationFrames": 12, "easing": "easeOut" }
}
]
}]
}
]
}
```

### עוגנים
| עוגן | מתי האלמנט מופיע |
| --- | --- |
| `{ "kind": "cue", "cueId": "…", "edge": "start" }` | כשהביטוי של סימן הזמן מתחיל. השתמשו ב-`"edge": "end"` לרגע שבו הוא מסתיים, וב-`offsetMs` כדי להזיז אותו מעט. |
| `{ "kind": "frame", "frame": 0 }` | בפריים קבוע, לאלמנטים בלי קריינות, כמו לוגו פתיחה או קטע סיום |

לאלמנט שחייב להיראות בתמונה הממוזערת, בפריים 0, השתמשו ב-`"enter": { "motion": "none", "durationFrames": 0 }`.

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

### כללים ששומרים על תזמון מדויק
- **סימני הזמן חייבים להתאים לתסריט בדיוק**, כולל רווחים. כתבו את הצורה המדוברת: "twenty twenty-six" (אלפיים עשרים ושש), לא "2026", ו-"five dollars" (חמישה דולרים), לא "$5".
- **אסור שסצנות יחפפו בזמן.** לכל סצנה שייך קטע רציף אחד של הקריינות. כשהחשיפות של שתי סצנות חופפות, `resolve_shot_sequence` מחזיר `422 scene_overlap`.
- **גופנים** נלקחים ממשפחות הגופנים הנתמכות, כמו Inter, Roboto, Montserrat, Poppins, Playfair Display, Bebas Neue, Anton, Caveat, Roboto Mono ו-Fira Code. Rubik, Heebo, Cairo ו-Tajawal תומכים בעברית ובערבית.
- **תנועות כניסה** הן `fade`, `scale-up`, `wipe-in`, `slide-up`, `slide-down`, `slide-left`, `slide-right` ו-`none`.
- **תנועות יציאה** הן `fade`, `slide-up`, `slide-down`, `slide-left`, `slide-right` ו-`none`.

סימן זמן שלא נמצא בתמלול עובר לתזמון יחסי כחלופה, ו-`warnings` מציין זאת.

## שרטוטים
שרטוט הוא ביט מונפש מוכן, שממקמים בעזרת חשיפה מסוג `blueprint` וממלאים ב-`params`. הכלי `list_shot_shapes` מחזיר את הקטלוג, והכלי `get_shot_shape` מחזיר את הפרמטרים של שרטוט אחד עם דוגמה מפורטת. שרטוטים לא עולים כלום בעצמם; מחיר הרינדור מכסה את כל הסרטון.

| מזהה | תפקידים | פריימים כברירת מחדל | מה הוא עושה |
| --- | --- | --- | --- |
| `comparison-split` | הצגת יכולת | 180 | שני פאנלים עם תוויות מחליקים פנימה מצדדים מנוגדים ונשארים עם קו מפריד ביניהם; תגים אופציונליים קופצים לקראת הסוף. |
| `constellation-hub` | פתיח, הוכחה חברתית | 180 | נקודות עם תוויות קופצות למעגל סביב מוקד מרכזי, ואז השוט מתמקד בליבה. |
| `cta-morph-press` | קריאה לפעולה | 150 | כפתור מופיע במרכז, וסמן מתקרב לאט ולוחץ עליו. |
| `cursor-ui-demo` | הצגת יכולת, הצגת המוצר | 210 | סמן מוביל את צילומי המסך שלכם דרך לחיצות, והתצוגה עוקבת אחרי כל יעד. |
| `dataviz-countup` | נקודת כאב | 240 | מספר גדול עולה עד ערך מסוים, עם תווית. |
| `device-surface-showcase` | הצגת המוצר, הצגת יכולת | 240 | הדמיית מכשיר נשארת במקומה, והמסכים שלה מתחלפים בין צילומי המסך שלכם, עם כותרות מסונכרנות. |
| `grid-card-assemble` | הצגת יכולת, תועלת, הוכחה חברתית | 180 | כרטיסי טקסט נכנסים בזה אחר זה, כמו מפל, ומסתדרים בשורות ובעמודות. |
| `kinetic-type-beats` | פתיח | 150 | 1–4 שורות הצהרה מתחלפות; האחרונה קופצת בצבע הדגשה. |
| `logo-assemble-lockup` | הצגת המוצר, מיתוג | 180 | האותיות של שם המותג מתחברות ללוגו ממורכז, עם סלוגן אופציונלי. |
| `overwhelm-surround` | נקודת כאב | 210 | כרטיסי כלים מתאספים ותגיות מתפזרות פנימה, ואז דרישות מתקרבות ומקיפות מכל צד. |
| `spatial-pan-stations` | פתיח, נקודת כאב | 240 | תחנות עם תוויות על משטח גדול אחד, שהמצלמה עוברת ביניהן בתנועות פאן חלקות, עם בועת הסבר בכל עצירה. |
| `ticker-takeover` | פתיח, מיתוג | 180 | שורת פתיחה מוקלדת עם מילת הדגשה מתחלפת, ואז האלמנט הראשי מתפרץ פנימה. |
| `titlecard-reveal` | תועלת, הוכחה חברתית | 120 | כותרת נקייה אחת, עם כותרת משנה אופציונלית, שנחשפת בתנועה מאופקת אחת ונשארת על המסך. |
| `typewriter-reveal` | פתיח, מיתוג | 180 | טקסט מוקלד אות אחר אות עם סמן מהבהב; תווית משנה אופציונלית עולה בעמעום כניסה. |
| `waterfall-reveal` | פתיח, הצגת יכולת | 150 | המילים של שורה נכנסות בחיתוך אחת אחת, משמאל לימין; תווית משנה אופציונלית עולה בעמעום כניסה. |

אורכי ברירת המחדל נמדדים בפריימים, ב-30 פריימים לשנייה. הכלי `list_shot_shapes` תמיד מחזיר את הקטלוג העדכני.

## הגדרות המותג
בריף יכול לכלול הגדרות מותג, עם פלטה, גופנים ולוגו, כך שכל שרטוט משתמש בצבעים ובטיפוגרפיה שלכם. בבריף, הגדרות המותג חייבות להיות האובייקט המלא, לא מזהה של ערכה: העתיקו את ההגדרות של ערכה מ-`list_brand_presets`. השדות זהים לשדות בסעיף [מותג](https://nodaro.ai/docs/mcp/video-director#brand) בדף במאי הווידאו.

## שאלות נפוצות

### מה זה רצף שוטים ב-Nodaro?

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

### כמה עולה סרטון של רצף שוטים?

בסרטון של רצף שוטים משלמים בנפרד על הקריינות, על היישור ועל הרינדור. הקריינות עם ElevenLabs v3 עולה 5–33 קרדיטים, היישור המאולץ עולה 33 קרדיטים, והרינדור עולה 55 קרדיטים. המרת התוכנית לפריימים לא עולה כלום.

### למה resolve_shot_sequence מחזיר scene_overlap?

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

### איך צריך לכתוב מספרים בקריינות?

בקריינות של רצף שוטים, כתבו מספרים כמו שאומרים אותם, למשל "twenty twenty-six" (אלפיים עשרים ושש) או "five dollars" (חמישה דולרים). סימן זמן חייב להתאים לתסריט מילה במילה, והיישור מזהה מילים כפי שהן נאמרות.