Steuerung von Blackmagic ATEM Videomixern (Mini, Mini Pro, Television Studio, Constellation und mehr)

Steuern Sie Blackmagic ATEM Videomixer über ioBroker – unterstützt alle über 21 ATEM-Modelle von Mini bis Constellation 4K+.

Beschreibung

Dieser Adapter steuert Blackmagic Design ATEM- Videomischer über das Netzwerk. Er nutzt das per Reverse Engineering entwickelte ATEM-UDP-Protokoll mithilfe der atem-connection- Bibliothek und unterstützt über 21 Modellvarianten – vom ATEM Mini über Television Studio bis hin zum Constellation 4K+ – mit einer fähigkeitsbasierten Zustandserzeugung, die sich an das angeschlossene Gerät anpasst.

Merkmale

Programm-/Vorschau-Umschaltung – Programm- und Vorschaueingänge ändern
Übergänge – Schneiden, Automatik, manueller T-Bar; Mix-/Tauch-/Wisch-/DVE-/Sting-Styles mit Preisen pro Style
Überblenden zu Schwarz – FTB-Rate umschalten und konfigurieren
Upstream-Keyer (bis zu 4 pro M/E) – auf Luft, Typ, Füll-/Key-Quelle, Maske, Flug
Downstream-Keyer (bis zu 4) – auf Sendung, koppeln, automatisch, Rate, Füll-/Key-Quelle
Aux-Ausgänge (bis zu 48) — Quellenrouting
Audiomixer – Master-Verstärkung/Balance, Monitor, Verstärkung/Balance/Mix pro Eingang (Classic + Fairlight)
Farbgeneratoren – Farbton/Sättigung/Helligkeit
Streaming – Start/Stopp, Status, verwendeter Cache (unterstützte Modelle)
Aufnahme – Start/Stopp, Datenträger wechseln, Dauer, verbleibender Speicherplatz (unterstützte Modelle)
Medienplayer – Quellentyp, Standbild-/Clip-Index, Wiedergabesteuerung
Zählung – Programm-/Vorschau-Zählstatus
Makros – ausführen, stoppen, fortsetzen, wiederholen, benannte Slots (bis zu 100)
Eingabemetadaten – Kurz-/Langnamen, Porttyp
Automatische Modellerkennung – vom angeschlossenen Gerät ermittelte Funktionen

Anforderungen

js-controller >= 6.0.11
ioBroker Admin >= 7.8.23
Node.js >= 22
Blackmagic ATEM-Switcher mit Netzwerkanschluss

Installation

Installation über die ioBroker-Admin-Benutzeroberfläche: Adapter → suchen nach blackmagic-atem → installieren .

Konfiguration

Öffnen Sie die Adapterinstanzkonfiguration in ioBroker Admin.
Geben Sie die IP-Adresse Ihres ATEM-Geräts ein.
Wählen Sie das Modell aus (oder lassen Sie die automatische Erkennung aktiviert).
Passen Sie das Wiederverbindungsintervall bei Bedarf an.
Speichern und Adapter starten

Staatsbaum

info.connection
device.{modelName, productId, videoMode, capabilities}
me[0-3].{programInput, previewInput, inTransition, transitionPosition}
me[0-3].transition.{style, mixRate, dipRate, wipeRate, dveRate, wipePattern}
me[0-3].fadeToBlack.{isFullyBlack, inTransition, rate}
me[0-3].usk[0-3].{onAir, type, fillSource, keySource, maskEnabled, flyEnabled}
commands.{cut, auto, ftb}
dsk[0-3].{onAir, tie, inTransition, rate, fillSource, keySource, auto}
aux[0-47].source
audio.master.{gain, balance, afv}
audio.monitor.{enabled, gain, mute, solo, dim}
audio.inputs.input[N].{gain, balance, mixOption}
audio.commands.resetPeaks
colorGenerator[0-1].{hue, saturation, luminance}
streaming.{status, start, stop, duration, cacheUsed}
recording.{status, start, stop, switchDisk, duration, remainingDiskSpace}
mediaPlayer[0-3].{sourceType, stillIndex, clipIndex, playing, loop, atBeginning}
tally.{programInputs, previewInputs}
macros.{run, stop, continue, isRunning, isWaiting, loop, runningIndex, recordedCount}
macros.slots[0-99].{name, isUsed, trigger}
inputs.input[N].{shortName, longName, inputId, portType}

