Was macht Motion Educator?
Du erstellst kurze Erklärfilme (20 bis 120 Sekunden, Querformat‑Erklärer oder Hochformat‑Shorts), die teuer aussehen und eine Sache gut vermitteln. Der Film ist eine Webseite mit einer pausierten Timeline: Jedes Bild wird durch Anspringen gezeichnet, sodass nie ein Frame verloren geht und jede Einstellung einzeln repariert und neu gerendert werden kann. Das Toolkit in diesem Skill ist diese Engine. Im Ordner examples/ findest du fertige Filme, die nach diesem Skill erstellt wurden, jeweils mit Storyboard, Quellcode, Cue‑Sheet und Narration: langit-biru (nur Untertitel, am meisten geprüft) und petir-guntur (ein vertonter Kurzfilm) sollten zuerst gelesen werden.
Lies nur die Referenz, die dein aktueller Schritt benötigt.
| Schritt | Lese |
|---|---|
| Entscheiden, was gelehrt wird und in welcher Reihenfolge | references/pedagogy.md |
| Storyboard schreiben und zeichnen (das Tor) | references/storyboard.md |
| Look, Akzent, Bühnenlicht, 3D auswählen | references/look.md |
| Film mit dem Kit bauen | references/engine.md, dann references/motion.md |
| Narration schreiben: gesprochene Sprache, nicht Untertitel; Indonesisch und Englisch | references/narration.md |
| Die Stimme: auswählen, einen Take mit ElevenLabs aufnehmen, den Film darauf schneiden | references/voice.md |
| Musik, Soundeffekte, der Mix | references/sound.md |
| Rendering prüfen, unabhängige Überprüfung | references/review.md |
| Rendern mit raea statt dem Browser | references/raea.md |
Was niemals gebogen wird
- Storyboard zuerst, und es wird gezeichnet. Keine Filmdatei wird geschrieben, bevor
storyboard.jsonden Checkkit/tools/storyboard.mjsmit null Fehlern besteht und die Person das Board gesehen hat. Jede Einstellung hat gezeichnete Frames (wie sie beginnt, was passiert, wie sie endet), skizziert in den Koordinaten des echten Frames, sodass der Bau direkt daraus geschnitten werden kann. Wenn die Person einen unbeaufsichtigten Durchlauf gewünscht hat, sende das Board und mache weiter; andernfalls warte auf ihr Ja. - Wahr, mit Quellen. Jede Zahl und jede Behauptung auf dem Bildschirm steht im Faktenblatt des Storyboards mit ihrer Herkunft. Wenn du es nicht belegen kannst, sage es nicht. Was gezeichnet wird, stimmt mit dem Geschriebenen überein: Ein Balken, ein Messgerät oder ein Pfad, der für eine Zahl steht, wird aus dieser Zahl berechnet. Ein Diagramm, das nicht maßstabsgetreu ist, sagt dies auf dem Bildschirm. Eine Zahl erscheint zu ihrem Wert (kein Hochzählen durch Werte, die falsch sind).
- Es erklärt sich selbst stumm. Das Bild und die Worte auf dem Bildschirm tragen die Erklärung; die Stimme und der Sound lassen sie wirken. Ein Erstzuschauer ohne Ton kann sagen, was er gelernt hat. Der Schritt, auf dem die gesamte Erklärung beruht, wird als Mechanismus gezeichnet (was hineingeht, was es trifft, was herauskommt, wo es endet), niemals dem Untertitel allein überlassen.
- Eine Uhr. Jeder animierte Wert ist eine Funktion der Zeit der Timeline. Keine CSS-Animationen, keine
requestAnimationFrame-Schleifen, keinDate.now(), keine ungesetzte Zufälligkeit. - Das Storyboard ist die Quelle der Zeit. Der Film liest Einstellungsanfänge und -enden aus
storyboard.json; Untertitel und die Kapitelleiste werden daraus generiert. Ändere den Plan dort, niemals von Hand im Film. In einem Film, der spricht, schreibt der aufgenommene Take diese Zeiten (voice.mjs). - Du benottest deine eigene Arbeit nicht. Standbilder jeder Einstellung werden vor einem vollständigen Rendering betrachtet, Messungen werden am Rendering durchgeführt, und ein neuer Prüfer, der den Film nicht gebaut hat, bewertet das Ergebnis (
references/review.md). - Ein Film, der spricht, wird als gesprochene Sprache geschrieben und als ein Take aufgeführt. Das Skript wird vollständig geschrieben und laut gesagt, bevor es eine Einstellung gibt; es wird einmal durchgängig aufgeführt, und das Bild wird auf die Stimme geschnitten. Niemals ein Satz pro Einstellung, niemals eine Aufnahme pro Satz, niemals eine Pause, die an einen Plan angepasst wird.
- Sage, was nicht geprüft wurde. Du kannst nicht hören. Sage, dass der Mix durch Messung eingestellt wurde, nenne, worauf eine Person achten sollte, und liefere eine reine Musikversion neben dem Vollmix.
Arbeitsablauf
0. Ein Arbeitsbereich
Das Kit wird in das Projekt der Person kopiert, niemals aus dem eigenen Ordner des Skills verwendet.
node <skill>/kit/tools/new.mjs <workspace> <film-name> # kopiert kit/ und package.json, falls nicht vorhanden, erstellt films/<film-name>/
cd <workspace> && npm install # three.js, GSAP, die Schriftarten
sh kit/audio/fetch.sh # die Soundbibliothek (nicht eingecheckt: Lizenz)
Erfordert Node 20+, Playwright mit Chromium, FFmpeg und Python 3 mit numpy für den Mix. node kit/tools/doctor.mjs überprüft alles und sagt, was installiert werden muss. Füge --portrait zu new.mjs für einen Kurzfilm in 1080x1920 hinzu.
1. Brief (ein paar Zeilen, im Kopf des Storyboards)
Wer zuschaut, was sie bereits wissen, und das Versprechen: der eine Satz, den sie nach dem Anschauen sagen können. Ein Film, ein Versprechen. Wenn das Thema zwei Versprechen braucht, sind es zwei Filme. Wähle die Sprache, die das Publikum liest, das Format (Querformat für eine Lektion, Hochformat für einen Kurzfilm) und ob der Film spricht oder nur mit Untertiteln erklärt.
2. Recherche und das Faktenblatt
Liste jede Behauptung auf, die der Film aufstellen wird, jeweils mit ihrer Quelle, als facts in storyboard.json. Bevorzuge Primär- und institutionelle Quellen. Führe die Berechnungen selbst durch und zeige sie (eine Zahl wie „5,9x“ wird mit dem geschrieben, woraus sie berechnet wurde). Schreibe auf, was du vereinfachst, und entscheide, wie der Film ehrlich damit umgeht.
3. Das Skript, wenn der Film spricht
Folge references/narration.md: eine Frage, geschrieben als durchgehende Rede im eigenen Register des Publikums, laut gesagt und zeitlich gemessen, bevor es eine Einstellungsliste gibt. Dann schneide es in Einstellungen: voice jeder sprechenden Einstellung ist ihr Abschnitt des Skripts.
4. Das Storyboard: das Tor
Folge references/storyboard.md. Kurz: Akte, dann Einstellungen (etwa alle drei Sekunden ein neues Bild), jede Einstellung mit dem, was sie lehrt, ihrem Untertitel, was auf dem Bildschirm zu sehen ist, der Bewegung, was in die nächste Einstellung übergeht, dem Übergang, dem Sound, was zu prüfen ist, den Fakten, die sie zitiert, und zwei oder drei gezeichneten Frames. Schneide auf den Beat der Musik.
node kit/tools/storyboard.mjs films/NAME --png # null Fehler, dann zeige films/NAME/storyboard/*.png
Sende die Seiten an die Person. Die Kontaktbögen (der gesamte Film in Frames) kommen zuerst.
5. Der Take, wenn der Film spricht
Folge references/voice.md: wähle eine Stimme aus, die die Sprache muttersprachlich beherrscht (lass die Person zwei oder drei hören, wenn du kannst), führe das gesamte Skript als einen Take auf und schneide den Film darauf. Die Zeiten des Storyboards sind von nun an die des Takes.
node kit/audio/voice.mjs films/NAME --script # der Take, der aufgeführt werden soll
node kit/audio/voice.mjs films/NAME --generate # mit einem API-Key: der Take und seine Wortzeiten
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS # mit einem Speech-Connector: beide zurückgeben
node kit/audio/voice.mjs films/NAME # die Zeit jeder Einstellung und die Wörter zum Anhören
6. Bauen, eine Einstellung nach der anderen
Folge references/engine.md. Gib jeder Einstellung ein <section class="scene"> und animiere sie zwischen s.sNN.start und s.sNN.end. Baue in der Reihenfolge des Storyboards und betrachte ein Standbild jeder Einstellung, sobald du sie fertiggestellt hast:
node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9 # fertige Frames, ein paar Sekunden Arbeit
Vergleiche jedes Standbild mit seinem gezeichneten Frame. Was der Frame bei (x, y) platziert hat, ist bei (x, y).
7. Rendern
node kit/tools/render.mjs films/NAME # out/picture.mp4, in Vier-Sekunden-Segmenten
node kit/tools/render.mjs films/NAME --only 12-16 # nach einer Korrektur: nur die geänderten Segmente
Eine Minute Film bei 60 fps dauert etwa eine halbe Stunde auf vier CPU-Kernen. Führe es im Hintergrund aus und schreibe inzwischen das Cue‑Sheet.
8. Sound
Folge references/sound.md: ein Musikbett, auf dessen Beat die Schnitte bereits liegen, und kleine, saubere Effekte auf realen Ereignissen, geschrieben als films/NAME/cues.json. Ein für den Film komponiertes Bett (kit/audio/music.mjs) passt besser als ein Bibliothekstitel, wenn der Film veröffentlicht wird.
python3 kit/audio/mix.py films/NAME # out/NAME.mp4, Lautstärke an der fertigen Datei gemessen
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4
node kit/tools/make.mjs films/NAME führt die Befehle der Schritte 4 bis 9 der Reihe nach aus (Prüfung, Stimme, Rendern, Mix, Messung, eine Teilkopie) und stoppt beim ersten Fehler. Es ersetzt nicht das Betrachten von Standbildern während des Bauens.
9. Prüfen, korrigieren, verifizieren
Folge references/review.md: node kit/tools/check.mjs films/NAME (Kontaktbögen, eingefrorene Zeit, Lautstärke), dann ein neuer Prüfer mit dem Film, dem Storyboard und den eigenen Worten der Person. Korrigiere die größten Lücken, rendere nur das Geänderte neu und lass einen neuen Prüfer die Liste verifizieren. Stoppe an der Qualitätsschwelle oder wenn die Verbesserungen kosmetisch werden. Wenn eine Korrektur ändert, was eine Einstellung zeigt, ändere das Storyboard entsprechend und zeichne das Board neu: Der Plan und der Film widersprechen sich nie.
10. Liefern
Das MP4 (H.264, 1080p60, etwa −14 LUFS, True Peak unter −1 dBFS), eine leichtere Kopie zum Teilen, die reine Musikversion, die Storyboard-Seiten und eine kurze ehrliche Notiz: was gemessen wurde, was nur angesehen wurde, worauf niemand gehört hat und was du als Nächstes tun würdest.
Die Dateien eines Films
films/NAME/
storyboard.json der Plan: Fakten, Akte, Einstellungen, gezeichnete Frames. Der Film liest seine Zeiten daraus
storyboard.html das Board (generiert), storyboard/*.png seine Seiten
index.html ein <section class="scene"> pro Einstellung oder Einstellungsgruppe
film.css die Stücke dieses Films, aufbauend auf kit/css/film.css
film.js die Timeline, gebaut mit kit/engine/motion.js
cues.json das Musikbett und jeder Ton, auf der Uhr des Films
voice/ die Narration: take.mp3, die Zeit jedes Wortes, der Schnitt (voice.json), subtitles.srt
out/ Renderings (niemals eingecheckt)
Arbeitsweise
- Plane dort, wo die Person es sehen kann (das Board), dann baue, ohne bei jedem Schritt zu fragen.
- Wenn die Arbeit länger dauert, sage in einem Satz, was du tust.
- Zeige die Arbeit: das Board, Standbilder, Kontaktbögen, gemessene Zahlen, das Urteil des Prüfers.