MQTT / Home Assistant para Audio Forge

Audio Forge 1.4.4 añade integración con MQTT / Home Assistant para que puedas controlar música, ambientación y ecos desde tus automatizaciones del hogar inteligente, botones de escena y superposiciones de transmisión.

Audio Forge 1.4.4 presenta la integración con MQTT / Home Assistant, para que tu mesa de sonido TTRPG finalmente pueda conectarse al resto de tu configuración. Ahora puedes activar música, ambientación y efectos instantáneos desde automatizaciones, interruptores de pared, botones de Stream Deck, o cualquier otra cosa que pueda publicar en MQTT.

¿Quieres que tu música de batalla, luces y máquina de niebla se activen con la misma pulsación de botón? Ahora puedes.

Qué puede hacer la integración con MQTT

Con MQTT habilitado, Audio Forge puede:

  • Publicar su estado actual (qué biblioteca está activa, si Música/Ambientación están reproduciéndose, qué categorías están activas, volúmenes, último Eco, etc.).
  • Exponer comandos simples que puedes enviar desde Home Assistant o Node‑RED para reproducir, pausar, detener, cambiar de biblioteca, ajustar el volumen y activar Ecos.
  • Utilizar opcionalmente la Descubrimiento de Home Assistant para crear automáticamente entidades (botones, sensores, números, interruptores, selecciones) bajo un dispositivo “Audio Forge”.

Eso significa que puedes:

  • Comenzar o pausar Música/Ambientación con un botón de Home Assistant.
  • Atenuar automáticamente el volumen de la música cuando cambias de escena.
  • Alternar capas de Ambientación con interruptores físicos o virtuales.
  • Activar Ecos (sonidos de efecto inmediato) desde eventos de automatización.

Habilitar MQTT en Audio Forge

En la aplicación, ve a Configuración → Control Externo → Integración MQTT y:

  1. Activa Habilitado.
  2. Ingresa tu Host y Puerto de MQTT (1883 por defecto, o 8883 para TLS).
  3. Rellena Usuario / Contraseña si tu broker los requiere.
  4. Opcionalmente ajusta ID de Cliente, Tema Base (por defecto algo como audioforge/mi-pc), QoS y si deseas retener el estado.
  5. Activa Publicar estado y Suscribirse a comandos.
  6. (Opcional pero recomendado) Habilita Descubrimiento MQTT para que Home Assistant cree entidades automáticamente.

Una vez conectado, verás Audio Forge bajo los clientes de tu broker, y Home Assistant mostrará automáticamente el nuevo dispositivo (con descubrimiento) o puedes configurarlo manualmente con sensores y botones MQTT.

Ejemplos: automatizaciones simples

Aquí tienes algunas ideas de lo que puedes hacer una vez que MQTT está habilitado:

  • Crea un botón de “Batalla” en Home Assistant que inicie una categoría de música de “Batalla” en Audio Forge y ponga tus luces en rojo.
  • Usa un sensor binario (como “jugadores entran a la mazmorra”) para cambiar a tu ambientación de mazmorra y disminuir un poco el volumen de la música.
  • Vincula un botón de Stream Deck (a través de Home Assistant u otra herramienta compatible con MQTT) para activar un Eco (por ejemplo, trueno, golpe de puerta, rugido de dragón).
  • Vincula tu máquina de niebla a Ecos dramáticos o cambios de música haciendo que todo responda a la misma automatización.

En el fondo, estas automatizaciones solo publican pequeños mensajes JSON al tema de comandos de Audio Forge (por ejemplo: {"command":"play","section":"Music","categoryName":"Battle"}). No necesitas escribir mucho JSON tú mismo si usas las entidades de descubrimiento integradas.

Aprende los detalles

Si quieres ver todos los temas, cargas útiles y opciones de comandos (incluyendo control de volumen, cambios de categoría y restauración de estado), consulta la guía completa:

Guía de MQTT / Home Assistant

Incluye comandos de ejemplo y una automatización de Home Assistant que puedes copiar, pegar y adaptar a tu mesa.

Obtener Audio Forge 1.4.4

Actualiza ahora y conecta Audio Forge a tu hogar inteligente:

Descargar Audio Forge

¿Tienes preguntas o quieres compartir tus automatizaciones? Únete a la comunidad en Discord.