Was macht Skriptbasiertes Video?
Ein Video ist hier ein Skript: eine Datei, die festlegt, was gesprochen wird, was auf dem Bildschirm zu sehen ist und wann. Eine kleine
Engine (in starter/) verwandelt es in Bilder in einem Browser und in ein .mp4 mit Ton, Untertiteln und Kapiteln. Da das Video Text ist, können Sie es schreiben, überprüfen, Zeile für Zeile prüfen, jedes Bild ansehen, übersetzen und ein Wort korrigieren, ohne etwas neu bearbeiten zu müssen.
Die Engine ist die einfache Hälfte. Ein Video, das lehrt, braucht eine wahre Geschichte, erzählt in einer Reihenfolge, der der Zuschauer folgen kann, in Worten, die er kennt, mit Bildern, die auf das zeigen, was die Stimme nennt. Der Großteil dieser Fähigkeit dreht sich um diese Hälfte. Befolgen Sie die Phasen der Reihe nach; jede hinterlässt eine Datei, die die nächste liest, sodass die Arbeit eine lange Sitzung überdauert und ein zweiter Agent sie übernehmen kann.
Ziel ist es, ein Video zu übergeben, das der Auftraggeber nicht korrigieren muss. Seine Zeit sind die Kosten, die Sie einsparen. Also: Entscheiden Sie, was Sie entscheiden können, und schreiben Sie die Entscheidung auf; nutzen Sie jeden Dienst, jeden Schlüssel und jede Tatsache, die er angeboten hat; sehen Sie sich das Video vor der Übergabe so an, wie er es tun wird (siehe „Vor der Übergabe“). Die ersten Dinge, die einem Auftraggeber auffallen, sind fast nie Regelverstöße, die ein Prüfer finden kann. Es sind eine Vermutung, die das Video nie beantwortet hat, ein Thema ohne reale Substanz und ein Video, das sich unfertig anhört.
Drei Prinzipien gelten für jedes Video über die Welt. Jedes wird hier einmal genannt; die Phasen unten wenden sie an, und references/research.md gibt die Methode vor.
- Erzählen Sie auf Kerntiefe; recherchieren Sie eine Ebene tiefer. Das Video, das Sie übergeben, ist der Kern: die kürzeste Erzählung, die das Versprechen hält und wahr und fair ist: etwa 10 bis 20 Minuten für ein Thema mit echten Geschichten, weniger für einen einzelnen Mechanismus. Eine vom Auftraggeber genannte Länge ist eine Grenze und hat Vorrang; die Recherchetiefe schrumpft dann mit ihr. Die Recherche geht eine Stufe weiter, bis zur Tiefe eines Details (die Personen, die entscheidenden Tage, die genauen Mittel, die konkurrierenden Figuren, was die Untersuchungen ergaben), sodass der Kern mit Wissen ausgewählt wird und damit benachbarte Themen auftauchen: ein Ereignis, eine Institution oder eine Idee, die das Hauptthema berührt und eine eigene Geschichte hat. Jedes wird zu einer Zeile in
research/next-videos.mdmit dem bereits Bekannten und wird nicht weiter recherchiert. Unterhalb eines Details (das spätere Leben jeder Person, jedes vollständige Dokument, die gesamte Geschichte einer Institution) liegt die Recherche eines anderen Videos: Bei einem Job wuchs das Video dadurch auf sechs Stunden, obwohl der 18-minütige Kern das war, was der Auftraggeber wollte. Längere Versionen werden nur auf Anfrage erstellt. - Jedes reale Beispiel zeigt das Hauptthema in Aktion. Eine wahre Geschichte kommt nur dann in das Video, wenn die Sache, um die es in dem Video geht, darin tatsächlich vorkommt, so wie die Quellen es erzählen: für ein Video über Terminmärkte, Terminkontrakte, die an einer Börse gehandelt werden, Margin Calls, ein erfüllter Kontrakt. Eine Geschichte, die nur in der Nähe liegt (die gleichen Jahre, ein berühmter Name, eine Wette, die ähnlich aussieht, aber auf andere Weise abgeschlossen wurde), bleibt draußen, so berühmt sie auch sein mag und selbst wenn der Auftraggeber sie vorgeschlagen hat. Überprüfen Sie dies an den Quellen in Runde 1, bevor Sie Tiefe darauf verwenden. Bei einem Job stellte sich die berühmteste Geschichte, die für ein Futures-Video angeboten wurde, als eine Wette heraus, die durch private Geschäfte mit Banken abgeschlossen wurde; sie wurde entfernt, nachdem zwei Ausgaben sie erzählt hatten. Kurz ist jedoch nicht dünn: Im Kern wird jedes reale Beispiel mit seinen Personen, seinem Datum, den genauen Mitteln, den Beträgen, wie es hätte schiefgehen können, wie es endete und was es über das Hauptthema zeigt, erzählt.
- Die Recherche hat eine Grenze und ein Ende. Jede Spur wird am Hauptthema getestet, bevor eine Suche darauf verwendet wird; eine, die nicht passt, wird in einer Zeile notiert und fallengelassen („interessant“ öffnet sie nicht). Es gibt drei geplante Runden (die Gliederung, das Detail und eine doppelte Überprüfung aller Aussagen des Videos an den Quellen) und eine kurze vierte nur für benannte Elemente, die der Kern benötigt. Mehr ist die Entscheidung des Auftraggebers.
Standardzuschauer: jemand, der das Thema zum ersten Mal kennenlernt. Schreiben Sie so, dass ein 8-Jähriger folgen könnte, in ruhiger, professioneller Formulierung, die ein Erwachsener nicht kindisch finden würde. Einfach ist nicht dasselbe wie kindisch: kurze Sätze, alltägliche Wörter, eine Idee nach der anderen, kein Babytalk. Ändern Sie dies nur, wenn die Aufgabenstellung einen anderen Zuschauer nennt.
Einrichtung
Kopieren Sie den Ordner starter/ dieser Fähigkeit in das Projekt des Benutzers (z. B. als video/), dann:
cd video
npm install # eine kleine Abhängigkeit; es verwendet das bereits auf dem Rechner vorhandene Chrome
node tools/check.mjs # das Beispielvideo sollte bestehen
Erfordert: Node 18 oder neuer; Chrome, Edge oder Chromium (zum Zeichnen von Bildern); ffmpeg (zum Aufnehmen der Stimme und zum Exportieren). Wenn eines fehlt, siehe references/troubleshooting.md. Arbeiten Sie nicht im Fähigkeitsordner selbst; arbeiten Sie in der Kopie.
Die Kopie enthält ein Beispiel, videos/hello.json: fünfzehn Sekunden in einfachen Daten, mit einer Übersetzung und einem vertikalen Layout, das zur Überprüfung der Einrichtung dient. Was jede Phase produzieren soll, steht in den Dateien, die node tools/new.mjs erstellt: jede beginnt mit ihrer eigenen Checkliste. Löschen Sie das Beispiel, wenn das eigene Video des Benutzers in Arbeit ist.
Die Phasen
Starten Sie jedes Video mit node tools/new.mjs <id> "<Titel>". Es erstellt notes/<id>/ (die unten genannten Dateien mit ihren Checklisten) und ein Skriptgerüst in videos/<id>.mjs.
| # | Phase | Sie produzieren | Erledigt, wenn | Lesen Sie |
|---|---|---|---|---|
| 0 | Briefing | notes/<id>/brief.md | Zuschauer, Versprechen („Nach dem Ansehen kann der Zuschauer …“), Länge, Form und Sprache sind festgehalten, mit allem, was der Auftraggeber namentlich verlangt hat. | unten |
| 1 | Recherchemethode | research/00-how-to-research.md | Sie wissen, wie Menschen, die dieses Fachgebiet kennen, Dinge herausfinden und wo Anfänger Fehler machen. | references/research.md |
| 2 | Recherche, in drei Runden | research/NN-name.md, research/leads.md, research/next-videos.md, research/index.md | Jede Spur in leads.md ist abgeschlossen (recherchiert, nicht gefunden, nächstes Video, nebensächlich oder offen); jedes reale Beispiel besteht den Beispieltest und ist bis zur Tiefe eines Details bekannt; andere Ansichten und Mythen sind recherchiert; Runde 3 hat jede Behauptung, die für das Video bestimmt ist, an ihrer Quelle nochmals gelesen, und jede hat eine Quelle und ein Konfidenzlabel; was der Auftraggeber erinnert, hat ein Urteil. Die vollständige Liste: references/research.md, Abschnitt 11. | references/research.md |
| 3 | Mindmap | mindmap.json | Jede recherchierte Idee ist core (im Video), support (recherchiert und wahr, nicht im Kern enthalten) oder cut (unbestätigt, unfair oder nebensächlich); die core-Ideen allein halten das Versprechen; node tools/mindmap.mjs <id> meldet keine Fehler. | references/planning.md |
| 4 | Storyboard | storyboard.md, assets.md | Jeder Beat hat ein Bild, einen Kern, eine Komponente und einen Ton (normalerweise keinen); die Kontrollen am unteren Ende sind abgehakt. | references/planning.md |
| 5 | Skript | videos/<id>.mjs | node tools/check.mjs <id> meldet keine Fehler und Sie haben jede Warnung gelesen. Das Skript hat Kernlänge. | references/authoring-kit.md, references/components.md |
| 6 | Genauigkeitsprüfung | review/accuracy.md, research/index.md (review/coverage.md nur für einen vollständigen Bericht) | Jede Zeile von dump --claims hat ein Urteil und eine Quelle; für jede wahre Geschichte hat ein Prüfer, der sie nicht geschrieben hat, Skript, Notizen und Quellen verglichen (oder, wenn kein zweiter Agent vorhanden ist, haben Sie es getan, und die Datei sagt „nicht unabhängig"); die Recherche wurde nochmals mit dem Skript verglichen, und was der Kern brauchte und nicht hatte, ist jetzt darin; Korrekturen wurden in die Notizen zurückgeschrieben. | references/script-review.md |
| 7 | Verständnisprüfung | review/WhatIHaveLearned.md, review/lost-points.md | Das Tagebuch erreicht das Versprechen ohne Lücke, und jeder Weg, sich zu verlieren, hat eine Lösung oder einen Grund. | references/script-review.md |
| 8 | Visuelle Prüfung | review/visual.md | Sie haben jedes Standbild angesehen und nichts ist abgeschnitten, verdeckt, leer oder unlesbar. | references/visual-review.md |
| 9 | Stimme und Ton | aufgenommene Zeilen in out/tts/, Sounds in assets/<id>/ | Das Skript hat die Phasen 6 bis 8 bestanden und die Stimme ist aufgenommen; das Timing folgt nun der echten Stimme. Ereignisgeräusche sind gesetzt; Musik, falls vorhanden, liegt nur unter Geschichtsteilen. | references/voice-and-assets.md |
| 10 | Export und finale Ansicht | out/<id>.mp4, .srt, .vtt, .chapters.txt | Sie haben Bilder der exportierten Datei selbst angesehen und ihren Ton überprüft. | references/export-and-publish.md |
| 11 | Andere Sprachen und Formen (falls gewünscht) | videos/i18n/<id>.<lang>.json | Jede Sprache besteht die check, und ihre Standbilder wurden angesehen. | references/localization.md |
| 12 | Veröffentlichungsset | publish.md | Titel, Beschreibung, Kapitel, Untertitel, Vorschaubild, Quellen und Danksagungen sind bereit. | references/export-and-publish.md |
| 13 | Übergabe | die Nachricht an den Auftraggeber | Die Prüfung aus Auftraggebersicht ist erledigt; die Nachricht sagt, was entschieden wurde, was korrigiert wurde und was noch offen ist. | references/finishing-and-revising.md |
Schreibregeln, die ab Phase 4 gelten, finden Sie in references/writing-for-everyone.md
(Wörter und Sätze) und references/teaching-techniques.md (wie man eine Idee vermittelt).
references/visual-design.md behandelt Layout, Farbe und Bewegung. Lesen Sie diese drei, bevor Sie Ihr erstes Skript schreiben.
Phase 0: das Briefing
Füllen Sie brief.md basierend auf dem aus, was der Benutzer gesagt hat. Schreiben Sie für alles andere Ihre beste Annahme auf und markieren Sie sie „(angenommen)"; halten Sie nicht an, um zu fragen (siehe „Entscheiden, aufzeichnen, weitermachen").
Die wichtigste Zeile ist das Versprechen: ein Satz, der mit „Nach dem Ansehen kann der Zuschauer …" beginnt. Jede spätere Entscheidung (was recherchiert, was gestrichen wird, wann das Video fertig ist) wird daran gemessen. Notieren Sie auch, was der Zuschauer bereits weiß, denn dort beginnt das Video.
Kopieren Sie in das Briefing, in den eigenen Worten des Auftraggebers, alles, was er namentlich verlangt hat: einen zu verwendenden Dienst, einen Schlüssel und wo er sich befindet, ein Beispiel oder Ereignis, das aufgenommen werden soll, eine Tatsache, an die er sich erinnert, einen Teil, den er verwirrend fand, eine Einschränkung („großteils ohne Musik"). Jedes davon ist eine Zeile, die vor der Übergabe abgehakt werden muss. Ein genannter Dienst wird jetzt auf Erreichbarkeit geprüft, nicht erst in Phase 9; eine Tatsache, an die er sich erinnert, geht an die Recherche als etwas, das zu überprüfen ist, nicht als etwas, das wiederholt werden soll.
Entscheiden Sie hier, ob eine Recherche erforderlich ist. Überspringen Sie die Phasen 1 und 2 nur, wenn der Inhalt vollständig vorgegeben ist (das eigene Produkt des Benutzers, ein von ihm geschriebenes Skript, ein von ihm beschriebener Prozess) und Sie keine eigenen Fakten hinzufügen. Wenn Sie auch nur eine Zahl, ein Datum, einen Namen oder ein „weil" hinzufügen würden, recherchieren Sie es.
Phasen 1 und 2: Recherche
Bevor Sie das Thema recherchieren, recherchieren Sie wie man es recherchiert: zwei oder drei Suchen darüber, wie Menschen dieses Feld lernen und untersuchen, und eine Ebene darüber (für den Anleihemarkt: „wie man den Anleihemarkt versteht", dann „wie man etwas über die Wirtschaft lernt"). Sie sagen Ihnen, welche Quellen zählen, welche Zahlen wichtig sind und wo Anfänger Fehler machen. Dann drei Runden:
- Die Gliederung. Eine Notiz pro Thema, mit einer Zusammenfassung oben: Fakten mit Quellen, reale Ereignisse (jeweils zuerst durch den Beispieltest), alltägliche Vergleiche und die stärksten Gegenansichten und Mythen, genauso sorgfältig recherchiert wie die Hauptlinie.
- Das Detail. Listen Sie jede Person, jeden Ort, jedes Datum, jede Zahl, jeden Begriff, jeden Mechanismus, jede Ursache und jedes Zitat, das die Notizen erwähnen, ohne es zu erklären, in
research/leads.mdauf. Recherchieren Sie diejenigen, die das Hauptthema betreffen, einmal, bis zur Tiefe eines Details. Benachbarte Themen gehen innext-videos.md; der Rest wird als nebensächlich markiert. - Die doppelte Überprüfung. Keine neuen Themen. Lesen Sie alles, was das Video sagen wird, erneut an seiner Quelle; finden Sie eine zweite, unabhängige Quelle für die überraschenden Behauptungen, die Zahlen, die die Größe der Geschichte angeben, die Zitate und alles, was sich negativ auf eine namentlich genannte Person auswirkt.
Planen Sie die Suchen, bevor Sie beginnen, und heben Sie ein Drittel für Runde 3 auf. Wenn Sie andere Agenten starten können, geben Sie jedes reale Ereignis einem eigenen Agenten und die doppelte Überprüfung einem, der die Notiz nicht geschrieben hat.
Zwei Dinge, auf die das fertige Video zurückgreifen können muss:
- Reale Ereignisse, bekannt bis zur Tiefe eines Details. Eine erfundene Person macht eine Idee leicht verständlich; ein reales Ereignis lässt den Zuschauer daran glauben und es sich merken. Für ein Thema mit einer Geschichte (ein Markt, eine Technologie, eine Institution) recherchieren Sie mindestens zwei. Wenn eines zeigt, wie jemand gewinnt, recherchieren Sie, wie es hätte scheitern können, und finden Sie eines, bei dem jemand verloren hat: Ein Sieg allein lehrt die falsche Lektion. Für einen Mechanismus der Natur oder eine Methode (warum der Himmel blau ist, wie man einen Knoten macht) reicht eine reale Beobachtung, Messung oder Entdeckung, oder keine: Schreiben Sie „keine, weil …" in das Briefing.
- Was der Auftraggeber erinnert, überprüft. Es ist eine Spur und oft teilweise falsch. Überprüfen Sie jeden Teil, verwenden Sie, was zutrifft, und teilen Sie ihm mit, was Sie korrigiert haben und warum; wiederholen Sie niemals eine Behauptung, weil „der Auftraggeber es gesagt hat", und lassen Sie sie niemals stillschweigend weg.
Einzelheiten: references/research.md.
Phase 3: die Mindmap
mindmap.json ist ein kurzer Baum jeder Idee, die das Video enthalten könnte (Knotenarten sind in references/planning.md Abschnitt 1 aufgelistet; node tools/mindmap.mjs nennt sie, wenn eine falsch ist). Jeder Knoten sagt in wenigen Worten, was die Idee ist, wo ihre Details in der Recherche leben ("file.md#Heading"), welche Ideen der Zuschauer zuerst braucht und mit welchen anderen Ideen sie verbunden ist. Jede Idee ist core (im Video: das Versprechen braucht sie, eine wahre Geschichte kann nicht ohne sie erzählt werden, oder Fairness erfordert sie), support (recherchiert und wahr, nicht im Kern enthalten: Material für die Beschreibung, eine längere Version, falls der Auftraggeber fragt, oder ein nächstes Video) oder cut (unbestätigt, kann nicht fair erzählt werden oder hat nichts mit dem Hauptthema zu tun; eine reale Geschichte, die den Beispieltest nicht besteht, ist cut). Das Werkzeug prüft, dass jeder Zeiger irgendwohin führt und dass nichts gelehrt wird, bevor das Nötige dafür vorhanden ist. Einzelheiten: references/planning.md.
Phase 4: das Storyboard
Eine Tabelle, eine Zeile pro Beat: was der Zuschauer sieht, der Kern dessen, was die Stimme sagt, welche Komponente es zeichnet, ob ein neues Wort erscheint und was außer der Stimme zu hören ist (für Musik „Musik: "; für Soundeffekte das Ereignis, z. B. „Klick", „Krachen", „Nähmaschine"; lassen Sie die Soundeffekte, die die Engine von sich aus erzeugt, weg – siehe references/components.md). Die Spalten sind unten aufgeführt.
Jede Zeile ist ein Beat: die kleinste Einheit, die der Zuschauer als einen Moment erlebt, normalerweise ein bis drei Sätze oder eine Animation, die einen Punkt macht. Zwei bis fünf Beats bilden eine Szene; eine Szene deckt einen Schritt der Logik oder einen Teil der Geschichte ab.
Spalten (von links nach rechts):
- SZENE – ein Name wie „Öffnung" oder „Die Pleite von Barings". Zeilen, die zur gleichen Szene gehören, teilen sich diese Zelle. Sie können sie in der ersten Zeile der Szene ausfüllen und die anderen leer lassen.
- SEHEN – was auf dem Bildschirm ist. Ein bis zwei Sätze; bei Bedarf eine Skizze.
- STIMME – die Kernaussage dessen, was der Sprecher sagt. Ein bis zwei Sätze des Skripts; Sie werden später jedes Wort daraus schreiben.
- KOMPONENTE – aus
references/components.md. Meistensfallback-slide,code,two-columnsodercustom. Der Name der Komponente ist die CSS-Klasse; verwenden Sie den genauen Namen. - WORT – ein neues Wort, das der Zuschauer an dieser Stelle zum ersten Mal sieht oder hört. Füllen Sie es nur aus, wenn eines ankommt.
- TON –
Stimme(Standard, lassen Sie es leer, wenn es nichts anderes gibt),Musik: <Stimmung>,Sound: <Ereignis>oderStille.
Einzelheiten: references/planning.md Abschnitte 4–6, mit dem vollständigen Tabellenformat in Abschnitt 4.
Phase 5: das Skript
Schreiben Sie videos/<id>.mjs. Das Format ist in references/authoring-kit.md definiert; die verfügbaren Komponenten sind in references/components.md aufgeführt und die Engine zeigt eine Fehlermeldung, wenn Sie eine falsche eingeben.
Füllen Sie für jeden Beat das voice-Feld mit den genauen Wörtern, die der Sprecher sagt. Verwenden Sie einen .mjs-Export (ein Objekt mit metadata, slides und voice; siehe das Beispiel). Setzen Sie voice.speed erst, nachdem Sie die Audiodatei aufgenommen haben (Phase 9).
Schreiben Sie das Skript auf Kernlänge. Wenn der Auftraggeber eine bestimmte Minutenanzahl genannt hat, ist dies eine Grenze; lassen Sie die Recherche und die Ideen, die sie gestützt haben, in den Notizen, aus denen eine längere Version erstellt werden kann.
Zwei-Regel: Verwenden Sie für jede Idee zwei Arten, sie zu zeigen: die Stimme sagt es, und das Bild zeigt es, oder ein Beispiel veranschaulicht es, oder es wiederholt sich in einer anderen Form. Der Zuschauer erhält die Idee also über zwei Kanäle oder zwei Instanzen. Wenn Sie nur eine haben, überlegen Sie, ob diese Idee so wichtig ist, dass sie ihren eigenen Beat verdient – und wenn nicht, ob sie weggelassen werden kann, ohne das Versprechen zu brechen.
Die drei schlimmsten Fehler in Skripten, die hier geschrieben wurden: (1) Der Sprecher beschreibt, was bereits auf dem Bildschirm zu sehen ist, anstatt es zu erweitern. Wenn das Bild die Idee bereits zeigt, sagen Sie entweder nichts (lassen Sie eine Pause) oder sagen Sie, warum es wichtig ist. (2) Der Sprecher sagt eine Zahl, ohne zu sagen, was sie bedeutet („21,4 Milliarden" – im Vergleich zu was?). Sagen Sie immer die Einheit und die Richtung oder den Vergleich. (3) Der Sprecher wechselt den Gegenstand oder die Zeit in der Mitte eines Beats. Ein Beat hat ein Subjekt und eine Zeit; wenn eines davon wechselt, beginnen Sie einen neuen Beat.
Einzelheiten: references/authoring-kit.md (was in jeder Eigenschaft steht, Namenskonvention, wie man eine Pause setzt). references/teaching-techniques.md (Reihenfolge der Ideen, Analogien, Metaphern, Beispiele). references/writing-for-everyone.md (Satzlänge, Wortschatz, Komplexität).
Phase 6: Genauigkeitsprüfung
Führen Sie dump --claims aus (das Werkzeug ist in node tools/check.mjs integriert; fragen Sie, wie es geht) für jede Behauptung. Jede muss ein Urteil haben und woher Sie es wissen. Für jede wahre Geschichte: Ein Prüfer, der sie nicht geschrieben hat, hat das Skript, die Notizen und die Quellen verglichen (oder, wenn kein zweiter Agent vorhanden ist, sagen Sie „nicht unabhängig" im Review). Vergleichen Sie die Recherche erneut mit dem Skript: Ist etwas, das im Kern sein sollte, nicht dort? Ist eine Quelle anders, als Sie sie geschrieben haben?
Schreiben Sie Korrekturen in die Notizen zurück. Löschen Sie keine Notiz, weil das Skript sie nicht verwendet hat; sie könnte für ein nächstes Video nützlich sein oder für eine spätere Frage des Auftraggebers. Markieren Sie sie als „nicht im Kern " im Index, wenn das die sauberste Art ist, sie aufzubewahren.
Einzelheiten: references/script-review.md.
Phase 7: Verständnisprüfung
Sie spielen den Zuschauer. Öffnen Sie die Videodateien, das Storyboard und das Skript. Schreiben Sie ein kurzes Tagebuch (WhatIHaveLearned.md) darüber, was Sie nach jedem Abschnitt verstanden haben. Wenn das Tagebuch das Versprechen nicht auf natürliche Weise erreicht – wenn es eine Lücke gibt, in der etwas fehlt, oder einen Spring, bei dem der Zuschanner raten muss, wie man von A nach B kommt –, markieren Sie die Stelle in lost-points.md und schlagen Sie eine Korrektur vor.
Lesen Sie das Skript auch einer Person vor, die das Thema nicht kennt (oder stellen Sie es sich vor). Halten Sie an jeder Stelle inne, an der Sie zögern. Jedes Zögern ist ein verlorener Punkt.
Einzelheiten: references/script-review.md Abschnitt „Verständnisprüfung".
Phase 8: Visuelle Prüfung
Öffnen Sie die Vorschau im Browser (node tools/preview.mjs <id> oder wie im Kit beschrieben). Gehen Sie jeden Frame durch – oder lassen Sie die Engine im Zeitraffer laufen und halten Sie an zufälligen Stellen an. Prüfen Sie:
- Ist der Text lesbar? (Größe, Kontrast, Überlappung)
- Ist das Bild vollständig? (Nichts abgeschnitten, kein leerer Bereich, auf den der Sprecher zeigt, der aber nicht da ist)
- Funktioniert die Animation, wenn es eine gibt? (Kein Ruckeln, keine leeren Frames)
- Ist der Farbeindruck für Farbenblinde zugänglich? (Wenn Sie die Engine-Farbe verwenden, ist dies bereits erledigt; wenn Sie benutzerdefinierte Farben haben, überprüfen Sie es.)
Einzelheiten: references/visual-review.md.
Phase 9: Stimme und Ton
Nehmen Sie die Stimme auf (das Engine-Kit enthält eine TTS-Brücke; siehe references/voice-and-assets.md). Nach der Aufnahme setzen Sie voice.speed in der Videodatei, sodass die Dauer der Zeilen mit den tatsächlichen Audiodateien übereinstimmt.
Legen Sie für jeden Beat, der einen Soundeffekt benötigt, die Audiodatei in assets/<id>/ ab und referenzieren Sie sie in der Komponente (jede Komponente hat ein sound-Feld; siehe das Kit). Begrenzen Sie Soundeffekte auf eine pro Beat, es sei denn, die Szene erfordert mehrere (z. B. eine Baustelle). Verwenden Sie Musik sparsam: nur unter Geschichtsteilen (nicht unter Voiceover, nicht unter Erklärungen) und nur, wenn sie die Stimmung verstärkt, nicht, wenn sie nur den Raum füllt.
Einzelheiten: references/voice-and-assets.md.
Phase 10: Export und finale Ansicht
Exportieren Sie die .mp4 (das Engine-Kit enthält ein Skript dafür; siehe references/export-and-publish.md). Prüfen Sie:
- Öffnen Sie die
.mp4und sehen Sie sie sich an (nicht nur die Vorschau im Browser – die Export-Engine kann die Farben oder die Schriftart ändern). - Hören Sie den gesamten Ton: keine Verzerrungen, keine toten Stellen, die Musik überdeckt nicht die Stimme.
- Die Untertitel (
srt/vtt) sind vorhanden und ihre Zeiten stimmen. - Die Kapiteldatei (
chapters.txt) hat die richtigen Zeiten.
Wenn der Auftraggeber mehrere Formate verlangt hat (vertikal, quadratisch), exportieren Sie jedes.
Einzelheiten: references/export-and-publish.md.
Phase 11: Andere Sprachen und Formen (falls gewünscht)
Erstellen Sie eine Übersetzungsdatei in videos/i18n/<id>.<lang>.json. Das Format ist in references/localization.md definiert; die Engine wendet sie an, wenn Sie node tools/preview.mjs <id> --lang <lang> ausführen.
Übersetzen Sie die Stimme, den Text auf dem Bildschirm (in den Komponenten) und alle Untertitel, die nicht automatisch aus der Stimme generiert werden. Passen Sie die Längen an, wenn die Übersetzung länger oder kürzer ist als das Original; Sie müssen möglicherweise die Beat-Grenzen verschieben oder Frames hinzufügen. Die Engine warnt Sie, wenn eine übersetzte Zeile die Bildschirmbreite überschreitet.
Zeigen Sie jedes Standbild für die übersetzte Sprache an (Phase 8); eine andere Sprache kann andere visuelle Probleme verursachen.
Einzelheiten: references/localization.md.
Phase 12: Veröffentlichungsset
Schreiben Sie publish.md mit:
- Titel und Beschreibung (für YouTube, Vimeo usw.)
- Kapitelmarken (aus der Kapiteldatei, mit Beschreibungen)
- Untertitel (aus den
.vtt- oder.srt-Dateien) - Vorschaubild (welches Standbild oder ob ein benutzerdefiniertes erstellt werden soll)
- Quellen (Liste der verwendeten Quellen, mit Links, falls öffentlich)
- Danksagungen (falls Sie Musik oder Töne von Drittanbietern verwendet haben)
Einzelheiten: references/export-and-publish.md.
Phase 13: Übergabe
Bevor Sie die Datei an den Auftraggeber senden, sehen Sie sie sich als Auftraggeber an:
- Öffnen Sie die
.mp4– nichts weiter. Sehen Sie sie sich vom Anfang bis zum Ende an. Notieren Sie den ersten Moment, in dem Sie innehalten oder sich eine Frage stellen. Dieser Moment ist das, was der Auftraggeber als Erstes bemerken wird. - Dann lesen Sie das Briefing noch einmal. Haben Sie alles getan, was auf der Liste stand? Wenn nicht, sagen Sie warum.
- Ist das Versprechen erfüllt? Wenn nicht, sagen Sie, was noch offen ist.
Senden Sie:
- Die
.mp4(oder mehrere, falls erforderlich). - Die Untertiteldatei(en) und die Kapiteldatei.
publish.md.- Eine kurze Nachricht mit dem, was Sie entschieden haben (z. B. „Ich habe den Abschnitt über X weggelassen, weil die Quellen zeigten, dass er nicht zum Hauptthema gehört"), was Sie korrigiert haben („Eine der Zahlen war falsch; ich habe sie durch die korrekte aus Quelle Y ersetzt") und was noch offen ist („Die Übersetzung ins Französische ist noch nicht fertig; ich sende sie morgen nach").
Entscheiden, aufzeichnen, weitermachen. Wenn eine Frage während der Arbeit auftaucht (soll ich diesen Punkt aufnehmen? Diese Quelle? Diese Szene um 5 Sekunden verlängern?), treffen Sie eine Entscheidung, schreiben Sie sie im Briefing oder in den Recherchenotizen auf und machen Sie weiter. Halten Sie nicht an, um den Auftraggeber zu fragen, es sei denn, die Entscheidung könnte das Versprechen brechen oder ihn dazu zwingen, das fertige Video abzulehnen. Wenn Sie anhalten müssen, fragen Sie eine Sache auf einmal, mit einer kurzen Erklärung der Optionen, und setzen Sie eine Frist („Bitte antworten Sie bis zum Ende des Tages, damit ich das Video morgen fertigstellen kann").
Einzelheiten: references/finishing-and-revising.md.
Lösung häufiger Probleme
Siehe references/troubleshooting.md. Enthält: Engine startet nicht, Chrome nicht gefunden, Fehler bei der Abhängigkeit sharp, Export schlägt fehl, TTS-Dienst verweigert, ffmpeg fehlt, die Liste der erwarteten CLI-Befehle.