Standardisiertes Schema beim Umgang mit Sonderansagen

Ein kleines Tutorial zur Implementierung von Sonderansagen in der ANNOUCEMENT-Klasse. Es wurde gemeinsam ein Konzept entwickelt, um die Sonderansagen mit in der 'ANNOUNCEMENT' - Klasse auszuliefern. Dies soll primär dazu dienen, dass alle IBIS Geräte mit der gleichen FIS-Datei die gleichen Sonderansagen abspielen können, ohne dass für jedes IBIS eine neue spezielle FIS angelegt werden muss. Diese Informationen werden innerhalb der Zusatz-Strings vermerkt.

Hierfür gilt folgendes:

Variable Typ Beschreibung EventID integer LOTUS-Interne ID, um Fahrgastinteraktionen zu triggern. z.B. Fahrgäste treten nach Ansage aus der Tür. Text string Text, welcher den Inhalt der Sonderansage beschreibt. Sollte kurz gehalten werden. Kann im IBIS-Gerät angezeigt werden. Dieser Text ist immer in Anführungszeichen "" zu setzen. ContentUserID integer Die Content-User-ID der erstellten Sonderansage. ContentSubID integer Die Content-Sub-ID der erstellten Sonderansage. Code integer Numerischer Code, der bei einem IBIS mit Ziffernblock eingegeben werden kann. z.B. 753 Target integer Zielbestimmung der Audio-Ausgabe. Hierbei wird zwischen Innen (0), Außen (1) oder beide (2) unterschieden. Diese Liste kann auch erweitert werden um individuelle Ausgabequellen anzusprechen.

Das ganze wird im INI-Format verfasst. Hierbei werden Blöcke mit den jeweiligen Daten gebildet. Dieser startet immer mit

[SpecialAnnouncement]. Darauf folgt dann der Aufbau, der im unten stehenden Spoiler zu erkennen ist. Anschließend folgt eine Leerzeile und der nächste Block beginnt.

Du kannst auch Kommentare in jeder Zeile einleiten. Dies funktioniert wie folgt:

Kommentar

Zudem existiert ebenfalls die Möglichkeit eine Sektion als [SpecialAnnouncementDefaults] zu deklarieren. Hier kann man generell geltende Werte der oben stehenden Tabelle festlegen.

Hier nochmal ein konkretes Beispiel vom Aufbau von 2 Blöcken und dem Default-Block:

Code: Aufbau

Global geltende Werte

[SpecialAnnouncementDefaults] ContentUserID=5750029

Erste Sonderansage

[SpecialAnnouncement] EventID=7 Text="Aus Lichtschranke treten" ContentSubID=13001 Code=753 Target=0

Zweite Sonderansage

[SpecialAnnouncement] EventID=9 Text="Ausbildungsfahrt, nicht einsteigen"

Abweichende CUID

ContentUserID=5750030 ContentSubID=13002 Code=42 Target=1 Alles anzeigen

Freundlicherweise wurde von Teneberus ein fertiges Script zur Verfügung gestellt, um die Elemente der Liste auszulesen und in einem Array zu speichern (Skript ist im Anhang zu finden). Dieses Script sollte 1:1 in den Code eingelesen werden. Anschließend sind die Inhalte eines SpecialAnnouncement-Elements mit folgenden Variabeln aufrufbar:

Variabelname

Typ Zu erwartender Inhalt

SpecialAnnouncement[0].EventID integer 7 SpecialAnnouncement[0].Text string Aus Lichtschranke treten SpecialAnnouncement[0].ContentUserID integer 0 (Weil nicht definiert, stattdessen sollte die Default abgefragt werden) SpecialAnnouncementDefaults.ContentUserID integer 5750029 SpecialAnnouncement[0].ContentSubID integer 13001 SpecialAnnouncement[0].Code integer 753 SpecialAnnouncement[0].Target integer 0 SpecialAnnouncement[1].EventID integer 9 SpecialAnnouncement[1].Text string Ausbildungsfahrt, nicht einsteigen SpecialAnnouncement[1].ContentUserID integer 5750030 SpecialAnnouncement[1].ContentSubID integer 13002 SpecialAnnouncement[1].Code integer 42 SpecialAnnouncement[1].Target integer 1

Vergiss nicht: der Array-Index fängt immer bei 0 an. Also der erste Eintrag ist immer mit [0] aufrufbar, der zweite mit [1], usw.

Was passiert, wenn ich was falsch mache?

Prinzipiell ist der Parser von Teneberus gut geschrieben. Also wenn du nach einem Element vergisst ihm einen Wert zuzuweisen, z.B. EventID= schreibst, wird der nicht vorhandene Wert durch -1 ersetzt. Wenn du beim Text die Anführungsstriche "" weglässt, wird der Text trotzdem richtig zugewiesen.

Falls du ein ganzes Element weglassen solltest, ist beim Aufruf von diesem einfach kein Inhalt vorhanden oder eine 0 (bei Integer).

Mögliche kommende Änderungen:

Hinzufügen eines weiteren Strings, der an Innenanzeigen gebroadcastet werden kann.