In den TTS-Optionen der Monitor-App können Sie frei nach Ihren Wünschen die Sprachausgabe gestalten. Dazu kann unter Einstellungen > Sprachausgabe das Template angepasst und getestet werden.
Folgendes Ausgabeschema ist standardmäßig hinterlegt. Es zeigt gut, wie bestimmte Sätze abhängig von Bedingungen vorgelesen werden können.
In dem Fall wird "Es rücken aus: HLF 10, MTF, TSF W" nur vorgelesen, wenn tatsächlich Fahrzeuge alarmiert sind.
{% play %} Achtung! {{ alarm.title }} {{ alarm.text }} {{ alarm.address }} {% pause %}
{% if vehicles.size > 0 %} Es rücken aus: {{ vehicles | map:"shortname" | join:", " }} {% endif %} |
Für die Sprachausgabe wird die Syntax von LiquidJS verwendet. So kann von einfachen Platzhaltern bis hin zu komplexen Bedingungen alles implementiert werden.
Variablen werden über zwei geschweifte Klammern eingefügt, auf Eigenschaften von Objekten wird über einen Punkt (.) zugegriffen.
Statischer Text: {{ variable.eigenschaft }} und hier geht es weiter mit Text |
Der Alarm-Datensatz steht vollständig als Objekt unter alarm zur Verfügung, wie er auch in der API verfügbar ist: https://api.divera247.com/?urls.primaryName=api%2Fv2%2Fpull
Hier ein paar Beispiele:
{{ alarm.title }} |
{{ alarm.address }} |
{{ alarm.text }} |
Die adressierten Fahrzeuge stehen als Liste/Array unter vehicles zur Verfügung. Auf Arrays kann per Index (beginnend von 0) explizit zugegriffen werden, um bspw. nur das erste Element vorzulesen:
{{ vehicles[0].shortname }} |
Jedes Fahrzeug besteht dabei aus folgendem Objekt:
{
id: 42,
clusterId: 666,
name: "6-HLF-10-1",
shortname: "HLF 10",
fmsStatus: 2
} |
Um für alle Fahrzeuge eine bestimmte Eigenschaften vorzulesen, empfiehlt es sich den Filter map in Kombination mit join zu verwenden, z.B. wie folgt:
{{ vehicles | map:"shortname" | join:", " }}
Beispielausgabe: HLF 10, MTF, TSF W |
Neben Platzhaltern gibt es auch die Möglichkeiten bestimmte Funktionen auszuführen, sie werden mit wie folgt aufgerufen:
{% funktion parameter1:wert1, parameter2:wert2 %} |
Über play kann ein Gong bzw. eine zuvor ausgewähltes Soundfile abgespielt werden.
{% play %} |
Optional kann dabei über den file Parameter wird eine eigene Datei referenziert, dabei ist 0 der Standardsound und beginnend von 1 die selbst hinzugefügten Sounddateien. Mit folgendem Beispiel lässt sich die Datei Nummer "2" abspielen
{% play file:2 %} |
Über pause kann eine Pause ausgeführt werden. Dabei wird über seconds und minutes die Dauer in Sekunden bzw. Minuten angegeben. Beide Parameter sind optional.
{% pause seconds:1, minutes:0 %} |
Mit Filtern können aus Objekten oder Listen/Arrays bestimmte Daten Die verfügbaren Filter sind in der Dokumentation aufgelistet: https://liquidjs.com/filters/overview.html