Parcours

Chaque parcours ci-dessous est un skill du plugin. Un agent branché sans le plugin peut suivre les mêmes étapes.

Importer une vidéo de votre ordinateur

Demandez : « Importe ~/Videos/talk.mp4 dans Brollss et préviens-moi quand le transcript est prêt. »

1. Une seule source : un fichier de l'appareil, ou un lien direct vers un fichier média. Une page qui lit une vidéo, comme une page YouTube, n'est pas un fichier média. Un fichier par projet.
2. Appelez import_media. Pour un fichier, déclarez-le dans add_media, sous son nom : {"talk.mp4": {"content_type": "video/mp4", "file_size": 734003200}}, avec la taille exacte en octets. Pour un lien, passez url tel que la personne l'a donné.
3. import_media répond tout de suite avec job_id, project_id et project_url. Montrez project_url.
4. Pour un fichier, envoyez ses octets bruts en PUT à upload_urls[<nom>].upload_url avec Content-Type: application/octet-stream. Ni formulaire ni encodage, exactement file_size octets. L'adresse sert une fois. Si l'envoi échoue, appelez report_upload_status avec status: "failed".
5. Appelez wait_for_job avec job_id et wait_seconds: 20, puis encore jusqu'à done: true. Après chaque appel, donnez progress.label et progress.percent.
6. Une réponse timed_out: true veut dire que l'import continue. Rappelez wait_for_job sur le même job_id. Ne réimportez jamais : cela crée un deuxième projet.
7. Quand le travail est fini, lisez le projet avec get_project_state et dites ce qui a été créé. Un projet que vous venez d'importer est la copie de la personne : montez-le directement.

Un refus pour le nombre de projets ou la taille du fichier est la limite que l'application applique. Dites laquelle et arrêtez-vous. Un path sur la machine ne marche qu'avec un serveur Brollss local ; le serveur hébergé le refuse.

Monter de bout en bout

Demandez : « Fais un montage publiable de mon dernier projet Brollss : plus serré, une accroche forte, des scènes là où elles aident, sous-titres et musique. »

Avant la première écriture

1. Trouvez le projet avec list_projects. Les copies portent souvent le même nom : distinguez-les par createdAt. Ne devinez jamais un id.
2. Sauf si la personne a nommé le projet à modifier tel quel, ou si vous l'avez importé dans cette session, appelez clone_project et travaillez sur la copie.
3. Appelez get_editing_guide avec le projectId : il porte la façon de travailler et les consignes permanentes de la personne. Lisez le guide de style qui convient avec style.
4. Appelez get_project_state et gardez son editRevision.
5. Lisez toute la vidéo avant la première coupe : transcript_outline, puis read_transcript passage par passage. Les clés de mots comme 12:4 viennent de ces lectures.

Le montage

1. Coupes. find_hesitations liste les hésitations, répétitions et faux départs. Coupez ce qui casse le rythme avec strike_words, gardez la meilleure prise d'une reprise, coupez les digressions entières. Lisez le fallout de chaque coupe et réparez ce qui est tombé avec. set_silences raccourcit les longues pauses.
2. Accroche. Ouvrez sur la phrase la plus forte avec move_passage, sans beforeKey. Des phrases entières, de 3 à 15 secondes.
3. Compter les visuels. check_edit et sa rubric disent combien de visuels manquent et où se trouve le plus long passage sans visuel.
4. Scènes. Dessinez autant de nouvelles scènes (voir Ajouter des scènes), puis reprenez celles qui sont déjà là.
5. Zooms. add_zoom sur une chute, tenu sur toute la phrase. Quand l'orateur montre l'écran, lisez la zone sur look_at_source et passez-la en zone.
6. Repères. Là où l'orateur dit « ici » ou « ce bouton », add_marker entoure, souligne ou encadre la zone.
7. Sous-titres, musique, bruitages. Voir Sous-titres et audio.
8. Fin. check_edit, corrigez ce qu'il liste, puis look_at_montage sur chaque scène et chaque zoom, sur les 5 premières secondes et les 5 dernières. Relancez check_edit.

