Saltar al contenido
glowfish
Deutsch English Français Italiano
+49 89 55063107 Área de cliente

Inicio · Ayuda · Controlar el relay IRL

Controlar el relay IRL por webhook

Su relay se puede iniciar, detener o reiniciar llamando a una dirección. Funciona desde SAMMI, Streamer.bot, Bitfocus Companion o pulsando un botón en un Stream Deck.

Caso típico: tiene varios relays, por ejemplo uno en casa y otro en el centro de datos, y solo uno debe estar activo. Si no, NOALBS cambia las escenas dos veces y los comandos de chat como !start o !stop se ejecutan dos veces.

Dónde están las direcciones

En el área de cliente, abra el relay en Streaming y pulse Generar direcciones webhook en la tarjeta Control remoto del relay (webhook). Recibirá cinco direcciones, una por acción, con este formato:

https://vcontrol.glowfish.de:9786/api/v1/relay/SU-CLAVE/accion

Las cinco acciones

  • start: activa los servicios del relay.
  • stop: detiene el relay. Se cierran todos los servicios (SRT, SRTLA, RIST, NOALBS y el bot de chat) y una emisión en curso se interrumpe. El relay queda detenido y espera start.
  • neustart: reinicia todos los servicios.
  • allein: activa este relay y detiene todos los demás relays de su cuenta de cliente.
  • status: solo informa y no cambia nada.

Llamada y respuesta

La dirección se llama con GET o POST, sin más datos. La acción surte efecto en cinco segundos. La respuesta llega en JSON, por ejemplo:

{"ok":true,"relay":"relay-0001","name":"Relay Zuhause","zustand":"aktiv","sendet":false,"letzte_meldung":"11.11.2026 07:30:12"}

Con una clave desconocida, la dirección responde con el estado 404. Se permiten como máximo 30 llamadas por minuto por relay.

Relay self-hosted

Con un relay en su propio servidor, tras detenerlo solo sigue funcionando en el contenedor un pequeño proceso de control que espera start. No necesita acceso a Docker en su servidor.

Configuración en programas habituales

  • SAMMI: Comando «HTTP Request», método GET, con la dirección webhook como URL.
  • Streamer.bot: Subacción «Fetch URL» con la dirección webhook.
  • Bitfocus Companion: Módulo «Generic: HTTP Requests», acción GET con la dirección webhook.
  • Stream Deck: un plugin para solicitudes web, por ejemplo «API Ready», método GET.

Cambiar entre dos relays: cree dos botones, cada uno con la dirección allein del relay correspondiente. Una pulsación activa el relay elegido y detiene el otro.

Seguridad

Quien conozca la dirección puede controlar su relay. Trátela como una contraseña y no la muestre nunca en el stream. Ante cualquier sospecha, pulse Generar nuevas direcciones webhook en el área de cliente. Las direcciones anteriores dejan de funcionar al instante.

Además, la llamada se puede limitar a determinadas direcciones: en la tarjeta Control remoto del relay (webhook), en Permitir solo desde direcciones concretas (opcional), introduzca en el campo Direcciones IP o redes permitidas direcciones IPv4 o IPv6 o redes con prefijo, separadas por comas, por ejemplo 203.0.113.7, 198.51.100.0/24. Si el campo queda vacío, la llamada es posible desde cualquier lugar. El relay rechaza las llamadas desde otras direcciones con el estado 403 («Llamada desde esta dirección no permitida»).

Si la dirección IP de su conexión cambia, por ejemplo en casa, una dirección única solo sirve hasta el siguiente cambio. En ese caso, indique mejor la red de su proveedor o deje el campo vacío.

Cómo configurar el relay y recibir el stream en OBS se explica en Configurar el streaming IRL.

Si tiene preguntas, escríbanos a support@glowfish.de.