Créer une vidéo pour un jeu
Voici comment nous réalisons des vidéos pour les jeux Playgama. La vidéo ressemble au jeu, pas à Playgama : ses couleurs, polices, panneaux et sons. Playgama ajoute son logo (un sting de 3 secondes au début et un petit bug dans le coin) et le lien. Le reste du travail se fait à trois endroits : l’histoire est vraie et spécifique, le gameplay est filmé proprement, et la première seconde gagne la suivante.
Les fichiers fournis :
| Fichier | Description |
|---|---|
assets/playgama-ai-logo.svg, .png | Le logo officiel Playgama AI (591×133) : une pilule violette avec le wordmark Playgama, et une boîte grise collée avec « AI » découpé. Le PNG est 4x, transparent. |
assets/template/ | Un modèle vidéo HyperFrames de démarrage, 1920x1080 : le sting, trois emplacements de gameplay, un titre, une carte de fin, des pistes musique et voix. Un bloc theme en haut contient l’apparence du jeu. |
assets/sting-preview.mp4 | L’animation d’intro comme elle doit apparaître, avec un espace réservé où la vidéo du jeu commence. |
assets/sting.html | L’animation d’intro seule, en CSS pur (7 Ko, aucune bibliothèque) : à déposer dans n’importe quelle page ou outil vidéo. |
assets/playgama-ai-sting.html | La même animation en page de révision avec contrôles de lecture, vitesse et défilement, et la timeline et les couleurs détaillées. Ouvrez-la dans un navigateur et glissez une capture d’écran du jeu pour voir le logo superposé au jeu, ou donnez-la à un designer. |
scripts/film.mjs, scripts/vclock.js | Filmez n’importe quel jeu web image par image en un MP4 fluide à n’importe quelle taille. |
scripts/doctor.mjs, scripts/new-video.mjs | Vérifiez la machine et dites quoi installer ; créez le dossier de la vidéo (modèle, GSAP, Puppeteer). |
scripts/palette.mjs | Les couleurs utilisées par un jeu, échantillonnées à partir de ses captures d’écran, pour quand son code n’a pas de thème. |
scripts/voice.mjs | La voix off : prend en charge ElevenLabs, OpenAI, Gemini ou Cartesia (ou une voix provisoire gratuite). Une page pour choisir à l’oreille, et la piste vocale avec la musique en dessous. |
references/story-and-script.md | Formats, fiches de rythme avec exemples de lignes réelles, règles pour le contenu à l’écran. |
references/game-look.md | Prendre l’apparence du jeu : où la trouver, couleurs, typographie, panneaux, mouvement, son, le thème du modèle. |
references/filming.md | Comment filmer les prises : préparation, configuration et scripts par image, choix des moments, la première image. |
references/voice-and-music.md | Voix off (synthèse vocale ou la vôtre), prononcer « Playgama », vérifier les prises, niveaux de musique. |
references/edit-and-render.md | Assemblage dans HyperFrames : le modèle, les cartes, les coupes verticales, vérifications, rendu, révision. |
Ce dont vous avez besoin
Cela fonctionne de la même manière sur macOS, Linux et Windows.
node scripts/doctor.mjsvérifie la machine et indique ce qu’il faut installer.node scripts/new-video.mjs <dossier>crée le dossier de la vidéo : le modèle,gsap.min.jset Puppeteer pour le tournage. Exécutez toutes les commandes suivantes depuis ce dossier.
- Pour filmer : Node 22+ (HyperFrames en a besoin), ffmpeg et ffprobe dans le PATH, et Puppeteer.
film.mjsle trouve dans le dossier où il s’exécute, ou à côté du script. Le jeu doit être accessible via une URL : un serveur de développement ou un serveur statique sur le build. - Pour assembler et rendre : HyperFrames (
npx [email protected]; son premier lancement télécharge environ 370 Mo de paquets et un navigateur sans tête). - Pour la voix, si ce n’est pas la vôtre : une clé pour ElevenLabs, ou pour un autre service avec lequel
scripts/voice.mjsfonctionne, définie une fois (references/voice-and-music.md), et Whisper ou un autre outil de reconnaissance vocale pour vérifier les prises. - Pour la musique : une piste instrumentale que vous avez le droit d’utiliser.
Le flux de travail
Travaillez dans cet ordre. Chaque étape alimente la suivante, et les deux points d’approbation font gagner des heures.
- Convenir de la vidéo. Définissez le format, la durée et l’objectif avant toute autre chose (tableau ci-dessous). Demandez à quoi sert la vidéo : joueurs, page de boutique, autres développeurs, ou le défi ou le catalogue Playgama.
- Recueillir l’histoire vraie. Rassemblez les vrais prompts, timestamps, commits, bugs, chiffres et captures d’écran (
references/story-and-script.md). Si le jeu a été construit avec un agent IA, son historique de chat est la source la plus riche : lisez-le et notez les heures et les citations exactes. - Prendre l’apparence du jeu (
references/game-look.md) : ses couleurs, polices, panneaux, logo, musique et sons d’interface, d’abord à partir de ses propres fichiers. Inscrivez-les dans le bloc thème du modèle. - Écrire le script, puis s’arrêter pour approbation. Écrivez les lignes vocales et ce qui est à l’écran, une ligne chacune. Le développeur approuve le texte et l’apparence avant qu’une voix ne soit créée : reformuler une voix enregistrée signifie l’enregistrer à nouveau.
- Filmer le gameplay et prendre les captures d’écran avec
scripts/film.mjsà la taille de livraison (voir « Images du jeu » ci-dessous, etreferences/filming.md). Prévoyez une prise par temps fort du script, de quelques secondes chacune, mise en scène avec les propres contrôles du jeu ou des hooks de débogage. - Réaliser les images fixes dans l’apparence du jeu. Utilisez du vrai code avec de vrais numéros de ligne, le vrai prompt et les étapes de l’agent, les pages web et les couvertures.
- Enregistrer la voix et choisir la musique (
references/voice-and-music.md,scripts/voice.mjs). Une personne écoute les prises vocales, car la synthèse vocale échoue d’une manière qu’aucune transcription ne détecte. - Assembler et rendre avec le modèle (
references/edit-and-render.md). Lancez les vérifications, effectuez le rendu, extrayez une image toutes les quelques secondes et examinez chacune avant de déclarer le travail terminé. - Préparer le package : une miniature (1280×720, la meilleure image du jeu, au maximum 4 gros mots dans sa propre police), un titre et une description avec le lien vers le jeu.
Choisir d’abord le format
| Vidéo | Format | Durée | Ouverture |
|---|---|---|---|
| Short / Reels / TikTok | 9:16, 1080×1920 | 15–35 s | Gameplay dès la première image ; le logo uniquement en petit bug dans le coin |
| Bande-annonce / promo | 16:9, 1920×1080 | 30–90 s | Le sting (3 s), puis le meilleur gameplay |
| « Comment j’ai fait » | 16:9 | 3–6 min | Gameplay avec l’accroche, puis le sting ou un titre |
| Tutoriel (« publier avec Playgama MCP ») | 16:9 | 1–3 min par partie | Le sting, puis le résultat d’abord et les étapes ensuite |
Un Short se décide en une seconde, lorsque le spectateur reste ou balaie. Les Shorts qui s’ouvrent sur un gameplay plein écran lisibles d’un coup d’œil retiennent beaucoup plus de spectateurs que ceux qui s’ouvrent sur quelque chose à lire (une longue carte de commentaires, des menus de jeu, une boîte de chat). Un Short ne s’ouvre donc jamais sur le sting ou sur du texte.
L’apparence du jeu
La vidéo ressemble au jeu : quiconque y a joué devrait le reconnaître à n’importe quelle image. Prenez l’apparence du jeu lui-même, pas de Playgama (references/game-look.md) :
- Couleurs issues de son interface et de son code : un fond, un panneau, un texte, un bouton et un surlignage. Quand le code n’a pas de thème, échantillonnez ses menus et son HUD avec
scripts/palette.mjs. - Typographie : chaque police correspond à celle du jeu, y compris la police de code.
- Les titres utilisent sa police de titre ou de logo, les étiquettes et les prompts sa police d’interface ou de texte.
- Le code et les appels d’outils utilisent une police à chasse fixe dans l’esprit du jeu : une police pixel pour un jeu pixel art, une police machine à écrire pour un jeu sombre ou rétro.
- La DM Mono du modèle ne fait que tenir la place.
- Panneaux et boutons : cartes en forme de ses panneaux, bouton de la carte de fin comme son bouton principal, ses propres icônes et logo.
- Mouvement et son : bougez comme son interface (rebondissant, calme ou par pas de pixel). Utilisez d’abord sa propre musique et ses sons d’interface.
- Cartes sur images, pas sur diapositives noires. Placez un prompt ou une étape sur une image assombrie du jeu, et un titre bas sur le gameplay avec le fond assombri dans la couleur de fond du jeu. Préférez les vraies images côte à côte aux cartes avec seulement des noms dessus.
Les couleurs, polices et forme de panneau vont dans un bloc thème en haut du style du modèle.
Images du jeu
Le kit ne fournit aucune séquence de jeu. Chaque image du jeu est filmée à partir du propre jeu du développeur, par vous, avec scripts/film.mjs (references/filming.md). Cela couvre la vidéo, la miniature, l’image derrière une carte et les pages de révision.
- Clips : une prise par temps fort, par exemple
node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6. - Captures d’écran : la même commande avec
--still <secondes>écrit un seul PNG de cet instant à la place. Prenez-en un chaque fois qu’une étape a besoin d’une image du jeu :- ses menus et HUD, pour en lire l’apparence (
scripts/palette.mjs) ; - l’image derrière une carte de prompt ou un titre ;
- la miniature et la carte de fin ;
- le sting sur le jeu, pour vérifier que le bug dans le coin ne cache pas son HUD. Déposez la capture d’écran sur
assets/playgama-ai-sting.html, ou placez le premier clip dans le modèle et exécuteznpx [email protected] snapshot . --at 3.5 --describe false.
- ses menus et HUD, pour en lire l’apparence (
- Coupes verticales sont filmées en 1080×1920, avec la caméra du jeu recadrée en conséquence.
- Si le jeu ne peut pas être exécuté ici (build natif, mur de connexion, jeu en ligne uniquement), demandez au développeur des enregistrements d’écran et des captures d’écran à la taille de livraison, sans curseur ni notification à l’écran. Ne comblez jamais un vide avec des images d’un autre jeu, d’une page de boutique ou des exemples de ce kit.
Ce que Playgama ajoute
Son logo et le lien, rien d’autre. Le violet et la plaque sombre de Playgama appartiennent au logo et au sting, pas à la vidéo.
- Le logo est
assets/playgama-ai-logo.svg, le fichier officiel : une pilule violette#9747ffavec le wordmark blanc, et une boîte grise#d2d2d2avec « AI » découpé dedans.- Utilisez-le tel quel : ne le recolorez pas, ne l’étirez pas, n’ajoutez pas d’effets, ne modifiez pas ses espacements et ne le redessinez pas.
- Le « AI » est un trou, donc il montre ce qui se trouve derrière le logo.
- Laissez un espace libre d’au moins la moitié de la hauteur de la pilule.
- En tant que bug dans le coin, il fait environ 200 px de large sur une image 1920. Si le HUD du jeu se trouve dans ce coin, déplacez le bug dans un autre coin plutôt que de couvrir le HUD (
references/edit-and-render.md).
- Le lien vers Playgama mène à la propre page du jeu : sur la carte de fin et dans la description.
Le sting d’introduction
L’identifiant Playgama, comme le logo d’un éditeur avant une bande-annonce : environ 3 secondes, prêt à l’emploi dans assets/template/index.html. Il conserve ses propres couleurs et son timing dans chaque vidéo ; tout ce qui suit appartient au jeu. assets/sting-preview.mp4 montre le passage à un espace réservé. Pour le voir sur le jeu du développeur, prenez une capture d’écran ou un clip du jeu (voir « Images du jeu »).
- Construction : sur fond onyx avec une lueur violette douce, la pilule violette grandit depuis son centre (0,05 s, sur 0,55 s). Le wordmark blanc playgama apparaît de gauche à droite (0,42 s). La boîte grise apparaît collée à la pilule (0,92 s), et « A » et « I » sont découpés (1,12 s, 1,27 s). Une bande de lumière traverse la pilule (1,55 s).
- Transition : tout le logo vole vers le coin supérieur droit à 19 % de taille, à 39 px du haut et de la droite d’une image 1920×1080 (2,75 s, sur 0,62 s). Il y reste comme bug pendant que le gameplay apparaît en fondu en dessous (3,0 s).
- Les parties sont tirées des propres formes du fichier officiel à 240 px de haut, de sorte que le sting se termine exactement sur le logo.
- Changement : conservez son timing. Pour placer un cold open d’abord (une histoire), commencez le sting plus tard : définissez
Sdans le modèle (references/edit-and-render.md). Pour une coupe 9:16, supprimez la construction et placez le bug dans le coin dès la première image.
Règles issues des erreurs
- Seul du matériel réel à l’écran.
- Montrez de vrais prompts, de vrais chiffres, de vrais timestamps et du vrai code.
- Si un chiffre doit être illustratif, indiquez-le à l’écran (« DONNÉES EXEMPLES ») pendant toute sa durée d’affichage.
- N’inventez jamais une citation, un commentaire, un nombre de joueurs ou un avis. Les spectateurs qui vérifient un chiffre inventé cessent de faire confiance au reste.
- Les prompts à l’écran sont les mots du développeur.
- Traduisez-les dans la langue de la vidéo, mais ne les reformulez pas.
- Coupez un long prompt avec « […] » plutôt que de le paraphraser.
- Les étapes de l’agent sont les vrais appels d’outils dans leur ordre réel, par exemple
create_application→start_archive_upload→get_archive_status(RÉUSSI) →publish_sandbox(un lien public).
- Votre propre art uniquement. Ne montrez aucun personnage, logo ou art d’un autre jeu, même si votre jeu lui « ressemble » : nommez le genre à la place (« un jeu d’évasion horrifique »), pas un autre jeu.
- **Playgama se dit « play-GAH-ma ». ** Les voix anglaises disent « play-GAY-ma » sauf si vous les orientez (
references/voice-and-music.md). - Vérifiez chaque prise vocale par rapport à son texte (une transcription), et faites écouter par une personne. La synthèse vocale a répété une phrase, ajouté une phrase que personne n’a écrite, lu ses propres instructions à voix haute et avalé une dernière syllabe, le tout dans une prise qui semblait bonne seule.
- La première image du jeu se lit en moins d’une seconde, pas un menu ou un écran de chargement.
- Un Short s’ouvre dessus. Une bande-annonce ou une histoire l’atteint juste après le sting ou le cold open.
- Filmez le meilleur moment, pas le début d’un niveau.
- Texte dans les deux premières secondes du gameplay : au maximum quatre gros mots.
- Les fichiers restent sur la machine. Le
snapshotde HyperFrames envoie des images vers Gemini pour une description chaque fois qu’une clé Gemini ou Google est définie, et il lit un.envdans le dossier de la vidéo. Passez--describe falseà chaquesnapshot, et conservez les clés vocales dans le fichier de clés partagé devoice.mjs, pas dans le dossier de la vidéo.
Quand vous avez terminé
Le développeur reçoit :
- le MP4 maître, et un aperçu plus petit s’il est volumineux ;
- la miniature ;
- un fichier texte avec le titre, la description (le lien du jeu, des chapitres pour les longues vidéos, #playgama) et un commentaire à épingler.
Dites-lui où se trouve chaque fichier et ce qui lui revient encore de décider : l’heure de publication, une prise vocale qu’il n’a pas entendue, et tout ce que vous n’avez pas pu vérifier.