OBS Studio
Incluida en Macro DeckCambia de escena, controla tu directo, la grabación y el audio, y reacciona a lo que pasa en OBS Studio.
El cuadro de diálogo Conectar OBS Studio con el nombre de la configuración, el host, el puerto y la contraseña
- Cambia de escena, de perfil y de colección de escenas
- Inicia y detén la transmisión, la grabación, el búfer de repetición y la cámara virtual
- Silencia entradas, ajusta volúmenes y alterna fuentes y filtros
- Variables en directo para escenas, códigos de tiempo, FPS y fotogramas perdidos
- Conecta varias instancias de OBS a la vez
La integración OBS Studio conecta Macro Deck con OBS a través del servidor WebSocket integrado en OBS (obs-websocket 5). Una vez conectada, tus botones pueden controlar casi todo lo que haces en OBS durante un directo, y OBS informa de lo que cambia, así que tu deck siempre muestra el estado actual.
Qué puedes hacer
- Cambia la escena de programa, la escena de vista previa del modo estudio, el perfil o la colección de escenas.
- Inicia, detén o alterna la transmisión, la grabación, el búfer de repetición y la cámara virtual, guarda una repetición, pausa una grabación, divide el archivo de grabación o añade un marcador de capítulo.
- Muestra u oculta una fuente en una escena, activa o desactiva un filtro, silencia una entrada o cambia su volumen en porcentaje o en dB.
- Cambia un ajuste de una fuente, por ejemplo el texto de una fuente de texto, el archivo de una fuente de imagen o multimedia, o la URL de una fuente de navegador.
- Inicia y detén cualquier salida de OBS por su nombre, incluidas las salidas que añaden los complementos.
Algunos ejemplos:
- Un botón Vuelvo enseguida que cambia a tu escena de pausa y silencia tu micrófono.
- Un botón Grabar que alterna la grabación y muestra si OBS está grabando, en pausa o detenido.
- Un control deslizante vinculado a la variable
obs_<input>_volumede tu entrada de música, para que al moverlo cambie el volumen en OBS. - Un flujo que se ejecuta cuando OBS informa de Transmisión iniciada y te envía una notificación.
Cómo funciona
Macro Deck escucha los eventos que envía OBS, así que variables como la escena actual, los estados de silencio y los estados de los filtros se actualizan en una fracción de segundo después de cambiarlos en OBS. Los botones de alternar se iluminan mientras su estado está activo, también cuando lo cambias en el propio OBS. Las estadísticas como FPS, uso de CPU, bitrate y fotogramas perdidos se leen cada uno o dos segundos.
Además de las variables fijas, el selector de variables muestra cada entrada, escena, elemento de escena y filtro del OBS conectado, con su volumen, su estado de silencio, su visibilidad o su estado de activación. Los disparadores reaccionan a cambios de escena, cambios de grabación y transmisión, repeticiones y capturas de pantalla guardadas, entradas que se activan y eventos personalizados que emiten tus propios scripts de OBS.
Puedes añadir más de una configuración, por ejemplo una para tu PC de streaming y otra para tu PC para jugar. Cada configuración tiene su propio conjunto de variables, y cada acción tiene un campo Configuración para elegir qué OBS controla. Cuando OBS se cierra o se cae la red, Macro Deck sigue intentando volver a conectarse y activa los disparadores Desconectado y Conectado.
Qué necesitas
- Macro Deck 3 en Windows, macOS o Linux
- OBS Studio 28 o posterior (incluye obs-websocket 5)
- El servidor WebSocket activado en OBS en Tools > WebSocket Server Settings
- Iniciar y detener salidas por su nombre requiere obs-websocket 5.7 o posterior
Configúrala
Paso 1: Activa el servidor WebSocket en OBS
En OBS, abre Tools > WebSocket Server Settings y marca Enable WebSocket server. Anota el Server Port (de forma predeterminada
4455). Si Enable Authentication está marcado, haz clic en Show Connect Info para ver la contraseña.Paso 2: Abre OBS Studio en Macro Deck
En Macro Deck, haz clic en Integraciones en la barra lateral y después en OBS Studio. En la pestaña Resumen, haz clic en Añadir configuración en la sección Configuración. Activar el interruptor de arriba a la derecha abre el mismo cuadro de diálogo, y la integración se activa cuando termina la configuración.
Paso 3: Introduce los datos de conexión
Rellena el cuadro de diálogo Conectar OBS Studio:
- Nombre de la configuración: un nombre que elijas, por ejemplo
Streaming PC. - Host:
127.0.0.1si OBS se ejecuta en el mismo ordenador; si no, la dirección IP del ordenador en el que se ejecuta OBS. - Puerto: el puerto del servidor de OBS,
4455de forma predeterminada. - Contraseña: la contraseña de OBS. Déjala vacía si la autenticación está desactivada.
Haz clic en Continuar. Macro Deck prueba la conexión antes de guardar la configuración.
- Nombre de la configuración: un nombre que elijas, por ejemplo
Paso 4: Añade una acción de OBS a un botón
En la página Deck, haz clic en el botón que quieras usar. El deck tiene que estar desbloqueado: lo está cuando el botón de arriba a la derecha dice Bloquear. El editor se abre con Pulsación corta seleccionada. Haz clic en + Añadir acción, selecciona OBS Studio a la izquierda del cuadro de diálogo Añadir acción y elige una acción como Establecer escena. Selecciona la Configuración y la Escena y haz clic en Guardar.
Paso 5: Pulsa el botón
Pulsa el botón en tu teléfono, en tu tablet o en el cliente web. OBS cambia a la escena que elegiste. Si no pasa nada, comprueba que OBS esté en ejecución y que la configuración muestre Conectado en la página OBS Studio de Integraciones.
Acciones35
Ponlas en un botón o ejecútalas desde un flujo.
- Establecer escena
- Cambia la escena de programa activa.
- Establecer escena de vista previa
- Cambia la escena de vista previa del modo estudio.
- Establecer perfil
- Cambia OBS a otro perfil.
- Establecer colección de escenas
- Cambia OBS a otra colección de escenas.
- Iniciar grabación
- Inicia la grabación.
- Detener grabación
- Detiene la grabación.
- Alternar grabación
- Inicia o detiene la grabación y muestra si OBS está grabando, en pausa o detenido.
- Pausar/reanudar grabación
- Pausa o reanuda la grabación actual.
- Iniciar transmisión
- Inicia la transmisión.
- Detener transmisión
- Detiene la transmisión.
- Alternar transmisión
- Inicia o detiene la transmisión.
- Iniciar cámara virtual
- Inicia la cámara virtual.
- Detener cámara virtual
- Detiene la cámara virtual.
- Alternar cámara virtual
- Inicia o detiene la cámara virtual.
- Iniciar búfer de repetición
- Inicia el búfer de repetición.
- Detener búfer de repetición
- Detiene el búfer de repetición.
- Alternar búfer de repetición
- Inicia o detiene el búfer de repetición.
- Guardar búfer de repetición
- Guarda en el disco el búfer de repetición actual.
- Dividir archivo de grabación
- Empieza un archivo de grabación nuevo mientras la grabación sigue en marcha.
- Crear capítulo de grabación
- Añade un marcador de capítulo al archivo que se está grabando (solo formato Hybrid MP4).
- Establecer carpeta de grabación
- Establece la carpeta en la que OBS guarda las grabaciones nuevas.
- Iniciar salida
- Inicia una salida de OBS por su nombre, incluidas las salidas que añaden los complementos.
- Detener salida
- Detiene una salida de OBS por su nombre, incluidas las salidas que añaden los complementos.
- Alternar salida
- Inicia o detiene una salida de OBS por su nombre, incluidas las salidas que añaden los complementos.
- Obtener estado de salida
- Lee en una variable si una salida de OBS está activa.
- Establecer visibilidad de la fuente
- Muestra, oculta o alterna una fuente en una escena.
- Silenciar entrada
- Silencia una entrada de audio, le quita el silencio o lo alterna.
- Establecer volumen de entrada
- Establece, sube o baja el volumen de una entrada de audio en porcentaje o en dB.
- Establecer filtro de fuente
- Activa, desactiva o alterna un filtro de una fuente.
- Establecer ajuste de entrada
- Cambia un ajuste de una fuente, por ejemplo el texto de una fuente de texto o la URL de una fuente de navegador.
- Obtener volumen de entrada
- Lee en una variable el porcentaje de volumen de una entrada de audio.
- Obtener estado del filtro
- Lee en una variable si un filtro de fuente está activado.
- Obtener silencio de la entrada
- Lee en una variable si una entrada de audio está silenciada.
- Obtener visibilidad de la fuente
- Lee en una variable si una fuente es visible en una escena.
- Alternar modo estudio
- Activa o desactiva el modo estudio.
Disparadores24
Un botón o un flujo puede reaccionar a estos eventos.
- Escena cambiada
- Cambió la escena de programa (en directo). Si quieres, solo para una escena.
- Escena de vista previa cambiada
- Cambió la escena de vista previa del modo estudio.
- Grabación iniciada
- OBS empezó a grabar.
- Grabación detenida
- OBS dejó de grabar.
- Grabación pausada
- Se pausó la grabación.
- Grabación reanudada
- Se reanudó la grabación.
- Archivo de grabación cambiado
- La grabación empezó, pasó a un archivo nuevo o se detuvo, con la ruta del archivo.
- Transmisión iniciada
- OBS empezó a transmitir.
- Transmisión detenida
- OBS dejó de transmitir.
- Búfer de repetición iniciado
- Se inició el búfer de repetición.
- Búfer de repetición detenido
- Se detuvo el búfer de repetición.
- Búfer de repetición guardado
- Se guardó un clip de repetición en el disco, con su ruta de archivo.
- Captura de pantalla guardada
- OBS guardó una captura de pantalla en el disco, con su ruta de archivo.
- Cámara virtual iniciada
- Se inició la cámara virtual.
- Cámara virtual detenida
- Se detuvo la cámara virtual.
- Modo estudio cambiado
- Se activó o desactivó el modo estudio.
- Silencio de entrada cambiado
- Se silenció una entrada de audio o se le quitó el silencio. Si quieres, solo para una entrada.
- Entrada activada
- Una entrada empezó a mostrarse en la salida de programa, por ejemplo una webcam que entra en directo.
- Entrada desactivada
- Una entrada dejó de mostrarse en la salida de programa.
- Entrada visible
- Una entrada empezó a mostrarse en la salida de programa o en la de vista previa.
- Entrada oculta
- Una entrada ya no se muestra en la salida de programa ni en la de vista previa.
- Evento personalizado
- Un script o complemento de OBS emitió un evento personalizado. Si quieres, solo para un nombre de evento.
- Conectado
- Macro Deck se conectó a OBS y OBS terminó de cargar.
- Desconectado
- Se perdió la conexión con OBS.
Variables14
Muestra estos valores en botones y widgets, o úsalos en condiciones.
obs_<configuration>_is_connected- Si Macro Deck está conectado a este OBS.
obs_<configuration>_current_scene- La escena de programa activa.
obs_<configuration>_preview_scene- La escena de vista previa del modo estudio.
obs_<configuration>_current_profile- El perfil activo.
obs_<configuration>_current_scene_collection- La colección de escenas activa.
obs_<configuration>_is_recording,obs_<configuration>_recording_paused,obs_<configuration>_recording_timecode- Si OBS está grabando o en pausa, y cuánto dura la grabación.
obs_<configuration>_is_streaming,obs_<configuration>_streaming_timecode- Si OBS está transmitiendo y desde hace cuánto.
obs_<configuration>_virtual_camera_active,obs_<configuration>_replay_buffer_active,obs_<configuration>_studio_mode_active- Si la cámara virtual, el búfer de repetición y el modo estudio están activados.
obs_<configuration>_fps,obs_<configuration>_max_fps,obs_<configuration>_cpu_usage- Las cifras de rendimiento que informa OBS.
obs_<configuration>_streaming_bitrate,obs_<configuration>_recording_bitrate- Las tasas de bits actuales de las salidas, en kbps.
obs_<configuration>_dropped_frames,obs_<configuration>_dropped_frames_percent,obs_<configuration>_skipped_frames,obs_<configuration>_skipped_frames_percent- Los fotogramas perdidos de la transmisión y los fotogramas que omitió el codificador, como número y en porcentaje.
obs_<configuration>_last_recording_file,obs_<configuration>_last_screenshot- La ruta del último archivo de grabación y de la última captura de pantalla.
obs_<input>_volume,obs_<input>_mutedy más- Para cada entrada que elijas: el volumen en dB (se puede escribir, así que un control deslizante puede establecerlo), el silencio, si está activa, si se muestra, las pistas de audio (de
obs_<input>_track_1a_6), el tipo de monitorización, el desfase de sincronización y sus ajustes. El selector propone estos nombres y puedes cambiarlos. obs_<scene>_<source>_visible,obs_<source>_<filter>_enabled- Si una fuente es visible en una escena y si un filtro está activado. El selector propone estos nombres y puedes cambiarlos.
Preguntas frecuentes
¿Funciona si OBS se ejecuta en otro ordenador?
Sí. Introduce como Host la dirección IP del ordenador en el que se ejecuta OBS y permite el puerto (4455 de forma predeterminada) en el cortafuegos de ese ordenador. Las rutas de acciones como Establecer carpeta de grabación o Establecer ajuste de entrada son rutas del ordenador en el que se ejecuta OBS.
¿Puedo controlar más de un OBS?
Sí. Añade una configuración por cada instancia de OBS con Añadir configuración. Cada una tiene sus propias variables, y cada acción tiene un campo Configuración para elegir qué OBS controla.
¿Qué pasa cuando OBS se cierra o se corta la conexión?
Macro Deck sigue intentando volver a conectarse en segundo plano y se conecta de nuevo en cuanto OBS vuelve. Hasta entonces, las acciones fallan con OBS no está conectado., y se activan los disparadores Desconectado y Conectado para que un flujo pueda reaccionar.
¿Por qué falla una acción?
La acción muestra el motivo, por ejemplo que una escena o una fuente ya no existe, que OBS todavía está cargando una colección de escenas o que OBS no está grabando (con Dividir archivo de grabación y Crear capítulo de grabación). Si cambiaste el nombre de algo en OBS, vuelve a elegirlo en la acción.
¿Dónde se guarda la contraseña de WebSocket?
Macro Deck guarda la contraseña cifrada en el ordenador en el que se ejecuta Macro Deck y solo la usa para conectarse a OBS.
Más en Streaming
Meld Studio
Incluida en Macro DeckCambia y prepara escenas, controla capas, efectos y pistas de audio, y ponte en directo en Meld Studio.
Streamlabs Desktop
Incluida en Macro DeckCambia de escena y controla tu directo, la grabación y las fuentes de audio en Streamlabs Desktop.
Streamer.bot
Incluida en Macro DeckEjecuta acciones de Streamer.bot, envía mensajes de chat y reacciona a todos los eventos que informa Streamer.bot.
Twitch
Incluida en Macro DeckMuestra tu chat de Twitch y las estadísticas de tu directo, modera, lanza encuestas y anuncios, y reacciona a follows, subs y raids.
YouTube
Incluida en Macro DeckMuestra el chat en directo y las estadísticas de tu directo de YouTube, cambia el título y las etiquetas, y reacciona a Super Chats y miembros.