===== Audiomapping in Voctomix =====
Über die Audiomapping-Einstellung in Voctomix kann gesteuert werden, welcher Audio-Eingang an z.B: einer Kamera in welchen Ausgabestrom in Stream und Recording landet.
Diese Einstellungen werden meistens zum Streamen von Übersetzerspuren benutzt, könnten aber auch z.B. für Backup-Recording von ungemischten Spuren verwendet werden.

(!) Die folgende Konfiguration bezieht sich auf das c3voc-cm, welches diese Optionen in die equivalente Voctomix-Config umsetzt. Siehe https://github.com/voc/cm/blob/master/ansible/roles/encoder/templates/voctomix-config/voctocore-config.ini.j2

==== Allgemeine Konfiguration ====
Die Konfiguration des Audiomappings erfolgt Pro-Raum in der cm-Konfigurations ''group_vars/saalX''.
Hierm uss zunächst die Anzahl der schlussendlich zu produzierenden Audipspuren definiert werden. Jede Audiospur ist immer automatisch eine Stereo-Spur.
<code>
# Anzahl der Stereo-Streams (1 = native, 2 = first translator, 3 = second translator, 4 = PA Backup)
voctomix_audiostreams: 2
</code>

Für eine Produktion mit nur einer ''native''-Audiospur ist hier ''1'' die korrekte Einstellung. Falls eine ''translated''-Spur geplant ist wäre ''2'' die richtige Wahl. Auf dem Congress waren hier ''4''-Spuren konfiguriert. Das CDN verwendet generell nur die ersten drei Spuren.


==== Mapping für interne DeckLink-Quellen ====
Falls mehrere Audiospuren von verschiedenen Quellen benutzt werden, empfielt es sich sicher zu stellen, dass die Konfigurationsoption ''voctomix_audio_source'' nicht gesetzt ist.
Diese Option ist ein Shortcut für die ''source.volume''-Optionen, die benötigt werden um Audio von mehreren Quellen verarbeiten zu können.
Es kann nur entweder ''voctomix_audio_source'' oder ''source.volume'' gesetzt sein, sonst beendet sich Voctomix mit einer entsprechenden Fehlermeldung. Für ''source.volume'' entspricht ''1.0'' einem 1:1 durchreichen des Signals, kleinere oder größere Zahlen sind zum Boosten oder Reduzieren des Pegels verwendet werden.

Beispiel-Basiskonfiguration im cm:
<code>
voctomix_sources:
  -
    # Duo Port 2
    name: cam1
    type: decklink-internal
    devicenumber: 1
    video_connection: SDI
    video_mode: "1080i50"
    deinterlace: assume-progressive
    volume: 1.0
    audiostream:
      # fill stereo-stream 0 (native) with sdi-channel 0 on both sides
      0: 0
  
      # fill stereo-stream 1 (backup) with sdi-channel 0 on both sides
      1: 1
</code>

Unter ''audiostream'' werden nun die Mappings definiert. Jeder Eintrag entspricht einem Stream im schlussendlichten Recording bzw. im Stream. Für diesen wird definiert, aus welchem der 16 SDI-Audio-Kanälen Voctomix die Audiodaten entnehmen soll.

=== Beispiel 1: eine Kamera, native+backup ===
Linkes und Rechtes Ohr des Ausgabestreams 0 sollen aus dem SDI-Kanal 0 gespeist werden.
Linkes und Rechtes Ohr des Ausgabestreams 1 sollen aus dem SDI-Kanal 1 gespeist werden.
<code>
  -
    name: cam1
    …
    audiostream:
      # fill stereo-stream 0 (native) with sdi-channel 0 on both sides
      0: 0
  
      # fill stereo-stream 1 (backup) with sdi-channel 0 on both sides
      1: 1
</code>

=== Beispiel 2: eine Kamera, native stereo ===
Linkes und Rechtes Ohr des Ausgabestreams 0 sollen aus den SDI-Kanälen 0 und 1 gespeist werden.
<code>
  -
    name: cam1
    …
    audiostream:
      # fill stereo-stream 0 (native) with sdi-channel 0 on left and sdi-channel 1 on right
      0: 0+1
</code>


=== Beispiel 3: zwei Kameras, cam1 native-stereo, cam2 backup-stereo ===
Linkes und Rechtes Ohr des Ausgabestreams 0 sollen aus den SDI-Kanälen 0 und 1 gespeist werden.
<code>
  -
    name: cam1
    …
    audiostream:
      # fill stereo-stream 0 (native) with sdi-channel 0 on left and sdi-channel 1 on right
      0: 0+1
  -
    name: cam2
    …
    audiostream:
      # fill stereo-stream 1 (backup) with sdi-channel 0 on left and sdi-channel 1 on right
      1: 0+1
</code>


=== Beispiel 4: zwei Kameras, cam1 native+translates, cam2 translated2+backup ===
Linkes und Rechtes Ohr des Ausgabestreams 0 sollen aus den SDI-Kanälen 0 und 1 gespeist werden.
<code>
  -
    name: cam1
    …
    audiostream:
      # fill stereo-stream 0 (native) with sdi-channel 0 on left and right
      0: 0

      # fill stereo-stream 1 (first translator) with sdi-channel 1 on left and right
      1: 1
  -
    name: cam2
    …
    audiostream:
      # fill stereo-stream 2 (second translator) with sdi-channel 0 on left and right
      2: 0

      # fill stereo-stream 3 (backup) with sdi-channel 1 on left and right
      3: 1
</code>


=== Beispiel 5: eine Kamera mit embedder, 4xstereo ===
Linkes und Rechtes Ohr des Ausgabestreams 0 sollen aus den SDI-Kanälen 0 und 1 gespeist werden.
<code>
  -
    name: cam1
    …
    audiostream:
    # fill stereo-stream 0 (native) with sdi-channel 0 on left and sdi-channel 1 on right
    0: 0+1

    # fill stereo-stream 1 (first translator) with sdi-channel 2 on left and sdi-channel 3 on right
    1: 2+3

    # fill stereo-stream 2 (second translator) with sdi-channel 4 on left and sdi-channel 5 on right
    2: 4+5

    # fill stereo-stream 3 (PA-Backup) with sdi-channel 6 on left and sdi-channel 7 on right
    3: 6+7
</code>



==== Mapping für TCP-Quellen ====
Für TCP-Quellen gibt es kein Mapping in Voctomix. Die TCP-Quellen müssen bereits die erwartete Anzahl von Stereo-Streams (z.B. 4 Streams für ''voctomix_audiostreams: 4'') zuliefern. Es ist Aufgabe des Quell-Befehls bei Bedarf Stille auf den unbenutzten Kanälen zu liefern.

==== Sonderfälle ====
Der BgLoop und die NoStream-/Pause-Loops bleiben Video-Only-Senken, es muss und sollte kein Ton zugeliefert werden; dieser würde ignoriert werden.

Der Pause-Musik-Senke nimmt einen einzelnen Stereo-Stream an und dupliziert diesen je nach konfigurierter Anzahl an Ausgabespuren.