HyperFrames Studio-Konventionen
Studio zeichnet eine Timeline-Zeile pro Top-Level-Element. Ein Projekt, das den folgenden Regeln folgt, öffnet sich als kurze, lesbare Timeline; eines, das ihnen nicht folgt, öffnet sich als Wand aus unbeschrifteten Zeilen, die der Benutzer nicht bearbeiten kann. Dies sind Konventionen dafür, was gebaut werden soll. Informationen zur Änderung eines Clips finden Sie unter /hyperframes-core references/creator-editing-recipes.md und erfinden Sie niemals eine andere Form derselben Bearbeitung.
1. Jede Szene ist eine Unterkomposition
Die oberste Komposition enthält nur zeitlich angeordnete Hosts, Medien und Audio. Jede Szene mit verschachtelter Struktur (ein Div, das Kinder enthält, ein Titel mit einem Untertitel, ein Diagramm) ist eine eigene Datei, die mit data-composition-src geladen wird, siehe die Verkabelung in references/sub-compositions.md.
Verschachteltes Markup, das in der obersten Komposition verbleibt, wird nicht zu einer eigenen Zeile. Es versteckt sich in einer undurchsichtigen Zeile, die nicht stückweise getrimmt oder verschoben werden kann.
Gestalten Sie so, als ob ein Struktur-Lint jede Verletzung ablehnen würde.
2. Eine Untertitelspur
- Alle Untertitel befinden sich auf einer Spur: einem einzigen Unterkompositions-Host (einem
data-track-index), der mitdata-track-kind="captions"markiert ist und jede Untertitelgruppe der Reihe nach trägt. - Niemals eine Zeile pro Untertitelgruppe und niemals Untertitel mit einer anderen Art auf einer Spur gemischt.
- Die Wortzeitregeln sind unverändert: siehe
/embedded-captionsund diecaption_*Lint-Regeln.
3. Ein Elementtyp pro Spur
Gruppieren Sie nach Typ, sodass jede Zeile ein Ding ist, das der Benutzer als Gruppe auswählen, stummschalten oder ziehen kann.
| Typ | data-track-kind |
|---|---|
| Basisvideo / A-Roll | video (vom Tag) |
| Szenen, Overlays, Grafiken | graphics |
| Untertitel | captions |
| Audio (Voiceover, Musik, Soundeffekte) | audio (vom Tag) |
Setzen Sie data-track-kind auf Unterkompositions-Hosts. Video- und Audio-Typen kommen vom Tag, daher benötigen <video> und <audio> kein Attribut. Geben Sie jedem Typ seinen eigenen data-track-index; die Nummer dient nur der Anzeige; sie ändert nie, was oben gerendert wird. Verwenden Sie CSS für die Überlagerung.
4. Sichere Zonen
Jedes Lineal oder Sicherheitsrahmen-Overlay befindet sich im Vorschaufenster, niemals innerhalb der Komposition, fügen Sie also keine Führungselemente zum HTML hinzu.
Beide Bildformate (breit und vertikal) verwenden die gleichen zwei Sicherheitsrahmen, die Premiere-Standardeinstellungen. Der Vorschaltknopf zeichnet sie mit einer Markierung in der Mitte jeder Kante. Quelle:
ACTION_SAFE_PERCENT und TITLE_SAFE_PERCENT in packages/studio/src/utils/previewSafeMargins.ts.
| Rahmen | Anteil am Bild | Einzug an jeder Kante |
|---|---|---|
| Aktionssicher | 90% | 5% |
| Titelsicher | 80% | 10% |
- Sichere Ränder: Alles Sichtbare bleibt innerhalb der aktionssicheren Box (90%), und Untertitel sowie Schlüsselinhalte bleiben innerhalb der titelsicheren Box (80%).
- Zwei-auf-einem und 50/50-Layouts halten den Inhalt jeder Hälfte innerhalb der titelsicheren Box.
Überprüfung Ihrer Arbeit
Führen Sie hyperframes lint aus und beheben Sie jeden Befund. Öffnen Sie dann das Projekt in Studio und überprüfen Sie, ob die Timeline eine Basiszeile, eine Zeile pro Szenen-Host, eine Untertitelzeile und die Audiozeilen anzeigt.