# שכבה על וידאו

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

Source: https://nodaro.ai/he/docs/nodes/video/video-overlay

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

- Found in: Video › Titles, Graphics & Captions
- API type: `video-overlay`

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

## התחלה מהירה
### הוספת הרכיב
הקישו Tab על הקנבס ובחרו **וידאו › כותרות, גרפיקה וכתוביות › שכבה על וידאו**.

### חיבור הסרטון והתמונות
חברו את סרטון הבסיס לקלט **וידאו**. חברו כל תמונה למחבר שכבה משלה: **שכבה 1**, **שכבה 2** וכן הלאה. הרכיב מתחיל עם 4 מחברי שכבה.

### תזמון ומיקום של כל שכבה
פתחו את חלונית ההגדרות. לכל שכבה, מלאו את השדות **התחלה (שנ׳)** ו**סיום (שנ׳)**, ואז בחרו **מיקום**. גררו שכבה בתצוגה המקדימה של הרכיב כדי להזיז אותה, או משכו את הידית שבפינה שלה כדי לשנות את הגודל שלה.

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

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

- העלאת וידאו → שכבה על וידאו (וידאו)
- העלאת תמונה → שכבה על וידאו (שכבה 1)
- העלאת תמונה → שכבה על וידאו (שכבה 2)
- שכבה על וידאו → הוספת כתוביות (וידאו)
- הוספת כתוביות → פוסט לטיקטוק

