Seite: Präsentationsmonitor

Route

/presentation/monitor

Die Route öffnet die Vollbildausgabe für Beamer oder Display. Sie wird typischerweise über den Button Präsentation starten auf /presentation/remote geöffnet.

Zweck

Der Monitor rendert den aktuellen Präsentationszustand der aktiven Show. Er zeigt Titelfolie, leere Fläche, freien Text oder Liedabschnitte und ergänzt bei Liedern die rechtlichen Angaben.

Datenfluss

Die MonitorComponent liest global/static.currentShow über GlobalSettingsService.get$. Aus dieser ID lädt sie die Show über ShowService.read$(showId) und übernimmt daraus die Live-Felder für Anzeigezustand, Datum, Veranstaltungstyp, Zoom, Hintergrund und freien Text.

Für Song-Inhalte beobachtet der Monitor presentationSongId. Bei title, dynamicText oder fehlender Song-ID wird kein Song gesetzt. Bei anderen Werten lädt er den passenden Show-Song über ShowSongService.read$(showId, presentationSongId).

Konfigurationsdaten für rechtliche Hinweise kommen aus ConfigService.get$(). Die Komponente app-legal nutzt diese Daten unter anderem für die CCLI-Lizenznummer.

UI-Anzeige

Beim Initialisieren ruft der Monitor openFullscreen() auf. Die Anzeige liegt als fixierte Vollbildfläche über der Anwendung und blendet den Mauszeiger aus.

Der Monitor kennt folgende Zustände:

title: zeigt den übersetzten Veranstaltungstyp und das Datum.
empty: zeigt die leere Präsentationsfläche mit Logo beziehungsweise Hintergrund.
dynamicText: zeigt presentationDynamicCaption und presentationDynamicText.
Show-Song-ID: rendert app-song-text mit Songtitel, Liedtext und aktivem Abschnitt.

Bei Songs werden Akkorde ausgeblendet (chordMode="hide"), Kommentare nicht angezeigt und die interne Abschnittsnavigation des Song-Text-Widgets deaktiviert. Der aktive Abschnitt kommt aus presentationSection.

Zusammenspiel von Remote und Monitor

Der Monitor ist ein reiner Live-Reader. Alle Bedienhandlungen erfolgen in der Remote-Steuerung; der Monitor reagiert auf die Felder, die dort auf der aktiven Show gespeichert werden.

Wenn die Remote presentationSongId, presentationSection, presentationZoom, presentationBackground, presentationDynamicCaption oder presentationDynamicText ändert, aktualisiert der Monitor seine Darstellung über die abonnierten Datenströme. Beim Wechsel der aktiven Show über /presentation/select liest der Monitor die neue currentShow aus den globalen Settings und richtet die Ausgabe darauf aus.

Live-Felder auf der Show

Der Monitor wertet folgende Felder aus:

presentationSongId: entscheidet über Titelfolie, Leerseite, freien Text oder Songanzeige.
presentationSection: bestimmt den aktiven Abschnitt im Songtext.
presentationDynamicCaption: Überschrift für den freien Text.
presentationDynamicText: Inhalt für den freien Text; Zeilenumbrüche bleiben durch die Monitor-Styles erhalten.
presentationZoom: wird als Pixelwert auf die Vollbildfläche gesetzt.
presentationBackground: schaltet die Hintergrundgrafik.

Zusätzlich nutzt er showType und date für die Titelfolie.

Hintergründe

presentationBackground unterstützt diese Werte:

none: schwarzer Hintergrund ohne Bild.
blue: assets/bg-dark-blue.jpg
green: assets/bg-dark-green.jpg
leder: assets/bg-leder.jpg
praise: assets/bg-praise.jpg
bible: assets/bg-bible.jpg

Die Bildhintergründe werden vollflächig gerendert, weich eingeblendet und je nach Motiv mit Blur und reduzierter Deckkraft versehen. Bei aktivem Bildhintergrund wird das Logo in Songzuständen vollständig ausgeblendet.

Rechtliche Angaben

Bei Songanzeige rendert app-legal die verfügbaren Metadaten des Songs:

Künstler
Label
Nutzungsbedingungen
Herkunft
Liednummer beziehungsweise CCLI-Liednummer

Wenn song.legalOwner den Wert CCLI hat und Konfiguration geladen ist, wird zusätzlich die CCLI-Lizenznummer aus ConfigService angezeigt.

Technische Besonderheiten

Songwechsel werden um 600 ms verzögert. Vor dem Umschalten setzt die Komponente intern songId auf empty, damit die songSwitch-Animation sauber zwischen den Zuständen wechseln kann. Ein laufender Timeout wird beim nächsten Wechsel oder beim Zerstören der Komponente abgebrochen.

Die Show-Daten werden mit shareReplay(1) geteilt, damit die separaten Streams für allgemeine Präsentationsdaten und Song-Ladevorgänge dieselbe Show-Quelle verwenden. Subscriptions werden über destroy$ beendet.

4.5 KiB Raw Blame History