OBS Studio

Integracja OBS Studio łączy Macro Deck z OBS przez serwer WebSocket wbudowany w OBS (obs-websocket 5). Po połączeniu przyciski mogą sterować niemal wszystkim, co robi się w OBS podczas transmisji, a OBS zgłasza zmiany z powrotem, więc deck zawsze pokazuje bieżący stan.

Możliwości

• Przełączanie sceny programu, sceny podglądu w trybie studyjnym, profilu lub zbioru scen.
• Uruchamianie, zatrzymywanie i przełączanie transmisji, nagrywania, bufora powtórek i kamery wirtualnej, zapisywanie powtórki, wstrzymywanie nagrania, dzielenie pliku nagrania i dodawanie znacznika rozdziału.
• Pokazywanie lub ukrywanie źródła w scenie, włączanie lub wyłączanie filtra, wyciszanie wejścia lub zmiana jego głośności w procentach lub dB.
• Zmiana ustawienia źródła, np. tekstu źródła tekstowego, pliku źródła obrazu lub multimediów albo adresu URL źródła przeglądarki.
• Uruchamianie i zatrzymywanie dowolnego wyjścia OBS po nazwie, także wyjść dodanych przez wtyczki.

Przykładowe zastosowania:

• Przycisk BRB, który przełącza na scenę BRB i wycisza mikrofon.
• Przycisk Nagrywaj, który przełącza nagrywanie i pokazuje, czy OBS nagrywa, wstrzymał nagrywanie, czy je zatrzymał.
• Suwak powiązany ze zmienną obs_<input>_volume wejścia muzyki, dzięki czemu przesunięcie suwaka zmienia głośność w OBS.
• Przebieg uruchamiany, gdy OBS zgłosi Rozpoczęto transmisję, który wysyła powiadomienie.

Działanie

Macro Deck nasłuchuje zdarzeń wysyłanych przez OBS, więc zmienne takie jak bieżąca scena, stany wyciszenia i stany filtrów aktualizują się w ułamku sekundy po zmianie w OBS. Przyciski przełączające świecą, gdy ich stan jest aktywny, także gdy zmieniono go w samym OBS. Statystyki takie jak FPS, obciążenie procesora, bitrate i utracone klatki są odczytywane co jedną lub dwie sekundy.

Oprócz stałych zmiennych selektor zmiennych zawiera każde wejście, scenę, element sceny i filtr połączonego OBS wraz z głośnością, stanem wyciszenia, widocznością lub stanem włączenia. Wyzwalacze reagują na zmiany scen, zmiany nagrywania i transmisji, zapisane powtórki i zrzuty ekranu, aktywację wejść oraz zdarzenia niestandardowe rozgłaszane przez własne skrypty OBS.

Można dodać więcej niż jedną konfigurację, np. jedną dla komputera do streamowania i jedną dla komputera do gier. Każda konfiguracja ma własny zestaw zmiennych, a każda akcja ma pole Konfiguracja do wyboru OBS, którym steruje. Gdy OBS zostanie zamknięty lub sieć przestanie działać, Macro Deck ponawia próby połączenia i uruchamia wyzwalacze Rozłączono i Połączono.