====== Wichtige Control Commands ======
Control Commands sind Befehle, die bestimmte Operationen in der Software ausführen, z.B. dass die Aufnahme angemacht wird. Diese Befehle können global in den Settings bei bestimmten allgemeinen Aktionen ausgeführt werden (Global Commands), zu Programmevents, zu Skriptevents und schließlich bei einzelnen Tracks. Anbei folgt eine Auflistung der wichtigsten Befehle für die einzelnen Einsatzgebiete. Eine Auflistung und Erklärung aller Befehle findest du im **Appendix des [[http://www.proppfrexx.radio42.com/v3/ProppFrexx%20ONAIR%20UserManual%20v3.0.pdf|User Manual]]**.
===== Für Livesendungen =====
Bei Livesendungen sollten 2 Operationen zu Beginn ausgeführt werden: Aufnahme anschalten für den Mixerkanal, der nach draußen streamt (Main) und Autoplay ausschalten.\\
Daher wird unter //Edit Program// im //Program Scheduler// die Option //Control Commands// aufgerufen. Dort tragen wir unter On Programm Started folgende Befehle ein:\\
<code>MIXER_OUTPUT_REC_ON Main|</code>\\
**Zur Erklärung:** Beim Main-Kanal handelt es sich um einen Output-Kanal, da Sound wiedergegeben wird (=> MIXER_OUTPUT), wir möchten die Aufnahme anschalten (=> REC_ON), der Kanal heißt Main (=> Main) und die Datei soll nicht speziell benannt werden (=> |).
<code>PLS_CURRENT_AUTOPLAY_OFF</code>\\
**Zur Erklärung:** Wir möchten dass in der aktuellen Playlist (=> PLS_CURRENT) Autoplay ausgeschalten wird (=> AUTOPLAY_OFF)
===== Für Overlays =====
Bei Overlays brauchst du normalerweise keine Befehle einsetzen (außer du möchtest einen speziellen Effekt erzielen), allerdings solltest du folgende Befehle verwenden, wenn es sich um Sendungswiederholungen handelt.\\
Unter den //Control Commands// bei //Edit Overlay// trägst du bei //On Overlay Played// ein:
<code>MIXER_OUTPUT_DSP_SET Main|DSP1|BYPASS|1.0</code>
**Zur Erklärung:** Unsere Sendesumme (Main Mixer-Kanal) wird durch ein DSP-Plugin geregelt (JB Broadcast), das die Lautstärke konstant auf -1db angleicht, d.h. es kommen verschiedene Kompressoren und Limiter zum Einsatz. Da die Sendungsaufnahmen bereits von der Lautstärke her angeglichen sind, wird das DSP-Plugin bei Sendungswiederholungen deaktiviert, um eine Überkomprimierung zu vermeiden. Dafür muss also das DSP-Plugin eines Output-Kanals beim Mixer (MIXER_OUTPUT_DSP_SET) auf dem Kanal Main im Slot DSP1, auf dem das Plugin liegt, mit der Option BYPASS deaktiviert werden (=> 1.0 entspricht dem Wert true).\\
Bei **On Overlay Stopped** trägst du folgendes ein: \\
<code>MIXER_OUTPUT_DSP_SET Main|DSP1|BYPASS|0.0</code>
**Zur Erklärung:** Nachdem die Sendungswiederholung beendet ist, muss das DSP-Plugin wieder aktiviert. Also benötigen wir genau den gleichen Befehl, nur dass die Option BYPASS wieder ausgeschaltet wird. Das geht mit dem Wert für //false// (=> 0.0)
===== Für Liveübertragungen =====
Bei Liveübertragungen brauchen wir folgende Befehle: Den Stream der Liveübertragung abspielen, die Aufnahme anschalten (Schritt 1), die bisherige Playlist schließen (Schritt 2). 
==== Schritt 1 ====
Dafür erstellen wir im Program Scheduler einen Reminder (Rechtsklick, New Reminder). Dieser Reminder braucht keine Recurrence (Wiederholung) und dort stellen wir im unteren Feld mit Edit die Befehle ein.\\
<code>MODSTREAM_WATCHER_START http://streamplus28.leonex.de:28978|0|true|true|Liveübertragung von XY</code>\\
Um den Befehl besser zu verstehen, hier nochmal die Rohfassung: <code>MODSTREAM_WATCHER_START <url>[|<length>|<stopPlaylist>|<startWithNextTrack>[|<songTitle>]]</code>
**Zur Erklärung:** Um einen Stream abzuspielen, benötigen wir den Modstream Watcher (so heißt nunmal das Programm), daher MODSTREAM_WATCHER_START. Mit <url> ist die Streamingadresse des Live-Streaming-Servers gemeint. Dieser ist zur Zeit unter [[http://streamplus28.leonex.de:28978]] zu erreichen. Mit <length> ist die Länge gemeint, die wiedergegeben werden soll. In den meisten Fällen ist diese Länge nicht genau zu benennen, daher 0 eintragen, was unendlich heißt. <stopPlaylist> fragt, ob die aktuelle Playlist gestoppt werden soll => JA! => true. Mit <startWithNextTrack> wird festgelegt, ob fix zur angegebenen Zeit des Reminders die Wiedergabe gestartet werden soll oder erst nach Endes des gerade laufenden Tracks. Wenn man einen sauberen Übergang will, sollte man hier ebenfalls true eintragen. Als letztes wird die Songtitel im Stream definiert.\\
<code>MIXER_OUTPUT_REC_ON Main|</code>\\
**Zur Erklärung:** Beim Main-Kanal handelt es sich um einen Output-Kanal, da Sound wiedergegeben wird (=> MIXER_OUTPUT), wir möchten die Aufnahme anschalten (=> REC_ON), der Kanal heißt Main (=> Main) und die Datei soll nicht speziell benannt werden (=> |).
==== Schritt 2 ====
Wir erstellen nochmals einen Reminder und dieses mal genau eine halbe Stunde später (oder weniger, aber nicht zeitgleich!) als der bisher eingeplante Reminder für die Liveübertragung. Dieser Reminder ist nun nur dafür zuständig, die geöffneten Playlisten in der Automation zu schließen. Hintergrund dafür ist folgendes: Sollte der Stream abreißen, wird nichts mehr wiedergebenen in der Automation. Das erkennt die Studioautomation und schaltet spätestens nach 5 Minuten Autoplay an und sollte dann eine Playlist offen sein, werden die Lieder darin abgespielt und der Modstream Watcher geschlossen. 
Daher tragen wir im Reminder folgenden Befehl ein:
<code>PLS_CLOSE_ALL</code>
**Zur Erklärung:** Alle (=> ALL) Playlisten (=> PLS) sollen geschlossen werden (=> CLOSE).
===== Für den Mixer =====
Für jeden einzelnen Kanal im Mixer in ProppFrexx können Befehle definiert werden. 
==== In-Kanäle ====

==== Main-Kanal ====

===== Globale Befehle =====
==== Player ====
==== On Air ====

{{tag>Livesendung Liveübertragung Streaming Mixer OnAir Player Befehle Commands Command-Builder Modstream Aufnahme Aircheck Automation ProppFrexx Midi Controller}}