Le montage est fini quand la demande est remplie et que check_edit ne liste plus rien, ou quand chaque point gardé a sa raison en une ligne du compte rendu. Le compte rendu donne ce qui a changé avec les temps du montage, et ce qui a été laissé de côté et pourquoi.

Ajouter des scènes

Demandez : « Ajoute une scène qui montre les trois étapes que l'orateur liste à 1:20. »

1. Une fois par session, lisez get_scene_contract : les règles de la page, les recettes et la grille de notation. get_scene_examples donne des pages d'exemple notées.
2. Choisissez une idée entière, avec fromKey et toKey pris dans le transcript.
3. list_layouts pour ce moment : les dispositions qui tiennent et la boîte de chacune. P1 remplit le cadre, P9 est transparent sur la vidéo, les autres gardent l'orateur à côté de la scène.
4. get_scene_brief donne les temps forts en secondes, la boîte du contenu, le visage et les règles mesurées. Si range dit que le moment est trop court, prenez le toKey proposé.
5. Écrivez la page entière. Pas de réseau, GSAP de base seulement, images en ligne en data:. Au plus 3 Mo avec images, 600 Ko sans.
6. measure_scene filme la page sur la vraie vidéo et liste ce qui est cassé, avec les distances en pixels. Corrigez tout d'un coup et mesurez à nouveau. Deux ou trois mesures font une scène.
7. insert_scene avec les mêmes arguments et la même page, puis look_at_montage à ce moment.

Pour reprendre une scène déjà là, lisez-la avec get_scene. set_scene_text change les mots d'un modèle, set_duration sa durée, move_broll son ancrage, apply_layout sa disposition, set_layout règle cette disposition (la part et le côté de l'orateur, la place de la scène, la carte de l'orateur : place, taille, forme, angle, cadrage, entrée), set_broll_pip place l'orateur dans une fenêtre par-dessus. Un nouveau rendu est une nouvelle page : measure_scene, puis insert_scene avec son brollId.

Sous-titres, musique et bruitages

Demandez : « Sous-titre les phrases clés, mets une musique calme sous la voix et un whoosh sur chaque scène. »

• Sous-titres. get_captions donne la piste, son style et le catalogue. set_captions couvre toute la vidéo ou des ranges choisis ; add_caption sous-titre un court passage. Un style choisi par la personne reste, sauf si elle demande un autre rendu (lookAsked: true).
• Musique. list_music donne les ids des pistes, set_music en pose une. Laissez volume de côté : le niveau part de celui du mixeur de l'application. duck règle la baisse sous la voix : subtle, normal ou strong.
• Bruitages. list_sfx liste la bibliothèque et ce qui est posé. add_sfx s'attache au visuel à l'écran à ce moment ; remove_sfx en retire un. Un effet par entrée de scène ou élément clé.
• Mixage. check_audio mesure la musique et les effets par rapport à la voix, en dB. Une musique sonne bien 15 à 25 dB sous la voix. Corrigez ce qu'il signale, puis relancez-le.

Relire un montage

Demandez : « Relis mon montage Brollss et liste ce qu'il faut corriger avant publication. »

1. get_project_state : durée, coupes, scènes, zooms, sous-titres, musique.
2. check_edit : la timeline (ce qui se gêne), les scenes (le rythme de chaque scène) et la rubric (accroche, reprises restantes, zooms, musique), avec la densité des visuels en note, jamais en point à corriger.
3. check_audio : la musique et les effets par rapport à la voix.
4. look_at_montage sur les 5 premières et 5 dernières secondes, chaque scène et zoom, et chaque moment que check_edit nomme.
5. Une ligne par constat : le temps du montage, ce qui ne va pas, l'outil qui le corrige. Puis le verdict. Cette relecture n'écrit rien.