Steuer-API und Stream Deck

Über die Steuer-API lösen das Stream Deck und eigene Skripte Aktionen im Studio aus, zum Beispiel einen Zähler erhöhen, einen Countdown starten oder ein Overlay ausblenden.

Stream Deck einrichten

Lade zuerst das Plugin unter Stream-Deck-Plugin herunter und starte die Datei mit einem Doppelklick. Das Stream Deck installiert es. Bei einer neuen Version lädst du die Datei erneut und startest sie wieder, der Zugang bleibt erhalten.

1. Öffne im Stream Deck bei einer Taste des Plugins Verbindung und wähle Mit Code koppeln. Das Plugin zeigt einen Code.
2. Klicke hier unter Alle Zugänge auf + Neuer Zugang. Gib bei Code vom Stream Deck den Code ein, vergib einen Name, wähle die Bereiche und klicke Anlegen. Im Browser öffnen im Plugin trägt den Code schon ein und wählt alle Bereiche vor.
3. Nach wenigen Sekunden ist das Stream Deck verbunden. Ziehe Aktionen auf die Tasten.

Tasten belegen

Ziehe in der Stream-Deck-App eine Aktion aus der Kategorie Streamercloud auf eine freie Taste und stelle sie darunter ein. Mit Server-Befehl wählst du einen Server-Befehl aus der Liste und trägst bei Argumente den Rest ein, zum Beispiel bei !timer den Namen eines Countdowns. Das geht für Goal, Scoreboard, Win-Challenge, Bingo, Giveaway, Clip-Battle, Rangliste, Tickets, WASD, Countdown und Glücksrad. Für Zähler, Overlays, Actionboard, Leuchten, Stream-Marker, OBS-Szenen, Quellen, Filter und Spotify gibt es eigene Aktionen. Jetzt auslösen probiert eine Taste aus.

Für eigene Skripte legst du einen Zugang ohne Code an, wählst bei Gültig die Laufzeit und kopierst den Token. Er ist nur einmal sichtbar.

Funktions-Aktion

Mit der Taste Funktions-Aktion löst das Stream Deck jede Aktion aus, die auf der Seite einer Funktion unter Auslöser in der Kachel Fernsteuern steht. Wähle in den Einstellungen der Taste die Funktion und ihre Aktion. Darunter stehen die Felder der Aktion, zum Beispiel welcher Countdown startet. Leere Felder nehmen ihren Standard. Fragt die Aktion nach Leuchten, hakst du die gewünschten an. Ohne Haken gilt sie für alle Leuchten.

Der Zugang braucht dafür den Bereich Funktions-Aktionen. Geheime Werte wie ein Discord-Webhook gehen über die Steuer-API nicht. Lege für solche Aktionen eine Automatik an.

Fernsteuern einer Funktion

Auf der Seite jeder Funktion mit Aktionen steht im Reiter Auslöser die Kachel Fernsteuern. Klicke bei einer Aktion auf Anleitung. Dort stehen ihre Felder, die Schritte für die Stream-Deck-Taste und die fertige Anfrage an die Steuer-API. Die Anfrage übernimmt die Werte aus den Feldern. Kopieren legt sie in die Zwischenablage. Ersetze darin rwc_… durch den Token deines Zugangs.

Fernsteuern eines Overlays

Leinwände und eigene Overlays mit Aktionen haben dieselbe Kachel Fernsteuern im Reiter Auslöser. Je Aktion, zum Beispiel Einblenden, steht dort ▶ Ausprobieren und die Anleitung. Im Stream Deck nimmst du dafür die Taste Overlay, wählst das Overlay, bei Wirkung „Aktion auslösen“ und die Aktion. Der Zugang braucht den Bereich Overlay-Einstellungen.

Moblin steuern

Mit der Taste Moblin wechselt das Stream Deck die Szenen am Handy und schaltet Stumm, Licht, Aufnahme, Live und Zoom. Der Zugang braucht den Bereich Moblin, das Handy muss unter Moblin fernsteuern verbunden sein. Für eine Regie legst du einen eigenen Zugang nur mit diesem Bereich an.

Automatik starten

Eine Automatik mit dem Auslöser Fernsteuern startest du mit der Taste Automatik im Stream Deck, über die Steuer-API oder mit Strg+K. Den Auslöser fügst du der Automatik unter Automatik hinzu. Der Zugang braucht den Bereich Automatiken. Ihre Bedingungen gelten weiter, zum Beispiel Nur live.

Aufrufe ausprobieren

Unter Aufrufe stehen alle Aufrufe der Steuer-API, nach Bereich geordnet. Mit Aufruf suchen findest du einen schnell, zum Beispiel „Zähler“ oder „/alerts“. Anleitung zeigt die Felder und die fertige Anfrage zum Kopieren.

1. Trage bei Token zum Ausprobieren den Token deines Zugangs ein. Direkt nach dem Anlegen übernimmt Gleich ausprobieren ihn für dich.
2. Klicke bei einem Aufruf auf Ausprobieren. Felder mit * sind Pflicht, die Anleitung zeigt sie. Die Antwort steht in der Zeile.

Ausprobieren löst wirklich aus. Bei allem, was etwas ändert, fragt die Seite vorher nach. Der Token bleibt nur im Browser, bis du die Seite schließt.

Sicherheit

Jeder Zugang steuert nur die freigegebenen Bereiche. Ein Bereich mit „(ab Unlimited)“ lässt sich schon freigeben, wirkt aber erst mit diesem Tarif. Gespeichert wird nur ein Fingerabdruck des Tokens. Unter Alle Zugänge siehst du, wann ein Zugang zuletzt benutzt wurde. Bearbeiten ändert Name und Bereiche, der Token bleibt gleich. Einen verlorenen Zugang widerrufst du im Menü ⋯ am Zugang mit Widerrufen.