Référence de création HyperFrames pour ce pont
Cette référence concise est destinée au pont de création. La documentation complète du produit se trouve dans l'application de bureau installée et la documentation officielle d'HyperFrames.
Composition
Un fichier index.html autonome possède une racine de composition directement dans le body. Utilisez data-composition-id, data-width, data-height et une data-duration définie. Les CSS width/height sur la racine sont à 100 % ; les dimensions du canevas appartiennent à ses attributs data-*. Une sous-composition utilise un template avec ses propres styles et scripts à l’intérieur.
Donnez aux clips la classe clip, des attributs data-start/data-duration intentionnels et un data-track-index. Une piste est une lane du Studio, pas une contrainte de timing ni un z-index. La durée racine doit inclure la fin de tous les clips prévus. Préservez les timings, identifiants et médias non liés lors des modifications.
Enregistrez une timeline GSAP unique et en pause dans window.__timelines[compositionId], en utilisant le même ID que la racine. Animez les éléments intérieurs ; le framework contrôle la visibilité des clips et la recherche de médias. N’animez pas display, visibility ou autoAlpha d’un clip. Évitez les conflits CSS-transform/GSAP, les horloges, les temporisateurs, l’aléatoire non initialisé et l’état d’animation dépendant du réseau.
Utilisez des médias reproductibles localement. Chaque élément audio a besoin d’un ID unique et d’un timing intentionnel. Évitez crossorigin sur les médias et les ancêtres temporisés imbriqués autour d’une vidéo avec data-start. Les chemins de fichiers doivent correspondre aux ressources réelles du projet.
Workflow
Lisez les fichiers pertinents et le guide requis de l’application avant de modifier. Respectez le périmètre de la demande de l’utilisateur. Ne prétendez pas exécuter des outils MCP ou des commandes shell indisponibles. Le pont expose les commandes nommées lint, check, timeline et inspect.
Exécutez les vérifications nommées significatives, indiquez leur état de sortie et leurs résultats réels, et préservez les travaux non liés. Une erreur de lint peut empêcher l’exécution des audits d’exécution/mise en page/contraste ; zéro échantillon n’établit pas une validation visuelle réussie. Réussir le lint n’est pas une preuve de qualité visuelle.
Effectuez le rendu uniquement lorsque l’utilisateur demande une exportation et que les app_rules le permettent. Interrogez render_status jusqu’à un état terminal ; ne prétendez jamais qu’une exportation non terminée a réussi. L’application de bureau peut elle‑même gérer l’exportation ; dans ce cas, suivez ses app_rules.
Actifs audio
Lorsque la fonctionnalité locale est activée et demandée, list_voices renvoie les identifiants de voix disponibles de l’utilisateur. create_speech et create_sound_effect renvoient des fichiers MP3 réels relatifs au projet. Utilisez un chemin renvoyé dans la composition avec un ID audio unique et un timing approprié. Si la génération échoue, signalez l’échec et n’inventez pas de ressource ni ne relancez automatiquement.
La parole et les effets sonores sont des appels API du produit effectués avec la propre clé de l’utilisateur. Les scripts/descriptions sont envoyés à ElevenLabs et la génération peut consommer des crédits. Le chat reste textuel uniquement. La génération de musique et d’images/vidéos n’est pas exposée dans cette version.