Zustände werden bedingt auf Basis der erkannten/ausgewählten Modellfunktionen erstellt. Verwaiste Zustände werden bei einer Modelländerung entfernt.

Anwendungsbeispiel

// Switch program to camera 1
setState('blackmagic-atem.0.me0.programInput', 1);

// Perform a cut
setState('blackmagic-atem.0.commands.cut', true);

// Start streaming (supported models only)
setState('blackmagic-atem.0.streaming.start', true);

// Run macro 5
setState('blackmagic-atem.0.macros.run', 5);

Eingabe-ID-Referenz

AUSWEIS	Quelle
1–8	Kameraeingänge
0	Schwarz
1000	Farbbalken
2001–2002	Farbgeneratoren 1, 2
3010, 3011	Mediaplayer 1, 2
3020, 3021	Medienplayer 1, 2 Taste
7001–7002	Sauberes Futter 1, 2
10010, 10011	Programm, Vorschau

Protokollnotizen

Dieser Adapter verwendet das durch Reverse Engineering entwickelte ATEM-UDP-Protokoll (Port 9910), wie von der Open-Source-Community dokumentiert:

Das ATEM-Protokoll verfügt über keine Authentifizierung – ATEM-Geräte sollten sich daher in einem vertrauenswürdigen, privaten Netzwerk befinden.

Changelog

0.2.10 (2026-09-27)

(Alan Paris) Fixed live updates on 2 M/E and 4 M/E switchers: changes to M/E 2-4 (program, preview, keyers, transitions) were not reflected until the next reconnect
(Alan Paris) Fixed live updates when one packet changes several areas at once, and classic-audio input gain/balance/mix option now update live
(Alan Paris) Fixed a connection leak: each network drop left the previous ATEM connection running, taking an extra switcher session
(Alan Paris) Object definitions (roles, names, ranges) are now updated on existing installations, not only on fresh installs
(Alan Paris) With model auto-detect, restarting the adapter no longer deletes states (and their history settings) that the connected model supports, e.g. M/E 2-4 or classic-audio monitor states
(Alan Paris) device.modelName now shows the product name (e.g. "ATEM Mini Pro") and device.productId the numeric model ID; previously they were swapped
(Alan Paris) Transition and fade-to-black rate states no longer default to 0, below their minimum of 1
(Alan Paris) Adapter now requires admin >= 7.8.23
(Alan Paris) Node.js 26 added to the test matrix
(Alan Paris) Updated dependencies (@iobroker/adapter-core 3.4.3, @iobroker/testing 6.2.2)

0.2.9 (2026-07-12)

(Alan Paris) Made macros.run write-only (it no longer retains the last-triggered index); use macros.runningIndex to read the active macro
(Alan Paris) Renamed recording.remainingDiskSpace to "Remaining Recording Time" and documented that its value is seconds of available recording capacity, not bytes
(Alan Paris) Stopped writing audio.master.afvCrossfade on Fairlight models, where the state does not exist

0.2.8 (2026-07-05)

(Alan Paris) Fixed upstream-keyer mask/fly enable and downstream-key pre-multiplied controls, which were writable but ignored, so they now apply to the switcher
(Alan Paris) Master audio gain now controls Fairlight mixers correctly (previously it sent a Classic-audio command that Fairlight models ignored)
(Alan Paris) Hid Classic-only audio controls (master balance/AFV crossfade, monitor enable/solo/dim) on Fairlight models, where they had no effect
(Alan Paris) Added default values to all dynamically created states

0.2.7 (2026-07-04)

(Alan Paris) Added a link to the Blackmagic Design ATEM product page in the README
(Alan Paris) Clamp the reconnect interval in code so out-of-range config values cannot break the timer
(Alan Paris) Removed the unused pollInterval config option (the adapter is fully push-based)
(Alan Paris) Removed the unused audio.master.programOutGain state

0.2.6 (2026-07-04)

(Alan Paris) Updated atem-connection to 3.9.0 and dev dependencies (@iobroker/types, rimraf)
(Alan Paris) Extended tsconfig from @tsconfig/node22 for standardized type checking
(Alan Paris) Switched Dependabot to cron schedules to distribute update load

License

MIT License — see LICENSE for details.