Conventions Studio pour HyperFrames
Studio dessine une ligne de timeline par élément de premier niveau. Un projet qui suit les règles ci-dessous s'ouvre sous forme d'une timeline courte et lisible ; un projet qui ne les suit pas s'ouvre comme un mur de lignes non étiquetées que l'utilisateur ne peut pas éditer. Ce sont des conventions pour ce qu'il faut construire. Pour savoir comment modifier un clip, suivez le fichier /hyperframes-core references/creator-editing-recipes.md et n'inventez jamais une forme différente de la même édition.
1. Chaque scène est une sous-composition
La composition racine ne contient que des hôtes temporisés, des médias et de l'audio. Toute scène avec une structure imbriquée (un div contenant des enfants, un titre avec un sous-titre, un graphique) est son propre fichier chargé avec data-composition-src, en se connectant aux instructions dans references/sub-compositions.md.
Le balisage imbriqué laissé à l'intérieur de la racine ne devient pas une ligne propre. Il se cache à l'intérieur d'une ligne opaque qui ne peut pas être rognée ou déplacée pièce par pièce.
Rédigez comme si un linter de structure rejetait toute violation.
2. Une seule piste de légendes
- Toutes les légendes vivent sur une seule piste : un seul hôte de sous-composition (un
data-track-index) marquédata-track-kind="captions"qui porte chaque groupe de légendes dans l'ordre. - Jamais une ligne par groupe de légendes, et jamais de légendes mélangées sur une piste avec un autre type.
- Les règles de synchronisation temporelle des mots sont inchangées : voir
/embedded-captionset les règles de lintcaption_*.
3. Un type d'élément par piste
Regroupez par type afin que chaque ligne soit une chose que l'utilisateur peut sélectionner, couper le son ou faire glisser comme un ensemble.
| Type | data-track-kind |
|---|---|
| Vidéo de base / A-roll | video (à partir de la balise) |
| Scènes, superpositions, graphiques | graphics |
| Légendes | captions |
| Audio (voix-off, musique, effets sonores) | audio (à partir de la balise) |
Placez data-track-kind sur les hôtes de sous-composition. Les types vidéo et audio proviennent de la balise, donc <video> et <audio> n'ont besoin d'aucun attribut. Donnez à chaque type son propre data-track-index ; le nombre est purement indicatif ; il ne change jamais ce qui s'affiche par-dessus. Utilisez CSS pour les couches.
4. Zones de sécurité
Toute règle ou superposition de boîte de sécurité réside dans le volet d'aperçu, jamais à l'intérieur de la composition, donc n'ajoutez pas d'éléments de guidage au HTML. Les deux cadrages (large et vertical) utilisent les deux mêmes boîtes de sécurité, les valeurs par défaut de Premiere. L'aperçu les dessine avec un repère au milieu de chaque bord. Source : ACTION_SAFE_PERCENT et TITLE_SAFE_PERCENT dans packages/studio/src/utils/previewSafeMargins.ts.
| Boîte | Part du cadre | Retrait sur chaque bord |
|---|---|---|
| Action-safe | 90% | 5% |
| Title-safe | 80% | 10% |
- Marges de sécurité : tout ce qui est visible reste à l'intérieur de la boîte action-safe (90 %), et les légendes et le contenu clé restent à l'intérieur de la boîte title-safe (80 %).
- Les dispositions en deux volets et 50/50 maintiennent le contenu de chaque moitié à l'intérieur de la boîte title-safe.
Vérification de votre travail
Exécutez hyperframes lint et corrigez chaque constatation. Ouvrez ensuite le projet dans Studio et vérifiez que la timeline affiche une ligne de base, une ligne par hôte de scène, une ligne de légendes et les lignes audio.