Dynamische Inhalte mit der Platzhalter API

Du kannst in Modulen Platzhalter im Format {{variable|default}} verwenden, um dynamische Inhalte mit Hilfe der Player-API zu befüllen. Dabei enstpricht der Wert „variable“ dem Schlüssel („key“) des API-Aufrufs, welcher durch den dort hinterlegten Wert („value“) ersetzt wird. Zusätzlich kannst du durch die optionale Verwendung von „default“ einen Standardwert für den Platzhalter definieren, der verwendet wird wenn in der Player-API kein Wert oder ein leerer Text („“) zum verwendeten Schlüssel gefunden wird.

Dies ist mein Beispieltext mit einer dynamischen Zahl „{{zahl|50}}“ im Text.

Natürlich kannst du auch mehrere Platzhalter im Modul gleichzeitig verwenden.

Du kannst auch über die Server-API eine Variable setzen. Schicke dafür einen POST-Request den Endpunkt https://api.framr.tv/tv/device/actions/var/ auf und übermittle dabei folgende Parameter:

• secret: API-Key … einen API-Key kannst du in den Gruppeneinstellungen erstellen
• id: Player-ID … die Player-ID findest du am Ende jener Browser-URL, die im Cockpit nach dem Klick auf einen Player angezeigt wird
• key: Variablenname
• value: Wert

Um mehrere Variablen gleichzeitig über die Server-API zu setzen, verwende folgende Parameter:

• secret: API-Key … einen API-Key kannst du in den Gruppeneinstellungen erstellen
• id: Player-ID … die Player-ID findest du am Ende jener Browser-URL, die im Cockpit nach dem Klick auf einen Player angezeigt wird
• key[]: Array der Variablennamen
• value[]: Array der entsprechenden Werte
• …
• key[]: Array der Variablennamen
• value[]: Array der entsprechenden Werte

Diese Methode erlaubt es, mehrere Schlüssel-Werte-Paare in einem einzigen Aufruf zu setzen, was besonders nützlich ist, um mehrere dynamische Inhalte im Player effizient anzupassen.

Im initialen Zustand des Players nach dem Start oder durch das Löschen des Wertes via API wird bei diesem Beispiel wieder der Standardwert „50“ ausgegeben.