Revox Multiuser System

Die Einrichtung der Lautsprecher erfolgt zuerst mittels Revox-App. Danach werden die eingebundenen Geräte automatisch erkannt. Jedes Gerät bekommt eine eigene ID zugeordnet, diese beginnt bei 100. Wird ein Gerät entfernt, so wird die ID im Hintergrund reserviert bleiben.

Unterstützt wird das Multiuser System 2.0 und 3.0. Bei der Version 3.0 werden ausserdem alle Zonen abgebildet. Die Zuordnung der Zonen erfolgt via Revox App oder mit dem folgenden Befehlen:

[zonen-id]:zone-owner:[raum-id]:on
[zonen-id]:zone-owner:[raum-id]:off

Wichtige Hinweise

Bei der Revox-Konfiguration gibt es einiges zu beachten. Werden diese Anweisungen nicht befolgt, können unvorhergesehene Probleme auftreten.

  1. Jeder Alias darf nur einmal definiert werden, auch bei den Quellen.
  2. Die Namen und die Aliasse dürfen eine maximale Zeichenlänge von 16 Zeichen nicht überschreiten.
  3. Der Name eines Alias darf das Zeichen : nicht enthalten.
  4. Die Schnittstelle findet nur Geräte, die auch tatsächlich verfügbar sind.
  5. Werden Einstellungen auf der Revox-Seite geändert, so wird ein Neu-Import bzw. die Suche nach Geräten der Installation seitens Antcas Control empfohlen. Dies kann auch durch einen Neustart des Revox Server herbeigerufen werden.

Kanäle erstellen

In der Struktur Geräte können Kanäle erstellt werden. Damit diese erstellt werden können, müssen diverse Voraussetzungen erfüllt sein.

Typen Voraussetzung
Lautsprecher Das Gerät muss in der Struktur ersichtlich sein.

Funktionsweise

Anders als bei der "normalen" Revox Action Server-Schnittstelle, werden hier alle Variablen bidirektional übertragen. Ausserdem wird das Websocket-Protokoll verwendet, um alle Informationen zu erhalten.

Jeder Zustand, der einer Quelle oder eines Benutzers, wird automatisch auf alle entsprechende Räume verteilt. Dies gilt auch für das Senden von Werten. Es kann vorkommen, dass ein Signal für einen Verstärker nicht gesendet wird, wenn dieser ausgeschaltet ist, da keine Quelle oder kein Benutzer zugeordnet ist.

Hinweis: Die nahtlose Unterstützung um Zonen via SPS zu bilden ist nicht implementiert. Diese sind der Konfiguration in der Revox Multiuser App zu bilden. Jedoch können die Zonen anstelle von Räumen verwendet werden.

Variablen

Folgende Variablen stehen im Raum zur Verfügung. Es wird empfohlen, die Variablen des jeweiligen Raumes zur Ansteuerung der Anlage über die Visualisierung zu verwenden.

Variable Werte Beschreibung
power TRUE/FALSE Player ein/aus
play TRUE/FALSE Play/Pause
next TRUE Nächster Track. Bei einer positiven Flanke wird geschaltet. Dieser Befehl ist nicht immer verfügbar.
prev TRUE Vorheriger Track. Bei einer positiven Flanke wird geschaltet. Dieser Befehl ist nicht immer verfügbar.
repeat TRUE/FALSE Alle wiederholen. Dieser Befehl ist nicht immer verfügbar.
seek 0..# Im Track spulen in Millisekunden. Verfügbar ab Multiuser 3.
shuffle TRUE/FALSE Zufällig wiedergeben. Dieser Befehl ist nicht immer verfügbar.
volume 0..255 Lautstärke in Prozent wird umgerechnet.
mute TRUE/FALSE Stumm
balance -10..10 Balance bei Stereolautsprechern einstellen.
bass -12..12 Bass von -12 dB bis +12 dB
treble -12..12 Höhen von -12 dB bis +12 dB
user Benutzer Zuordnung eines Benutzers. Alle Namen (ohne $-Präfix) befinden sich in der Schnittstelle unter Benutzer. Hier wird der jeweilige Alias verwendet.
source URI URI zur aktuellen Quelle.
cmd RAW RAW-Kommando auf das entsprechende Gerät.
Entspricht $r.room:RAW
!cmd RAW Wie cmd, jedoch werden alle Telegramme gesendet. Dies ist nützlich bei vielen Kommandos.
cover_url URL URL zum Albumcover.
duration 0..# Dauer des Tracks in Millisekunden. Verfügbar ab Multiuser 3.
infotext Mehrzeiliger Infotext. Dieser kann mit dem Funktionsblock EXPLODE getrennt werden. Es werden immer 3 Zeilen übertragen.

