Pipeline de publication launch video

Vidéo de lancement / de démonstration

Un pipeline réutilisable pour transformer un produit, une fonctionnalité ou une page en une courte vidéo animée avec narration, puis la publier sur YouTube, l'intégrer sur la page et l'annoncer. Ce pipeline existe parce que faire cela manuellement implique de redécouvrir à chaque fois une douzaine de détails non évidents (particularités OAuth, synchronisation voix-off/métrique, intégration clic-pour-lire, niveaux de volume cibles).

Sortie par défaut : une vidéo 1080p / 30fps, d'environ 45 à 60 secondes, avec une voix-off émotive, téléchargée d'abord en mode non listé pour que l'utilisateur approuve, puis rendue publique. Ne publiez jamais une vidéo publiquement sans que l'utilisateur l'ait entendue/vue — les voix et le rythme sont subjectifs.

Configurez ceci pour votre projet

Avant la première utilisation, remplissez config.md (quelques IDs et chemins). La compétence lit ces valeurs au lieu de valeurs codées en dur, ce qui la rend adaptable à n'importe quel produit. Les valeurs dont vous avez besoin :

• Votre chaîne YouTube (le compte OAuth doit l'avoir sélectionnée)
• Le chemin de votre secret client OAuth et votre numéro de projet GCP (YouTube Data API v3 activée)
• Où envoyer les annonces des vidéos terminées (canal Slack, Discord, etc.)
• Vos couleurs de marque et le modèle d'URL de votre produit

Quand l'utiliser

Pour créer une vidéo pour une page/fonctionnalité/outil, ajouter une voix-off, ou publier une vidéo sur YouTube. Pour une demande générale "ajoutez des vidéos à nos meilleures pages", extrayez d'abord les pages principales (depuis vos analytics), puis exécutez ce pipeline une fois par page — testez-en une, obtenez l'approbation du format, puis traitez le reste par lots.

Le pipeline (7 étapes)

Travaillez de haut en bas. Chaque étape est détaillée dans le fichier ou script référencé.

1. Comprendre le sujet. Lisez l'implémentation / la documentation pour que les étapes montrées correspondent au comportement réel. Pour une démonstration d'outil, utilisez l'outil en direct (Playwright) pour voir le flux entrée→sortie réel — c'est CE qui constitue la démonstration.

2. Capturer des captures d'écran réelles. Playwright en production, 1920×1080. Masquez d'abord les bannières promotionnelles / les barres de cookies. Voir references/video-production.md → "Capturer des captures d'écran".

3. Construire la vidéo Remotion. Copiez la structure remotion-scaffold/. Les scènes sont comptées en images à 30fps dans src/theme.ts. Dimensionnez chaque scène à la longueur de sa narration (étape 4). Modèles complets de scènes/animations dans references/video-production.md.

4. Générer la voix-off. scripts/tts_voiceover.py — OpenAI gpt-4o-mini-tts, voix ash, avec une invite instructions pour l'émotion (sans cela, la lecture est plate et robotique — c'est le détail le plus important de la voix-off). Il génère des clips par scène, les synchronise avec l'image de début de chaque scène, et normalise le volume de la piste mixée. Réajustez le temps des scènes dans theme.ts si un clip dépasse sa scène, puis re-rendez.

5. Rendu + muxage + encodage. npx remotion render, muxez la piste VO avec ffmpeg (-c:v copy), puis encodez une copie de téléchargement de < 10 Mo (libx264 -crf 25 -movflags +faststart). Commandes dans references/video-production.md → "Rendu, muxage, encodage".

6. Publier sur YouTube. scripts/youtube.py (utilise youtubeuploader pour le téléchargement, et l'API Data pour le reste). Téléchargez en mode non listé, obtenez l'approbation de l'utilisateur, puis passez en public. Lisez d'abord references/youtube-publishing.md — il contient la configuration d'authentification, le piège de la redirection OAuth, l'erreur API non activée, les limites de quota, et le modèle de métadonnées.

7. Intégrer + annoncer. Ajoutez une section façade clic-pour-lire sur la page (affiche + bouton de lecture ; l'iframe YouTube ne se monte qu'au clic — cela évite de la charger initialement). Ensuite, postez le lien sur votre canal d'équipe. Les deux modèles sont dans references/embed-and-announce.md.

Garde-fous

• Non listé → approuver → public, à chaque fois. Le téléchargement sur la propre chaîne de l'utilisateur nécessite son approbation.
• Le consentement OAuth Google est à donner par l'utilisateur — vous ne pouvez pas cliquer sur "Autoriser" à sa place. Si l'authentification n'est pas configurée, guidez-le (voir references/youtube-publishing.md), n'essayez pas de la contourner.
• Conservez le rendu maître ; seule la copie de téléchargement est limitée en taille.
• Le quota de l'API YouTube ≈ 6 téléchargements / 24h. Un lot plus volumineux doit être réparti sur plusieurs jours — dites-le plutôt que d'échouer silencieusement en cours de route.
• La CLI ne peut pas définir de miniature — signalez que l'utilisateur doit en ajouter une dans Studio (ou la définir via l'API séparément).