## קלטים
| קלט | מקבל | מה הוא עושה |
| --- | --- | --- |
| **וידאו** | רכיבי וידאו, כגון העלאת וידאו ויצירת וידאו | סרטון הבסיס. נדרש. |
| **שכבה 1** עד **שכבה 12** | רכיבי תמונה, כגון העלאת תמונה, יצירת תמונה ושכבת תמונה | תמונה אחת לכל שכבה. שכבה 1 היא המחבר הראשון, שכבה 2 היא השני, וכן הלאה. |
| **תוכנית שכבות** | רשימת JSON של שכבות | אופציונלי. עוד שכבות מתוזמנות, כל אחת עם כתובת URL של תמונה משלה. ראו את הסעיף [קלט תוכנית השכבות](#layer-plan-input). |

הפלט, **וידאו**, הוא הסרטון עם השכבות שהוצבו עליו, כקובץ MP4.

לחצו על **+ שכבה** או על **− שכבה** בחלונית ההגדרות כדי להציג בין 1 ל-12 מחברי שכבה. המספר גדל גם מעצמו כשמחברים משהו למחבר עם מספר גבוה יותר.

### קלט תוכנית השכבות
הקלט **תוכנית שכבות** מקבל רשימת JSON של שכבות, בפורמט השכבות של הרכיב עצמו: `imageUrl`, `start`, `end`, ושדות התיבה `anchor`, `x`, `y`, `width`, `height` ו-`fit`. אפשר להשתמש בו, למשל, עם רכיב שמתזמן כרטיסים של צילומי מסך לקריינות.

- **שכבות התוכנית מוצבות מתחת לשכבות מהמחברים**, כך שתג לוגו שמחובר למחבר נשאר מעליהן.
- **כל שכבת תוכנית צריכה `imageUrl` משלה.** שכבת תוכנית אף פעם לא לוקחת את התמונה שלה ממחבר. שכבת תוכנית בלי תמונה נכשלת עם ההודעה ״שכבת תוכנית 1: אין תמונה — הגדירו imageUrl לשכבה הזו בתוכנית״.
- **שכבות התוכנית נכללות במגבלה.** שכבות מהתוכנית ושכבות מהמחברים יחד יכולות להגיע ל-20 לכל היותר.
- **התצוגה המקדימה מציגה את שכבות התוכנית** כשכבות לקריאה בלבד, עם התווית **מתוכנית השכבות**.
- **תוכנית ריקה מעבירה את הסרטון כמו שהוא.** כשתוכנית שכבות מחוברת ואין שום שכבה להציב, הרכיב מעביר את הסרטון הלאה ללא שינוי, בלי עלות.

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

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

## הגדרות השכבה
לכל שכבה יש כרטיס משלה בחלונית ההגדרות, עם הכותרת **שכבה 1**, **שכבה 2** וכן הלאה.

| הגדרה | מה היא עושה |
| --- | --- |
| **התחלה (שנ׳)** | מתי השכבה מופיעה, בשניות מתחילת הסרטון. ברירת המחדל היא `0`. |
| **סיום (שנ׳)** | מתי השכבה נעלמת. הערך חייב להיות אחרי **התחלה (שנ׳)**. השאירו את השדה ריק כדי להציג את השכבה עד סוף הסרטון. |
| **מיקום** | **כרטיס**, **תג פינה**, **מסך מלא** או **מותאם**. שכבה מחוברת שלא שיניתם היא תג בפינה הימנית התחתונה, לאורך כל הסרטון. |
| **פינה** | במיקום **תג פינה**: **למעלה משמאל**, **למעלה מימין**, **למטה משמאל** או **למטה מימין** (ברירת המחדל). |
| **עוגן**, **הזזה אופקית**, **הזזה אנכית**, **רוחב**, **גובה (% מהפריים, אופציונלי)**, **התאמה (כשמוגדר גובה)** | במיקום **מותאם**. ראו את הסעיף [תיבות מותאמות](#custom-boxes). |
| **סדר שכבות (z)** | מ-0 עד 100. שכבה עם ערך גבוה יותר מוצגת מעל. ערך ריק פירושו מספר השכבה, ולכן שכבה 1 נמצאת בתחתית. גם כפתורי למעלה ולמטה בתצוגה המקדימה קובעים את הערך הזה. |
| **שקיפות** | מ-0 עד 100%. ברירת המחדל היא 100%, כלומר השכבה אטומה לגמרי. ערך נמוך יותר הופך אותה לשקופה יותר. |
| **אנימציית כניסה ויציאה** | המתג מופעל כברירת מחדל. השכבה מופיעה בעמעום כניסה וגדלה מ-96% ל-100% מהגודל שלה במשך 0.15 שנייה, ובסוף שלה עושה את ההפך. |

### מיקומים
כל מיקום וכל גודל נמדדים באחוזים מפריים הפלט.

| מיקום | איפה השכבה ממוקמת |
| --- | --- |
| **כרטיס** | ממורכזת, 4% מעל אמצע הפריים, בתוך תיבה של 78% × 60% מהפריים. התמונה שומרת על יחס הגובה־רוחב שלה. |
| **תג פינה** | 18% מרוחב הפריים, 4% פנימה מהפינה שנבחרה. |
| **מסך מלא** | מכסה את כל הפריים. התמונה נחתכת כדי למלא אותו. |
| **מותאם** | תיבה משלכם. |

שכבה במיקום **כרטיס** ממוקמת מעל אמצע הפריים, ובסרטון סלפי ב-9:16 האזור הזה נמצא מעל הפנים של הדובר. המיקום הזה מכוון: כרטיסי מוצר קופצים מעל הראש המדבר. ללוגו או לתג שאסור להם להסתיר את הנושא, בחרו תג פינה או תיבה מותאמת.

### תיבות מותאמות
- ההגדרה **עוגן** בוחרת אחת מתשע נקודות בפריים: הנקודה שאליה השכבה נצמדת.
- **הזזה אופקית** ו**הזזה אנכית** מזיזות את השכבה מהעוגן, מ-`-100%` עד `100%` מהרוחב ומהגובה של הפריים. הזזה שלילית בעוגן ימני או תחתון מזיזה את השכבה פנימה.
- **רוחב** הוא 1–100% מרוחב הפריים.
- **גובה (% מהפריים, אופציונלי)** הוא 1–100% מגובה הפריים. בלעדיו, הגובה נקבע לפי יחס הגובה־רוחב של התמונה.
- **התאמה (כשמוגדר גובה)** קובעת איך התמונה ממלאת את התיבה: האפשרות **הכלה** מציגה את התמונה כולה, ממורכזת. האפשרות **כיסוי** ממלאת את התיבה וחותכת את התמונה.

מילוי של שדה תיבה כלשהו מעביר שכבה עם מיקום מוכן למיקום **מותאם**. גרירה או שינוי גודל של שכבה כזו בתצוגה המקדימה עושים אותו דבר. תמונה גבוהה שהגובה שלה נקבע לפי יחס הגובה־רוחב שלה מותאמת תמיד לתוך הפריים: תמונה ביחס 1:10 ברוחב 60% על סרטון של 1080×1920 מוצגת בגודל 192×1920. הגדלים מעוגלים כלפי מטה למספר זוגי של פיקסלים, והם לפחות 2×2.

### כללי תזמון
- הזמנים הם בשניות מתחילת הסרטון, מ-0 עד 3,600. הזמנים נשמרים בדיוק שבו הקלדתם אותם, והרינדור ממקם אותם על רשת הפריימים של הסרטון, כך ששכבה יכולה להופיע מוקדם או מאוחר בפריים אחד לכל היותר.
- שכבה שהערך **סיום (שנ׳)** שלה אחרי סוף הסרטון נחתכת בסוף הסרטון.
- הרכיב מדלג על שכבה שמתחילה בסוף הסרטון או אחריו, ולא מוריד את התמונה שלה.
- בשכבה קצרה מ-0.3 שנייה, עמעום הכניסה ועמעום היציאה נמשכים כל אחד חצי מאורך השכבה.

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

## הגדרות הפלט
| הגדרה | מה היא עושה |
| --- | --- |
| **יחס פלט** | **כמו הווידאו** (ברירת המחדל), `16:9` (1920×1080), `9:16` (1080×1920), `1:1` (1080×1080) או `4:5` (1080×1350). עם יחס פלט, האחוזים של השכבות הם מתוך הפריים החדש. |
| **התאמת הווידאו** | רק עם יחס פלט. האפשרות **כיסוי** (ברירת המחדל) ממלאת את הפריים וחותכת את הסרטון. האפשרות **הכלה** מציגה את הסרטון כולו ומוסיפה ריפוד סביבו. |
| **צבע ריפוד** | רק באפשרות **הכלה**. הצבע של הריפוד. ברירת המחדל היא שחור. |

בלי יחס פלט, התוצאה שומרת על גודל התצוגה ועל קצב הפריימים של הסרטון עצמו. קליפ מטלפון שנשמר על הצד מרונדר במצב זקוף, פיקסלים לא ריבועיים מתוקנים, ומידות אי־זוגיות מעוגלות כלפי מטה למספרים זוגיים, כך שמקור של 1079×1919 מרונדר ב-1078×1918.

התוצאה היא קובץ MP4 בקידוד H.264, שמתחיל להתנגן עוד לפני שההורדה שלו הסתיימה. רק רצועת האודיו הראשונה של סרטון הבסיס נשמרת, וסרטון בלי אודיו נשאר שקט.

## מגבלות
- **שכבות:** בין 1 ל-20 בהרצה. ההרצה של רכיב עם יותר מ-20 שכבות שיש להן תמונה נדחית עוד לפני שהיא מתחילה, והכפתור **הרצה** מציין זאת. הסירו שכבות כדי לחזור ל-20; השכבות שנשארות שומרות על המספרים שלהן. אף שכבה לא מושמטת בשקט, ואין חיוב.
- **תמונות:** PNG, JPEG או WebP, עד 25 MB לכל תמונה ו-100 MB ביחד, עד 8,192 פיקסלים בצד הארוך ו-400 מגה־פיקסלים ביחד. נתוני הכיוון שהמצלמה שמרה בתמונה מוחלים.
- **SVG נדחה.** המירו SVG ל-PNG קודם עם רכיב [שכבת תמונה](https://nodaro.ai/docs/nodes/image/image-overlay).
- **תמונות מונפשות**, כגון WebP מונפש ו-APNG, מציגות את הפריים הראשון שלהן.
- **הבסיס חייב להיות סרטון.** קובץ אודיו, תמונה או דף אינטרנט שנשמר כ-`.mp4` מכשילים את ההרצה עם ההודעה "The base input is not a video" (קלט הבסיס הוא לא סרטון).
- **זמן רינדור:** רינדור נעצר אחרי 10 דקות.
- **קצב בקשות ל-API:** עד 30 בקשות לדקה למשתמש.

## אזהרות
הרצה מוצלחת יכולה לדווח על אזהרות. חלונית ההגדרות מציגה אותן בשורה אחת שמתחילה ב**הרצה אחרונה**.

| אזהרה | קוד ב-API | משמעות |
| --- | --- | --- |
| נחתכה | `clipped` | הסוף של השכבה היה אחרי סוף הסרטון, ולכן היא הוצגה עד הסוף. |
| דולגה | `skipped` | השכבה התחילה בסוף הסרטון או אחריו, ולכן היא לא הוצבה. |
| תמונה מונפשת | `animated_first_frame` | התמונה הייתה WebP מונפש, ולכן נעשה שימוש בפריים הראשון שלה. |
| האודיו קודד מחדש | `audio_reencoded` | אי אפשר היה להעתיק את האודיו של הסרטון ל-MP4 כמו שהוא, ולכן הוא קודד מחדש ל-AAC. |

כשכל השכבות מתחילות אחרי סוף הסרטון, ההרצה נכשלת במקום זאת, עם ההודעה "Every layer starts after the video ends" (כל השכבות מתחילות אחרי שהסרטון נגמר). גם תמונת שכבה שאי אפשר להוריד מכשילה את ההרצה, למשל "Layer 3: image could not be fetched" (שכבה 3: אי אפשר היה להוריד את התמונה).

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

## דוגמה: כרטיסי מוצר מעל ראש מדבר
סרטון סלפי ב-9:16 עם שלוש תמונות, וכל אחת מוצגת בזמן שהדובר מזכיר אותה:

| שכבה | תמונה | התחלה (שנ׳) | סיום (שנ׳) | מיקום |
| --- | --- | --- | --- | --- |
| 1 | pricing-page.png | 1.2 | 2.6 | כרטיס |
| 2 | dashboard.png | 3.0 | 4.4 | כרטיס |
| 3 | logo.png | 0 | עד הסוף | תג פינה, למעלה מימין |

בסרטון של 1080×1920, התיבה של כל כרטיס היא בגודל 842×1152 פיקסלים, בנקודה `(119, 307)`. צילום מסך ביחס גובה־רוחב 1:2 מוצב בתוכה בגודל 576×1152 פיקסלים, ממורכז.

אותה בקשה דרך ה-API, `POST /v1/video-overlay`:

```json
{
"videoUrl": "https://example.com/selfie.mp4",
"layers": [
{ "imageUrl": "https://example.com/pricing-page.png", "start": 1.2, "end": 2.6, "preset": "card" },
{ "imageUrl": "https://example.com/dashboard.png", "start": 3.0, "end": 4.4, "preset": "card" },
{ "imageUrl": "https://example.com/logo.png", "start": 0, "preset": "corner-badge", "corner": "top-right" }
]
}
```

עוזרי AI משתמשים בכלי ה-MCP `overlay_images`, שבו כל שכבה מקבלת `url` או `asset_id`. משורת הפקודה, השתמשו ב-`nodaro media video-overlay`.

## טיפים
- **הקפידו שהכרטיסים יהיו קצרים ונפרדים.** הציגו כל כרטיס למשך שנייה או שתיים, ואל תתנו לכרטיסים לחפוף בזמן, כך שבכל רגע יוצג רק כרטיס אחד.
- **השתמשו בפינות לשכבות שנשארות זמן רב.** לוגו, שם משתמש או מחיר שנשארים על המסך זמן רב מתאימים לתג פינה או לתיבה מותאמת, הרחק מהדובר.
- **השתמשו בקובצי PNG שקופים ללוגואים.** JPEG אטום מוצב כמלבן.
- **שמרו על הפריים של הסרטון עצמו.** הגדירו **יחס פלט** רק כשאתם צריכים פריים אחר מזה של המקור.
- **קצצו קודם.** השתמשו ברכיב [קיצוץ וידאו](https://nodaro.ai/docs/nodes/video/trim-video) לפני רכיב שכבה על וידאו כדי לקצר את סרטון הבסיס.
- **הוסיפו כתוביות בסוף.** חברו את התוצאה לרכיב [הוספת כתוביות](https://nodaro.ai/docs/nodes/video/add-captions). השכבות נשארות מתחת לכתוביות.
- **עצבו את התג קודם.** חברו תוצאה של רכיב [שכבת תמונה](https://nodaro.ai/docs/nodes/image/image-overlay) למחבר שכבה כדי להוסיף לסרטון טקסט, קוד QR או תג מעוצב.

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

### כמה תמונות יכול רכיב שכבה על וידאו להציב על סרטון אחד?

רכיב שכבה על וידאו מציב עד 20 שכבות בהרצה. לרכיב על הקנבס יש עד 12 מחברי שכבה לתמונות מחוברות. השכבות 13–20 מגיעות מכתובות URL של תמונות שמוגדרות דרך ה-API, דרך MCP או דרך תבנית.

### האם רכיב שכבה על וידאו משנה את האודיו של הסרטון שלי?

לא. רכיב שכבה על וידאו שומר על האודיו של סרטון הבסיס. האודיו מועתק כמו שהוא כשהוא בפורמט AAC, MP3, AC-3 או Opus, ואחרת הוא מקודד מחדש ל-AAC, וההרצה מדווחת על כך באזהרה.

### למה הכרטיס שלי מסתיר את הפנים של הדובר?

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

### באילו פורמטים של תמונה אפשר להשתמש בשכבה?

התמונה של שכבה ברכיב שכבה על וידאו יכולה להיות בפורמט PNG, JPEG או WebP, עד 25 MB לכל תמונה ו-100 MB ביחד. הרכיב דוחה SVG, ולכן המירו אותו קודם ל-PNG עם רכיב שכבת תמונה. מתמונה מונפשת מוצג רק הפריים הראשון.

### כמה קרדיטים עולה רכיב שכבה על וידאו?

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