Quelle

Die Quelle source setzt sich aus dem Quellennamen und des Dienstes (Stream) zusammen. Es soll später möglich werden, komplexere Pfade zu hinterlegen, um eine Datei oder einen Radiosender direkt anzusprechen.

Der Name ist wie folgt aufgebaut:

$s.xx://radio

Ist der Benutzer-Stream gleich dem aktuellen Benutzer, so wird Folgendes zurückgegeben:

radio

Folgende Befehle sind möglich:

Wert Beschreibung
$.xx://radio Wählt die Quelle $.xx und stellt diese auf Radio um.
$.xx:// Wählt die Quelle $.xx
radio Stellt den aktuellen Stream auf Radio um. Dabei wird die Quelle auf den Benutzer-Stream gewechselt.
://radio Gleich wie oben.
fav/01 Referenz zu einem Favorit in der Favoritenliste des Benutzers.

Hinweis: Es wird immer versucht, den Player oder den Benutzer einzuschalten, wenn die Quelle gewechselt wird.

Senden von Kommandos

Um ein oder mehrere Kommandos zu Senden, wird die Variable cmd verwendet. Dieses Kommando findet sich auch in den einzelnen Benutzern, Räumen usw. Wird z.B. ein Raum-Kommando gesendet, wird der Präfix vom Raum automatisch angefügt.

Hinweis: Antcas Control verfügt über kein Kollisionsmanagement beim gleichzeitigen Senden eines Wertes auf diese Variable. Wenn die Schnittstelle wartet oder neu startet, wird nur der letzte Zustand gesendet.

Es ist möglich, mehrere Befehle hintereinander zu senden. Dies wird mit einer neuen Zeile oder dem Zeichen ; umgesetzt. So wird garantiert, dass die Befehle immer dieselbe Reihenfolge haben.

Das folgende Kommando wurde auf room100.cmd gesendet:

room:on
stream:spotify

Dies erzeugt auf dem Revox Action Server folgenden Befehl:

#RXXXXXXXXXXXXX:room:on; #RXXXXXXXXXXXXX:stream:spotify

Revox-Grafiken verwenden

Es gibt die Möglichkeit Grafiken von Revox direkt zu verwenden. Hierzu muss der Wert an das Visualisierungselement Bild übertragen werden.

Grafik Wert
Revox Logo "_revox_logo"

Vorlage

Die folgende Vorlage kann verwendet werden, um mit einem Raum zu kommunizieren. Die Vorlage besitzt folgende Funktionen:

  • Auswahl von Benutzern und diversen Quellen.
  • Automatisches Ausschalten nach 5 Minuten, bei nicht Verwenden des Raumes.
  • Automatisches Einschalten des Raumes, wenn auf Play geklickt wird.
  • Lautstärke-Anzeige wird als Dämpfungswert angezeigt.
  • Revox Logo wird verwendet, wenn der Raum nicht benutzt wird.
  • Internationale Übersetzung.
  • Kompatibel mit den Kanälen.

Es gilt zu beachten, dass diverse Einstellungen vorgenommen werden müssen. Diese sind meist die folgenden:

  • Die Benutzerliste ist anzupassen.
  • Max. Lautstärke in der SPS und der Visualisierung einstellen.
  • Bei M51 kann der Equalizer nicht direkt verwendet werden.
  • Anpassen oder Ausblenden der Favoritenliste.

Download: