> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟪 Choix vidéo

# 🟪 Choix vidéo

${frame}[Vidéo : anatomie du bloc Choix vidéo](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/displaychoice.html)

![Choix vidéo](https://celestory-docs-illustrations.netlify.app/fr/Choixvideo_FR.svg)

Le bloc **Choix vidéo** permet de proposer au joueur un ensemble de choix superposés à une vidéo en cours de lecture, typiquement utilisé dans les modèles Chatbot et Roman visuel pour les moments de décision cinématographiques.

## 📥 Entrées

*   **in (Flux)** : Point d'entrée qui déclenche l'affichage des choix par-dessus la vidéo.
*   **choix (Liste de Textes)** : La liste des options textuelles proposées au joueur (ajouter une ou plusieurs entrées "Texte").
*   **chrono (Nombre, défaut : 0)** : Compte à rebours optionnel avant qu'un choix par défaut soit effectué automatiquement (0 = pas de chrono).
*   **apparaît avant fin (Nombre, défaut : 0)** : Permet aux choix d'apparaître avant la fin de la vidéo, avec le délai indiqué.
*   **media (Image ou Vidéo)** : La vidéo à jouer derrière les choix.
*   **peut zoomer (Booléen, défaut : false)** : Indique si le joueur peut zoomer sur la vidéo.

## 📤 Sorties

*   **Sortie dynamique par choix** : Une sortie est activée lorsque l'option correspondante est sélectionnée par le joueur.

## 💡 Exemple d'utilisation

**Scénario : Une cinématique à embranchements**

1. L'entrée media joue un court extrait cinématique.
2. Deux choix sont ajoutés, réglés pour apparaître 2 secondes avant la fin de la vidéo (via "apparaît avant fin").
3. Le joueur sélectionne une option avant, ou juste au moment où la vidéo se termine.
4. Le flux continue depuis la sortie correspondant à l'option choisie.

## ⚙️ Détails Techniques

*   **Identifiant interne** : `displayChoice`
*   **Bloc spécifique à un modèle** : Choix vidéo est disponible dans les modèles Chatbot et Roman visuel, plutôt que dans le registre générique des blocs.
*   **Blocs apparentés** : voir aussi les blocs génériques Choix et Choix audio.

---

*Version documentée : v1*