Un script de Home Assistant (HA) ejecuta varias acciones en secuencia. Esta guía muestra cómo crear un script « Modo cine » en HA 2025.12.2; los nombres de los controles pueden variar según la versión.
1. ¿Qué es un script?
Un dispositivo o entidad puede ser una luz, un televisor o una cortina. Una automatización sigue una regla como « Si alguien llega a casa, encender la luz » y se activa por un evento. Un script es una secuencia de acciones guardada: espera hasta que usted, o una automatización, lo llame y entonces ejecuta los pasos.
2. Crear el script « Modo cine »
Objetivo: con un toque, apagar la luz principal del salón, atenuar la tira LED al 30 % y encender el televisor.
Paso 1: abra « Ajustes » → « Automatizaciones y escenas » → « Scripts ». Pulse « Crear script » y elija « Crear nuevo script ».
Paso 2: llámelo « Modo cine ». Puede usar el icono mdi:movie-open. Mantenga el modo « Único »: si el script ya está en ejecución, otra pulsación no iniciará una segunda ejecución que pueda interferir.
Paso 3, acción 1: pulse « Añadir acción ». Elija la luz principal del salón como dispositivo y seleccione « Apagar ». En versiones recientes de HA, « Llamar a un servicio » también puede aparecer como « Ejecutar acción ».
Acción 2: añada otra acción, busque light.turn_on o « Luz: encender » y seleccione la tira LED. Active el brillo y ajústelo al 30 %. Opcionalmente, elija un color amarillo cálido o rojo.
Acción 3: añada una acción, elija el televisor y seleccione « Encender ». Guarde el script. En el menú de tres puntos, pulse « Ejecutar » y compruebe que las luces responden y el televisor se enciende.
3. Cómo ejecutar el script
Manualmente: edite el panel « Vista general », añada una tarjeta « Botón » y seleccione el nuevo script como entidad. El ejemplo chino usa script.guan_ying_mo_shi; si lo llama « Modo cine », HA generará otro identificador. Seleccione el de su instalación.
Automáticamente: cree una automatización que se active, por ejemplo, cuando el enchufe del televisor detecte más de 50 W. Como acción, utilice script.turn_on y seleccione « Modo cine ». Así HA ajustará la iluminación al encender el televisor.
4. Otras posibilidades
En la versión descrita, la lista de acciones suele usar la clave actions: en YAML; también pueden existir configuraciones anteriores con action:. Si el televisor tarda en arrancar, añada una espera de cinco segundos después de encenderlo y luego una acción para cerrar las cortinas.
También puede exponer el script a HA Assist y ejecutarlo por voz. Si se produce un error, compruebe primero que ha seleccionado los dispositivos y entidades correctos.
