Un script Home Assistant (HA) exécute plusieurs actions l’une après l’autre. Ce guide présente un script « Soirée cinéma » dans HA 2025.12.2 ; les libellés peuvent varier selon la version.
1. Qu’est-ce qu’un script ?
Un appareil ou une entité peut être une lampe, un téléviseur ou un rideau. Une automatisation suit une règle comme « Si quelqu’un rentre, allumer la lumière » et démarre à partir d’un événement. Un script est une suite d’actions enregistrée : il attend que vous, ou une automatisation, l’appeliez, puis exécute ses étapes.
2. Créer le script « Soirée cinéma »
Objectif : d’un seul geste, éteindre la lampe principale du salon, réduire le ruban LED à 30 % et allumer le téléviseur.
Étape 1 : ouvrez « Paramètres » → « Automatisations et scènes » → « Scripts ». Cliquez sur « Créer un script », puis sur « Créer un nouveau script ».
Étape 2 : nommez le script « Soirée cinéma ». Vous pouvez choisir l’icône mdi:movie-open. Conservez le mode « Unique » : si le script s’exécute déjà, un nouvel appel ne lance pas une deuxième exécution susceptible de créer des conflits.
Étape 3, action 1 : cliquez sur « Ajouter une action ». Choisissez la lampe principale du salon comme appareil, puis l’action « Éteindre ». Dans les versions récentes de HA, « Appeler un service » peut être intitulé « Exécuter une action ».
Action 2 : ajoutez une action, recherchez light.turn_on ou « Lampe : allumer », puis sélectionnez le ruban LED. Activez le réglage de luminosité et choisissez 30 %. Vous pouvez aussi définir une couleur jaune chaud ou rouge.
Action 3 : ajoutez une action, choisissez le téléviseur et « Allumer ». Enregistrez le script. Dans le menu à trois points, choisissez « Exécuter » et vérifiez que les lampes changent d’état et que le téléviseur s’allume.
3. Appeler le script
Manuellement : modifiez le tableau de bord « Vue d’ensemble », ajoutez une carte « Bouton » et sélectionnez le nouveau script comme entité. L’exemple chinois utilise script.guan_ying_mo_shi ; avec « Soirée cinéma », HA créera un autre identifiant. Choisissez celui de votre installation.
Automatiquement : créez une automatisation déclenchée, par exemple, lorsque la prise du téléviseur mesure plus de 50 W. Comme action, utilisez script.turn_on et sélectionnez « Soirée cinéma ». L’éclairage s’adaptera alors quand le téléviseur sera mis en marche.
4. Autres possibilités
Dans la version décrite, la liste des actions est souvent désignée par actions: dans la syntaxe YAML ; les anciennes configurations avec action: peuvent encore exister. Si le téléviseur démarre lentement, insérez une attente de cinq secondes après son allumage, puis une action pour fermer les rideaux.
Vous pouvez également exposer le script à HA Assist pour le lancer à la voix. En cas d’erreur, vérifiez d’abord que les bons appareils et les bonnes entités ont été sélectionnés.
