Den Player auf Ihrem Bildschirm installieren

Welche Player sind verfügbar?

Player: die Player-Web-App (PWA), Android über Google Play, Amazon Signage Stick, Apple TV, macOS, iPhone und iPad, Windows, Pakete für Linux und Raspberry Pi, LG webOS Signage, BrightSign und Samsung Smart Signage (Tizen). Installieren Sie einen nativen Player für die schnellste und zuverlässigste Wiedergabe.

Die Player-Web-App (PWA) unter play.screenrig.ai/player/ läuft auf jedem Bildschirm mit modernem Browser: einem Smart-TV oder kommerziellen Display mit integriertem Browser, einem verwalteten ChromeOS-Gerät im Kiosk-Modus, einem Tablet oder einem an den Bildschirm angeschlossenen Computer. Eine Status-Only-Einbettung des Players ist unter play.screenrig.ai/player/embed/status/ verfügbar.

Jeder Player zeigt einen Kopplungscode an. Geben Sie ihn Ihrem Agenten, der kümmert sich dann darum.

Jeder Player außer Windows zeigt auf seinem Kopplungsbildschirm auch einen QR-Code an. Scannen Sie ihn mit einem Smartphone, das im Dashboard angemeldet ist, und bestätigen Sie mit Bildschirm koppeln.

Eventualer Sync

Android-, Amazon Signage Stick-, macOS-, Windows-, Linux- und Raspberry Pi-Player gleichen Seitenwechsel allmählich mit benachbarten Playern ab, die dieselbe Playlist-Revision anzeigen. Weisen Sie Bildschirmen im selben IPv4-Subnetz dieselbe Playlist zu. Verwenden Sie feste Seitenzeiten von mindestens einer Sekunde, keine Übergänge und keine Eintrittsanimationen. Jeder Player sendet ein kleines Seitenstart-Signal und nimmt eine winzige Anpassung seiner Wartezeit vor dem nächsten Seitenwechsel vor. Zeitliche Anpassungen werden erst aktiviert, wenn ein zweiter Player mit derselben Playlist-Revision entdeckt wird. Bildschirme mit unterschiedlichen Playlists beeinflussen sich nicht gegenseitig. Ein einzelner Bildschirm behält seine normale Wiedergabezeit bei; die Gruppe folgt der mittleren Wiedergabeposition, sobald Peers beitreten.

Das Netzwerk muss geräteübergreifende UDP-Broadcasts auf Port 49817 zulassen. Erlauben Sie lokalen Netzwerkzugang, wenn das Gerät dies anfragt. Bildschirme spielen trotz Paketverlust, Stromausfällen und Netzwerkpartitionen weiter und synchronisieren sich erneut, sobald Seiten-Beacons eintreffen. Jede zusätzliche Wartezeit ist auf 40 Millisekunden begrenzt. Lange Seiten und große Zeitunterschiede benötigen länger zum Konvergieren; dies synchronisiert Seitenwechsel statt Videobilder oder Tonspuren.

Um einen Standort schnell zusammenzuführen, bitten Sie Ihren Agenten, die Wiedergabe auf seinen Bildschirmen mit screen reload --tag LOCATION neu zu starten, wobei LOCATION durch deren gemeinsamen Tag ersetzt wird. Die Player starten berechtigte Playlists auf der ersten Seite neu und vollenden die Ausrichtung über ihre regulären Beacons. Kopplung und heruntergeladene Inhalte bleiben erhalten.

Einen nativen Player installieren

Jeder Download ist auch auf der Download-Seite verfügbar.

1. 01

   Installieren Sie den Player für Ihr Bildschirmgerät.

2. 02

   Starten Sie es. Es öffnet sich im Vollbildmodus und zeigt einen Kopplungscode an.

3. 03

   Geben Sie den Kopplungscode an Ihren Agenten. Er koppelt den Bildschirm und veröffentlicht darauf.

Jeder native Player lädt Medien einmal herunter, speichert sie im Cache und spielt sie aus dem lokalen Speicher ab.

Installieren Sie die Android-APK

Verwenden Sie die APK auf Android-TVs, Google-TV-Geräten, Tablets und Signage-Boxen mit Android 9 oder höher, die Google Play nicht verwenden. Verwenden Sie sie bei der Installation per ADB.

Die APK ist signiert und öffentlich. Es ist derselbe Player wie der Google Play-Build. Der Dateiname enthält die Version, verwenden Sie daher https://screenrig.ai/android/manifest.json als einzigen Verweis auf die aktuelle Datei.

Bevor Sie beginnen, aktivieren Sie die Entwickleroptionen und USB-Debugging oder Netzwerk-Debugging auf dem Gerät. Sie benötigen außerdem adb auf Ihrem Computer.

1. Verbinden Sie sich mit dem Gerät. Für ein Netzwerkgerät führen Sie adb connect DEVICE_IP:5555 aus.

2. APK herunterladen, prüfen und installieren:

   curl -fsSL https://screenrig.ai/android/manifest.json -o manifest.json
   path=$(jq -r .player.path manifest.json); sha=$(jq -r .player.sha256 manifest.json)
   curl -fsSLO "https://screenrig.ai$path"
   echo "$sha  ${path##*/}" | sha256sum -c -
   adb install -r "${path##*/}"
   adb shell am start ai.screenrig.player

3. Der Player öffnet den Vollbildmodus und zeigt einen Kopplungscode an. Geben Sie den Code an Ihren Agenten weiter.

Beim Start starten

Beim Start ausführen ist standardmäßig aktiviert. Es ist ein Schalter in den Player-Bedieneinstellungen: Sobald der Bildschirm gekoppelt ist, drücken Sie OK auf der Fernbedienung, um das Menü zu öffnen, und wählen Sie Einstellungen. Unter Android 9 ist keine Berechtigung erforderlich. Unter Android 10 und höher gewähren Sie Anzeige über anderen Apps, es sei denn, das Gerät wird gerätebesitzerverwaltet: Wählen Sie Beim Start ausführen und folgen Sie der Aufforderung. Wo ein Berechtigungsbildschirm verfügbar ist, fragt der Player beim ersten Anzeigen des Kopplungscodes danach: Wählen Sie Einstellungen öffnen und erlauben Sie Anzeige über anderen Apps. Bis die Berechtigung erteilt ist, zeigt die Zeile Berechtigung erforderlich an und der Player startet nicht beim Booten. Sie können die Berechtigung auch mit ADB erteilen:

adb shell cmd appops set ai.screenrig.player SYSTEM_ALERT_WINDOW allow

Unter Fire OS 8 erteilen Sie diese Berechtigung mit ADB; der Einstellungsbildschirm bietet sie nicht an.

Bildschirmschoner

Auf Android TV und Google TV ist screenRIG einer der Bildschirmschoner des Fernsehers. Öffnen Sie Bildschirmschoner in den Einstellungen des Fernsehers und wählen Sie screenRIG. Wenn der Fernseher seinen Bildschirmschoner starten würde, kommt der Player in den Vordergrund und spielt Ihre Inhalte ab. Es ist keine Berechtigung erforderlich.

Aktualisiere

Führen Sie die Installationsschritte erneut aus. Android installiert die höhere Version über die installierte und behält Ihre Kopplung. Nur eine höhere Version ersetzt die installierte.

Google Play

Die APK und der Google Play-Build teilen sich das Paket ai.screenrig.player. Wenn der Google Play-Build installiert ist, deinstallieren Sie ihn zuerst. Koppeln Sie den Player nach der Installation der APK erneut.

Linux und Raspberry Pi

Der Linux Player ist ein eigenständiges Paket für 64-Bit-Linux, gebaut für x86_64 PCs und aarch64 Boards wie den Raspberry Pi. Qt, Qt WebEngine und GStreamer sind im Paket enthalten. Die Maschine benötigt die unter screenrig.ai/linux/ für ihre Architektur angegebene glibc-Version, eine Wayland-Sitzung oder den cage Kiosk-Compositor sowie eigene GPU-Treiber, Schriftarten, CA-Zertifikate und einen Audiodienst.

Installieren Sie es mit dem Installer, der die passende Version für die Maschine auswählt und sie gegen SHA256SUMS überprüft:

curl -fsSL https://screenrig.ai/linux/install.sh | sh

Auf einem dedizierten Bildschirm fügen Sie --kiosk (sh -s -- --kiosk) hinzu, um den Player beim Booten innerhalb von cage unter einem systemd-Dienst zu starten. Führen Sie den Installer erneut aus, um ein Upgrade durchzuführen, oder mit --uninstall, um ihn zu entfernen. Manuelle Installation: Laden Sie screenrig-player-linux-x86_64.tar.gz oder screenrig-player-linux-aarch64.tar.gz und SHA256SUMS von screenrig.ai/linux/ herunter, prüfen Sie sie mit sha256sum --ignore-missing -c SHA256SUMS, entpacken Sie sie nach /opt/screenrig-player und führen Sie /opt/screenrig-player/screenrig-player aus.

Debian 13, Raspberry Pi OS (trixie, 64-Bit), Ubuntu, Fedora und Arch Linux führen den Player aus, wenn sie die glibc-Anforderung des Pakets erfüllen. Debian 12 und Raspberry Pi OS bookworm enthalten eine ältere glibc; aktualisieren Sie diese zuerst. Distributionsspezifische Pakete für eine Kiosk-Installation finden Sie in den Linux-Download-Hinweisen.

Raspberry Pi

Verwenden Sie Raspberry Pi OS (64-Bit) basierend auf trixie; die 32-Bit- und Bookworm-Images können den Player nicht ausführen. Raspberry Pi 5 dekodiert HEVC hardwareseitig bis zu 4K mit 60 fps und hat keinen H.264-Decoder, laden Sie also jedes Video dafür in jeder Größe mit screenrig media upload --codec hevc hoch. Raspberry Pi 4 spielt 1080p ab. Raspberry Pi OS Lite mit --kiosk startet direkt in den Player.

Behalten Sie die gewählte Bildschirmauflösung bei: Ein 4K-HEVC-Video wird auf einem 1920×1080-Ausgang wiedergegeben. Um einen Pi-Player zu aktualisieren, führen Sie das Linux-Installationsprogramm mit dem bestehenden Installationspräfix und Player-Benutzerkonto erneut aus; Kopplung und Anzeigeeinstellungen bleiben erhalten. Das Neuladen eines Bildschirms aktualisiert die Inhalte und installiert keine neue Player-Version.

Videowände

Ein Player steuert 2 bis 12 Displays als eine Wand: der Linux-Player bei einer --kiosk-Installation mit wlr-randr (sudo apt install wlr-randr) und der Windows-Player. Ein Raspberry Pi 5 steuert zwei Displays; ein PC steuert so viele, wie seine Grafikausgänge erlauben, und ein Intel-Mini-PC wie der Quieter 4C steuert bis zu drei. Der Windows-Player richtet das Display-Layout von Windows selbst ein: Er positioniert und dreht die Displays und spiegelt sie über den Duplizierungsmodus von Windows bei einer Playlist ohne format. Windows behält seine eigene Display-Skalierung.

screen show listet die Ausgänge des Bildschirms, zum Beispiel HDMI-A-1 unter Linux oder DISPLAY1 unter Windows. Eine Wand ist row (von links nach rechts), column (von oben nach unten) oder grid. Ein Raster benötigt --columns, die Displays pro Zeile, und füllt mindestens zwei Zeilen: 12 Displays in 4 Spalten ergeben 3 Zeilen. Die Displays werden von links nach rechts, dann von oben nach unten nummeriert, und --outputs benennt die Ausgänge in dieser Reihenfolge. --rotation dreht jedes Display um 0 (Standard), 90, 180 oder 270 Grad im Uhrzeigersinn; 90 und 270 sind Hochformat-Panels.

screenrig screen wall set SCREEN_ID --outputs HDMI-A-1,HDMI-A-2 --arrangement row [--rotation 0|90|180|270]
screenrig screen wall set SCREEN_ID --outputs DISPLAY1,DISPLAY2,DISPLAY3,DISPLAY4 --arrangement grid --columns 2
screenrig screen wall clear SCREEN_ID

Nach einem Wandwechsel zeigt jedes Display seine Nummer und den Ausgabename für 20 Sekunden an, damit Sie die Reihenfolge überprüfen können.

Eine für die Wand erstellte Playlist enthält ein format (displays, arrangement, orientation und bei einem Raster columns) und eine Seitenleinwand, in 1080p-Design-Einheiten pro Display: Eine Kachel ist im Querformat 1920 × 1080 oder im Hochformat 1080 × 1920 groß, und die Leinwand ist die Kachel mal Spalten und Zeilen. Ein 4K-Panel benötigt nichts anderes. Ein Bildschirm spielt eine Wand-Playlist nur, wenn seine Wand dieselbe Form hat.

Platzieren Sie ein Element mit displays: [1,2,3] erstreckt sich über drei Displays in einer Reihe, [2] sitzt auf einem Display und [1,2] erstreckt sich über zwei. Die Displays füllen ein Rechteck der Wand: Bei einem Raster mit 4 Spalten ist [1,2,5,6] der Block oben links und [3,7,11] eine Spalte aus drei Displays. Oder geben Sie eine freie rect auf der Wandfläche. Eine Karte wird innerhalb ihres displays angeordnet, sodass center auf [2] in der Mitte von Display 2 sitzt; ohne displays nutzt sie jedes Display. Auf einem Bildschirm mit Wand spielt eine gewöhnliche Playlist (kein format) gespiegelt auf jedem Display.

Wandvideo im Seitenverhältnis der Wand innerhalb von 4K rendern, z. B. 3840 × 720 für drei Querformat-Displays in einer Reihe, 3840 × 1080 für zwei und 3840 × 1620 für ein Raster mit 4 Spalten und 3 Zeilen, und es mit content_fit: fill platzieren. Text und Gesichter nicht auf die Nähte zwischen den Displays legen.

{
  "name": "Lobby wall",
  "format": { "displays": 3, "arrangement": "row", "orientation": "landscape" },
  "pages": [
    {
      "id": "welcome",
      "canvas": { "width": 5760, "height": 1080, "background": "#000000FF" },
      "transition": { "type": "crossfade", "duration_ms": 500 },
      "advance": { "mode": "media_end" },
      "primitives": [
        {
          "id": "film",
          "primitive": "video",
          "selector": { "by": "id", "media_id": "med_01EXAMPLEWALL000000000" },
          "displays": [1, 2, 3],
          "layer": 0,
          "content_fit": "fill"
        },
        {
          "id": "menu",
          "primitive": "card",
          "card": "crd_01EXAMPLEMENU000000000",
          "layout": "center",
          "displays": [2],
          "content_fit": "fill"
        }
      ]
    }
  ]
}

Streifen

Ein Streifen ist eine Playlist, die entlang einer Kante eines Displays über die Seite gelegt wird, etwa ein Ticker am unteren Rand oder ein Logo am oberen Rand. Die Seite spielt darunter weiter; der Streifen verdeckt den Teil, den er bedeckt. Ein Streifen ist für eine Region gemacht: header (obere Kante), footer (untere Kante) oder side (rechte Kante, volle Höhe).

Eine Streifen-Playlist ist eine Regions-Playlist: Sie trägt format: {"region": "footer", "orientation": "landscape"}, wobei orientation die Ausrichtung des Displays ist, für das sie gemacht ist, wie der Betrachter sie sieht. Sie hat eine Streifen-Leinwand, geformt wie ihre Kante: Die lange Seite verläuft entlang der Kante und ist mindestens doppelt so lang wie die kurze, etwa 1920 × 240 für eine Fußzeile oder Kopfzeile im Querformat und 240 × 1080 für eine Seitenleiste im Querformat. Ein Streifen enthält nur Bild- und Karten-Elemente, kein Video, keinen Stream, kein iframe, keine Anwendung und keinen Anzeigenplatz, und hat keinen Soundtrack. Ein Streifen ist nie eine Standard-Playlist oder eine Übernahme.

screenrig playlist create ticker.json --format-region footer --format-orientation landscape
screenrig campaign create --name Ticker --playlist-id pl_TICKER --tag lobby --covers footer

Eine Kampagne oder ein Zeitplaneintrag zeigt einen Streifen über covers: footer, header oder side spielt einen Streifen dieser Region, und full (Standard) oder main spielt eine gewöhnliche Playlist als Seite. Eine Ebene, die eine Region abdeckt, braucht eine Playlist, die für diese Region gemacht ist.

Der Streifen behält das Seitenverhältnis seiner Leinwand und erstreckt sich nach der Drehung entlang der Kante jedes Displays seiner Ausrichtung und bedeckt höchstens die Hälfte des Displays. Ein Display mit der anderen Ausrichtung zeigt nur die Seite, ebenso ein Display, das der Streifen zu mehr als der Hälfte bedecken würde (seine Höhe bei Kopf- oder Fußzeile, seine Breite bei einer Seitenleiste). Der Meldungsbalken eines Overlay-Triggers wird über einem Streifen gezeichnet. Eine Kampagne oder ein Eintrag, der auf keinen der Bildschirme passt, die er anspricht, wird abgelehnt (playlist_format_mismatch); auf einem Bildschirm einer gemischten Zielgruppe, auf den er nicht passt, meldet campaign explain region_not_laid_out, und der Bildschirm zeigt die Seite. Eine Playlist in eine Region hinein, aus ihr heraus oder in eine andere Region zu ändern, wird abgelehnt, solange ein Bildschirm, Ordner oder eine Kampagne sie verwendet.

Installieren Sie die Player-Web-App

1. 01

   Öffnen Sie play.screenrig.ai/player/ auf dem Bildschirmgerät.

2. 02

   Auf iOS Safari verwenden: Teilen → Zum Home-Bildschirm. Auf Android Chrome verwenden: App installieren oder Zum Home-Bildschirm hinzufügen.

3. 03

   Öffnen Sie die installierte PWA und folgen Sie den angezeigten Einrichtungshinweisen.

4. 04

   Die PWA im Vordergrund auf dem Bildschirmgerät halten.

Starten Sie einen Kiosk-Browser mit erlaubtem Autoplay (Chrome --autoplay-policy=no-user-gesture-required, Autoplay Audio von Fully Kiosk), und die Player-Web-App spielt den Ton sofort ab; ein Browser, der Ton verweigert, spielt Video stumm ab, und das Player-Protokoll vermerkt das.

Ein Player koppelt sich mit der API seiner eigenen Umgebung: play.screenrig.ai mit api.screenrig.ai. Verwendet die CLI einen anderen API-Ursprung, --api-url https://api.DOMAIN, öffnen Sie stattdessen https://play.DOMAIN/player/.

Ihr Agent benötigt das offizielle Plugin, um Inhalte an den Player zu veröffentlichen.

Anwendungen im lokalen Netzwerk

Eine Anwendung kann http://- und ws://-Adressen im eigenen Netzwerk des Bildschirms aufrufen, etwa einen Controller unter http://192.168.1.20. Auf einem Kiosk-Browser erlaubt der Eigentümer des Browsers das. In Chrome und Edge 142 und höher setzen Sie die Unternehmensrichtlinie LocalNetworkAccessAllowedForUrls auf https://play.screenrig.ai: Der Player gibt diese Berechtigung an die Anwendungen weiter, die er einrahmt, und private IP-Adressen und .local-Namen werden dann über http und ws geladen, einschließlich fetch und Bildern. Für andere http://-Hostnamen setzen Sie zusätzlich InsecureContentAllowedForUrls auf https://play.screenrig.ai oder wählen Sie in den Website-Einstellungen Unsichere Inhalte: Zulassen. Beide Richtlinien nennen die Player-Seite, nicht die Adresse der Anwendung. Geräte im Netzwerk des Bildschirms erreichen behandelt Bilder und CORS.

ChromeOS-Kiosk

Verwaltete ChromeOS-Geräte, wie Chromebox, Chromebase oder ChromeOS Flex-PC, führen die Player-Web-App als Kiosk-App über die Google Admin-Konsole aus. Das Gerät startet direkt in den Player, hält ihn im Vollbildmodus und startet ihn neu, falls er geschlossen wird.

1. 01

   Öffnen Sie in der Google Admin-Konsole Geräte → Chrome → Apps & Erweiterungen → Kioske und wählen Sie die Organisationseinheit für Ihre Bildschirme aus.

2. 02

   Fügen Sie die App per URL hinzu: den Flottenlink Ihres Projekts oder https://play.screenrig.ai/player/ mit dem abschließenden Schrägstrich, um jedes Gerät mit seinem Code zu koppeln.

3. 03

   Stellen Sie es auf Auto-Start und aktivieren Sie App darf Energieverwaltung übernehmen.

4. 04

   Stellen Sie in den Kiosk-Stromversorgungseinstellungen des Geräts die Leerlaufaktion auf Nichts tun, damit der Bildschirm niemals dimmt oder in den Ruhezustand wechselt.

5. 05

   Gerät neu starten. Mit einem Flottenlink tritt der Player als neuer Bildschirm Ihrem Projekt bei. Ohne zeigt er seinen Kopplungscode an: Geben Sie den Code Ihrem Agenten.

Im Kiosk-Modus liest der Player die Seriennummer des Geräts sowie die Asset-ID und den Standort, die Sie im Admin-Console-Gerät annotiert haben. Diese erscheinen in den Host-Details des Bildschirms im Dashboard und in screen show. Wenn ein Powerwash oder eine Neuinstallation dem Gerät eine neue Player-Identität gibt, ermöglicht die Seriennummer Ihrem Agenten, es mit screen recover wieder mit seinem bestehenden Bildschirm zu verbinden, anstatt einen neuen zu koppeln.

Für den Soundtrack erlauben Sie Autoplay für https://play.screenrig.ai mit der AutoplayAllowlist-Richtlinie.

Eine URL für die gesamte Flotte

Ein Flottenlink ist eine Player-URL, die jedes Gerät, das sie öffnet, in seinen eigenen Bildschirm in Ihrem Projekt verwandelt, ohne Kopplungscode. Fragen Sie Ihren Agenten danach (screenrig fleet-links create), oder erstellen Sie ihn im Dashboard unter Einstellungen → Flottenlinks und geben Sie die URL in der Kiosk-App in Schritt 2 ein. Jedes neue Gerät tritt mit den Tags und der Playlist des Links bei und erhält seinen Namen aus der Asset-ID, dann dem Ort, den Sie in der Admin-Konsole annotieren.

Ein Gerät, das bereits ein Bildschirm ist, bleibt dieser Bildschirm durch Neustarts und Updates. Nach einem Powerwash oder einer Neuinstallation kehrt es als derselbe Bildschirm zurück, sobald seine alte Player-Identität zehn Minuten lang still war. Begrenzen Sie einen Link mit einer maximalen Bildschirmanzahl, schalten Sie ihn aus, um neue Bildschirme am Beitritt zu hindern, oder rotieren Sie ihn, um eine zu weit verbreitete URL zu ersetzen. Bildschirme, die ein Link bereits erstellt hat, spielen durch alle drei weiter. Behalten Sie die URL in der Admin-Konsole: Sie erstellt Bildschirme in Ihrem Projekt.

Anzeigeleistung über RS-232

Verbinden Sie den RS-232-Steueranschluss des Displays mit dem ChromeOS-Gerät über einen USB-Seriell-Adapter und gewähren Sie den Adapter mit der https://play.screenrig.ai-Richtlinie (USB-Hersteller- und Produkt-IDs des Adapters) oder SerialAllowAllPortsForUrls an SerialAllowUsbDevicesForUrls. Beim Start findet der Player ein Samsung (MDC), LG, NEC oder Philips (SICP) Display am freigegebenen Anschluss mit den werkseitigen Standardeinstellungen 9600 Baud und Display-ID. Er schaltet dann die eigene Stromversorgung, den Standby-Modus und das Wiedereinschalten des Displays und meldet den vom Display zurückgelesenen Stromstatus. Die Host-Fähigkeiten des Bildschirms listen Display-Stromversorgung (RS-232).

Flottenlinks in einer Geräteverwaltung

Die URL eines Flottenlinks (Dashboard Einstellungen → Flottenlinks oder screenrig fleet-links create) kommt auch in Ihre Geräteverwaltung:

• Android, Google TV und Amazon Signage Stick. Legen Sie in Ihrem EMM oder Ihrer Geräteverwaltung den Schlüssel fleet_link in der verwalteten Konfiguration der App fest (Paket ai.screenrig.player).
• Apple (Mac, Apple TV, iPhone und iPad). Legen Sie in Ihrem MDM den Schlüssel fleet_link in der verwalteten App-Konfiguration fest.
• Linux und Raspberry Pi. Tragen Sie die URL in die Datei /etc/screenrig/fleet-link ein oder fügen Sie dem Installationsprogramm --fleet-link URL hinzu (sh -s -- --kiosk --fleet-link URL).

Unter Android und Apple benennen die optionalen Schlüssel asset_id und location den neuen Bildschirm (zuerst die Asset-ID), und serial lässt ein neu installiertes Gerät seinen Bildschirm zurückerhalten.

Ein Gerät ohne Bildschirm tritt dem Projekt des Links von selbst bei. Ein Gerät, dessen Link nicht mehr funktioniert (neu erzeugt, ausgeschaltet, voll oder abgelaufen), zeigt seinen Kopplungscode mit einer Zeile an, die den Grund nennt. Behalten Sie die URL in der Geräteverwaltung: Sie erstellt Bildschirme in Ihrem Projekt.

Ein Flottenlink kann zu einem Zeitpunkt Ihrer Wahl enden: Übergeben Sie --expires-at (zum Beispiel 2027-12-31T23:59:59Z) an screenrig fleet-links create oder update oder füllen Sie im Dashboard das Feld Läuft ab aus. Danach zeigen neue Geräte ihren Kopplungscode an, und die Bildschirme, die der Link erstellt hat, spielen weiter.

Android-Geräteeigentümer per QR-Code

Ein auf Werkseinstellungen zurückgesetztes Android-Gerät ab Android 10 mit Kamera tritt einem Flottenlink ohne Geräteverwaltung bei. Öffnen Sie den Link im Dashboard (Einstellungen → Flottenlinks), wählen Sie unter Android-Geräteeigentümer die Option QR-Code anzeigen, tippen Sie sechsmal auf den Willkommensbildschirm des Geräts und scannen Sie den Code. Das Gerät lädt den verwalteten Player herunter, prüft ihn anhand des Signaturzertifikats im Code, installiert ihn als Geräteeigentümer und tritt dem Projekt des Links ohne Kopplungscode bei. Der Player läuft danach als Startbildschirm-App des Geräts im Vollbild, ohne Navigationsleiste, Benachrichtigungen oder Sperrbildschirm.

Der Code enthält eine Bereitstellungs-Payload, und Bereitstellungs-JSON kopieren kopiert sie für eine Geräteverwaltung, die aus JSON bereitstellt. Ihr Agent gibt dieselbe Payload mit screenrig fleet-links show ID --android-provisioning aus (erfordert eine Manage-Anmeldung, da die Payload das Geheimnis des Links enthält), bereit zur Kodierung als QR-Code. Die Payload lautet:

{
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME": "PACKAGE/ai.screenrig.player.managed.ScreenRigDeviceAdminReceiver",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION": "DOWNLOAD_URL",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM": "CHECKSUM",
  "android.app.extra.PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED": true,
  "android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE": { "fleet_link": "FLEET_LINK_SECRET" }
}

PACKAGE, DOWNLOAD_URL und CHECKSUM stammen aus dem Eintrag managed in https://screenrig.ai/android/manifest.json: package, https://screenrig.ai gefolgt von path und signer_sha256 als URL-sicheres Base64 ohne Auffüllzeichen. FLEET_LINK_SECRET ist der Teil der URL des Links nach #fleet=. Die Datei ist versioniert und bleibt erhalten, und die Prüfsumme gehört zum Signaturzertifikat, sodass ein gedruckter Code weiter funktioniert, wenn ein neuerer Player aufgeführt wird. Der Code enthält das Geheimnis des Links: Geben Sie ihn nur an die Person weiter, die das Gerät einrichtet.

Browserquellen (vMix, OBS)

Eine Browserquelle behält keinen Speicher, daher würde der Player darin seine Kopplung bei jedem Laden verlieren. Ein Bildschirmlink ist die Adresse genau eines Bildschirms: Der daraus geöffnete Player ist bei jedem Laden dieser Bildschirm, ohne dass etwas gespeichert wird. Verwenden Sie ihn für eine vMix- oder OBS-Browserquelle oder für jeden Browser, der seine Daten löscht.

1. 01

   Koppeln Sie den Bildschirm einmal. Öffnen Sie die Player-Web-App in einem beliebigen Browser, geben Sie Ihrem Agenten den angezeigten Code und warten Sie, bis der Bildschirm aktiv ist.

2. 02

   Fragen Sie Ihren Agenten nach dem Link des Bildschirms (screenrig screen link create SCREEN_ID), oder öffnen Sie den Bildschirm im Dashboard und wählen Sie Link erstellen in der Zeile Bildschirmlink der Registerkarte Eigenschaften.

3. 03

   Kopieren Sie den Link: Ihr Agent gibt ihn mit screenrig screen link show SCREEN_ID aus, oder wählen Sie im Dashboard Link kopieren. Er besteht aus https://play.screenrig.ai/player/#screen= gefolgt von einem Geheimnis.

4. 04

   Fügen Sie ihn als URL der Browserquelle ein.

5. 05

   Die Quelle spielt die Playlist des Bildschirms sofort ab und nach jedem Neuladen erneut.

Öffnen Sie einen Bildschirmlink an einer einzigen Stelle. An zwei Stellen geöffnet, ist es derselbe Bildschirm doppelt. Mehrere Browserquellen in einem Browser, jede mit eigenem Link, laufen als getrennte Bildschirme.

Ein Bildschirmlink ist eine Anmeldeinformation: Wer ihn hat, öffnet diesen Bildschirm. Wenn er durchsickert oder Sie ihn zurückholen wollen, fordern Sie den Link erneut an (screenrig screen link create SCREEN_ID oder Link ersetzen): Die alte Adresse funktioniert sofort nicht mehr, und eine Quelle, die sie noch zeigt, zeigt einen Hinweis und keinen Inhalt, ohne Kopplungscode. Fügen Sie die neue Adresse ein, und die Quelle spielt wieder ab. Link deaktivieren (screenrig screen link delete SCREEN_ID) beendet den Link, ohne einen neuen zu erstellen. Der eigene Player des Bildschirms, falls vorhanden, ist in keinem Fall betroffen.

Werbung auf Ihren Bildschirmen

Der Player, den Sie bereits verwenden, ist auch der Werbe-Player: Es ist nichts zusätzlich zu installieren.

Verkaufen ist eine Entscheidung, die Sie pro Bildschirm treffen, über dasselbe offizielle Plugin und CLI. Nehmen Sie einen eigenen Bildschirm mit screenrig ads inventory update scr_LOBBY --enabled in die Werbung auf und beschreiben Sie ihn öffentlich mit dem Standortnamen, der Stadt, Region, Veranstaltungsart und den von Ihnen gewählten Zielgruppen-Tags. Definieren Sie wiederverwendbare Werbeplätze mit screenrig ads slots create — akzeptierte Medien (Bild oder Video), die längsten Bild- und Videodauern sowie eine optionale Ratenüberschreibung für diesen Slot. Eine Slot-Definition allein ändert nichts am Bildschirm; das Einfügen der Adslot-Seite in eine Ihrer Playlists gibt diesem Bildschirm eine tatsächliche Werbepause, und alle anderen Seiten spielen normal weiter.

Bezahlte Anzeigen erfordern einen Player, der die Wiedergabe von Werbeplätzen unterstützt. Der Server liefert einem Player ohne diese Unterstützung nur die gewöhnliche Playlist, sodass dieser Bildschirm Hausinhalt und keine bezahlte Werbung abspielt; ein fähiger Player fordert für jede Werbeplatzseite eine Füllung an und überspringt jeden Slot, den er nicht füllen kann, und hält die Playlist in Bewegung. Käufer koppeln nichts – sie kaufen aus Ihrem Inventar über die Einladung, die Sie mit screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY senden.

Das Plugin, Projekt und die ersten Bildschirm-Schritte sind im Startguide beschrieben.

Kommerzielle Displays

Samsung Smart Signage (Tizen) verwendet den nativen screenRIG Player.

BrightSign-Player mit OS 9.1 oder neuer starten den screenRIG Player automatisch von einer SD-Karte. Extrahieren Sie das Paket in das Kartenstammverzeichnis, legen Sie die Karte ein und schalten Sie ein. Der Player wendet seine Hardware-Richtlinie an und öffnet den screenRIG Player.

1. 01

   Stellen Sie zuerst die Uhr und das Netzwerk des Players ein. Eine falsche Uhr verhindert die sichere Verbindung.

2. 02

   Extrahieren Sie es in das Stammverzeichnis einer FAT32-SD-Karte und legen Sie die Karte ein.

3. 03

   Stromversorgung am Player. Startet das Paket und zeigt den Kopplungscode an.

4. 04

   Geben Sie den Code an Ihren Agenten.

LG webOS Signage

LG webOS Signage Displays ab Version 6.0 (Chromium 79 oder neuer) führen den screenRIG Player aus. Eine installierte App startet beim Einschalten und öffnet ihn. Displays mit webOS Signage 4.x oder älter nutzen einen älteren Browser, als der Player benötigt. Laden Sie die Pakete von screenrig.ai/webos/ herunter.

Ein Display im Application Launch Mode „Local“ installiert com.lg.app.signage.ipk von einem USB-Stick.

1. 01

   Stellen Sie zuerst Datum, Uhrzeit und Netzwerk des Displays ein. Eine falsche Uhr bricht die Installation mit „Unknown error“ ab und verhindert die sichere Verbindung.

2. 02

   Legen Sie auf einem FAT32-USB-Stick im Stammverzeichnis einen Ordner namens application an und legen Sie com.lg.app.signage.ipk darin ab. Behalten Sie den Dateinamen bei.

3. 03

   Stecken Sie den Stick in das Display. Stellen Sie unter Server Settings Application Launch Mode auf Local und den Typ auf IPK und starten Sie dann Local Application Upgrade von USB.

4. 04

   Starten Sie das Display neu. Es startet die App und zeigt den Kopplungscode an.

5. 05

   Geben Sie den Code an Ihren Agenten.

Um über das App-Menü des Displays oder von einem SI-Server zu installieren, verwenden Sie stattdessen ScreenRig-webos.ipk. Die beiden Pakete sind für das Display getrennte Apps mit jeweils eigener Kopplung. Installieren Sie daher nur eines pro Display.

Ein Display, das vor seinem Netzwerk startet, zeigt den screenRIG-Bildschirm und versucht es weiter, bis der Player antwortet. Drücken Sie auf der Fernbedienung Info, um das Modell des Displays, die Browserversion und den Verbindungsstatus zu sehen.

Andere kommerzielle Displays mit integriertem HTML5-Browser oder URL-Launcher können play.screenrig.ai/player/ direkt öffnen und den oben beschriebenen Schritten der Web-App folgen. Das Display muss die Seite im Vordergrund halten und das Speichern von Daten erlauben. Android TV und Streaming-Boxen mit vollem Webbrowser können dasselbe tun: Öffnen Sie play.screenrig.ai/player/ im Browser der Box, geben Sie Ihrem Agenten den Kopplungscode und halten Sie die Seite im Vordergrund.

Streams und Ersatzbilder

Verwenden Sie stream für einen Live-Feed und video für eine hochgeladene Datei. Ein Stream benötigt ein bereit hochgeladenes Bild vom selben Konto als Ersatzbild. Das Bild erscheint beim Verbinden, wenn die Wiedergabe stockt oder wenn der Player die Quelle nicht empfangen kann.

Feed vorbereiten

Verwenden Sie eine öffentliche HTTPS-HLS-Playlist ohne eingebettete Anmeldeinformationen oder die RTSP-URL einer Kamera. Für den Web Player müssen Playlist, Segmente und Schlüssel Cross-Origin-Anfragen vom Player-Ursprung zulassen. H.264-Video mit AAC-Audio ist ein praktisches Ausgangsprofil; die Dekodierung hängt vom Gerät ab. Audio ist standardmäßig stummgeschaltet, und Browser-Autoplay-Regeln gelten weiterhin.

Wählen Sie Zeit und Transport

Verwenden Sie höchstens einen Stream pro Seite und dauerbasierten Fortschritt. Stellen Sie eine oder zwei Quellen mit unterschiedlichen Protokollen in der Präferenzreihenfolge bereit. Eine Quelle kann nur ihre url angeben: Eine https-URL ist HLS, eine rtsp- oder rtsps-URL ist RTSP. Für Multicast verwenden Sie eine administrativ begrenzte IPv4-Gruppe in 239/8 und einen UDP-Port; fügen Sie eine HLS-Alternative für andere Player hinzu. screenRIG wandelt Multicast nicht in HLS um. Streams werden nicht für die Offline-Wiedergabe zwischengespeichert; das Ersatzbild wird es.

Eine Kamera direkt abspielen

Android-, Amazon- und Linux-Player öffnen rtsp://-Kameraquellen selbst über das eigene Netzwerk des Players, ohne Relay. Verwenden Sie die URL der Kamera oder des Rekorders einschließlich der user:pass@-Anmeldedaten. Linux öffnet auch rtsps://-Quellen.

Aktivieren Sie bei einer UniFi Protect-Kamera RTSP für einen Kanal in den Protect-Einstellungen der Kamera und kopieren Sie dessen URL. Android und Amazon wandeln die rtsps://-URL von Protect auf Port 7441 in unverschlüsseltes rtsp:// auf Port 7447 um und entfernen dabei enableSrtp. Der Player muss Port 7447 der Protect-Konsole erreichen können; diese Verbindung verwendet weder TLS noch SRTP. Verwenden Sie für andere verschlüsselte RTSPS-Quellen auf Android und Amazon eine HLS-Alternative oder das Ersatzbild. Andere Player spielen die HLS-Alternative ab oder zeigen das Ersatzbild.

Multicast-Empfang aktivieren

Auf Android öffnen Sie das Operator-Menü, wählen Einstellungen und aktivieren Multicast-Streams; standardmäßig ist es deaktiviert. Auf Qt aktivieren Sie SCREENRIG_ENABLE_MULTICAST=1 in der Player-Startumgebung und prüfen --capabilities-json. Das Netzwerk muss die ausgewählte Multicast-Gruppe und den Port übertragen. Diese Version bietet kein DRM, RTP, benutzerdefinierte Authentifizierungsheader oder Stream-Transcodierung.

Soundtracks

Ein Playlist-Soundtrack spielt auf jedem Player. Der Player lädt und prüft jeden MP3-Track mit dem Rest der Playlist und spielt die Tracks in der Reihenfolge, während sich die Seiten ändern. Seitenübergänge stoppen oder starten die Musik nie neu, und der Soundtrack spielt offline weiter von den zwischengespeicherten Tracks. Ein markierter Soundtrack (cued: true) spielt einen Track nur, wenn eine Seitenmarkierung ihn startet, und ist nach Ende dieses Tracks bis zur nächsten Markierung still. Eine Seite, deren advance audio_end ist, endet, wenn ihr markierter Track endet; wenn der Player den Track nicht abspielen kann, dauert die Seite so lange wie der Track.

Wenn der Agent die Playlist erneut veröffentlicht, wird der aktuelle Titel weiter abgespielt, sofern er noch im neuen Soundtrack enthalten ist. Die Lautstärke des Soundtracks wird mit der Lautstärke des Players multipliziert, sodass die Lautstärkeeinstellung des Bedieners oder die eigene Lautstärkeregelung des Displays weiterhin bestimmt, wie laut der Bildschirm ist.

Browser können Ton blockieren, bis jemand die Seite berührt. Die Player-Web-App zeigt weiterhin Seiten an und startet den Soundtrack beim ersten Tippen oder Tastendruck. Für einen unbeaufsichtigten Kiosk-Browser erlauben Sie Autoplay mit Ton; in Chromium starten Sie mit --autoplay-policy=no-user-gesture-required; auf einem ChromeOS-Kiosk setzen Sie die AutoplayAllowlist-Richtlinie. Native Player benötigen keine Einstellung.

Gerätezustand und Displaysteuerung

Jeder Player meldet alle fünfzehn Minuten den Gerätezustand und sofort, wenn sich seine Anzeigeverbindung oder Stromversorgung ändert. Er gibt an, welche Gerätefunktionen er unterstützt: Fernneustart und die Anzeigesteuerungsmethoden, die er verwenden kann. Was ein Player lesen und schalten kann, hängt von der Plattform und der Geräteeinrichtung ab.

Die tatsächlichen Fähigkeiten jedes Bildschirms erscheinen in screen show als seine Host-Fähigkeiten, neben seinem neuesten Gesundheitsbericht, sodass der Agent vor dem Handeln weiß, ob dieser Bildschirm neu starten oder sein Display wechseln kann. Die Tabelle zeigt, was jeder Player kann.

Remote-Aktionen

Drei weitere Gerätesteuerungen erreichen einen Player als Befehle: seine Caches leeren, seine Anwendung neu starten (nicht das Gerät) und ihn auf die neueste Version aktualisieren. Ein Player meldet clear_cache, restart_app oder update nur dann in seinen Host-Fähigkeiten, wenn das Verhalten auf diesem Gerät funktioniert, sodass screen show den Agenten informiert, bevor er handelt; ein Bildschirm, dessen Player die Fähigkeit nicht meldet, antwortet mit command_unsupported, und nichts wird gesendet. Das Leeren des Caches behält Kopplung und Einstellungen und füllt die Inhalte aus dem Manifest neu auf. Jeder Befehl wird unter commands in screen show, done oder failed mit der vom Player gemeldeten Ursache aufgeführt.

Abdunkeln im Leerlauf, automatische Helligkeit und Kiosk-Sperre

Drei Einstellungen eines Bildschirms steuern das Display auf dem Gerät selbst. Ein Player wendet eine an, wenn screen show seine Host-Fähigkeit aufführt (display_power.idle, brightness.auto oder kiosk_lock); die Einstellung wird in jedem Fall gespeichert.

• Abdunkeln im Leerlauf. Nach 30 bis 86400 Sekunden ohne Berührung oder Tastendruck oder, wenn presence ein Aufweckereignis ist, ohne dass jemand vor dem Bildschirm steht, wird der Bildschirm dunkel und die Wiedergabe pausiert. Je nach Ihrer Wahl schaltet ihn eine Berührung oder presence wieder ein; die Berührung, die einen dunklen Bildschirm aufweckt, wird nicht weitergegeben. Bei presence wird die Kamera des Geräts auf dem Gerät gelesen, und kein Bild verlässt es. Ein Anzeigeplan oder eine Überschreibung, die das Display ausgeschaltet hält, hat Vorrang.
• Automatische Helligkeit. auto stellt die Helligkeit über den Lichtsensor des Geräts ein; fixed, die Standardeinstellung, behält die Helligkeit des Betreibers bei. Ein Gerät deklariert brightness.auto nur, wenn es einen Lichtsensor hat.
• Kiosk-Sperre. Der Android Player fixiert sich per Bildschirmfixierung selbst auf dem Bildschirm, ein Geräteeigentümer ist dafür nicht nötig. Die Person am Bildschirm bestätigt es beim ersten Mal, und Statusleiste, Home und Übersicht sind blockiert, solange die Fixierung besteht.

Ihr Agent setzt sie mit screen display-idle, screen brightness und screen kiosk-lock. Die Registerkarte Eigenschaften der Bildschirmseite im Dashboard hat dieselben drei unter Geräteeinstellungen.

Live-Ansicht

Die Live-Ansicht zeigt im Dashboard als Video, was ein Bildschirm abspielt, und screenrig screen live frame speichert JPEG-Einzelbilder davon für einen Agenten, der nur HTTPS hat. Der Android-Player (Google Play und Amazon Signage Stick), Linux und Raspberry Pi stellen sie bereit, und ein Bildschirm, der das kann, führt die Host-Fähigkeit live_view in screen show auf. Auf Android erlaubt jemand am Bildschirm die Bildschirmaufnahme einmal bei jedem Start des Players. Eine Live-Sitzung endet von selbst, wenn ihre Laufzeit abläuft; starten Sie sie erneut, um weiter zuzusehen.

Einen Bildschirm am Gerät steuern

Sobald der Bildschirm gekoppelt ist, drücken Sie OK auf der Fernbedienung, um das Operator-Menü zu öffnen. Die erste Seite des Menüs enthält:

• Bildschirmname. Wählen Sie ihn aus, um den Bildschirm umzubenennen.
• Playlist. Ihr Hinweis ist die Playlist, die der Bildschirm abspielt. Wählen Sie sie aus oder drücken Sie Rechts, um alle Playlists im Projekt alphabetisch aufzulisten und eine auszuwählen, um den Bildschirm darauf umzuschalten. Eine Übernahme, Kampagne oder Playlist-Planung entscheidet weiterhin, was abgespielt wird; der Hinweis nennt immer, was gerade läuft.
• Seite. Ihr Hinweis ist der Name der aktuell angezeigten Seite; der Name einer Seite ist ihre Kennung. Das Menü öffnet sich in dieser Zeile. Drücken Sie Links oder Rechts, um zur vorherigen oder nächsten Seite zu wechseln, oder wählen Sie sie aus, um die Seiten der Playlist in Wiedergabereihenfolge aufzulisten und eine Seite zum Springen auszuwählen. Die gewählte Seite startet von ihrem Anfang.
• Einstellungen. Helligkeit, Lautstärke und Zurücksetzen sowie unter Android Multicast-Empfang und Start beim Booten.
• Einstellungen verlassen schließt das Menü von jedem Bildschirm aus.

Zurück oder Links in einer Liste kehrt zum vorherigen Bildschirm zurück. Das Menü schließt sich nach 60 Sekunden ohne Eingabe automatisch.

Pausieren und fortsetzen

Drücken Sie Play/Pause auf der Fernbedienung (K unter Windows), um den Bildschirm zu pausieren; der Paused-Chip wird angezeigt. Ein pausierter Bildschirm hält seinen Seitentimer, das Video der Seite und die Tonspur an. Drücken Sie die Taste erneut, und alles wird an der Stelle fortgesetzt, an der es gestoppt wurde: Eine Seite, die 20 Sekunden angezeigt werden soll und bei 10 Sekunden pausiert wurde, wird die verbleibenden 10 Sekunden angezeigt, und die Musik setzt an derselben Stelle fort, anstatt von vorne zu beginnen. Das Wechseln zur nächsten oder vorherigen Seite oder das Auswählen einer Seite im Menü behält die Pause bei: Die neue Seite wartet am Anfang, bis Sie fortsetzen. Karten, Webseiten und Live-Streams laufen während der Pause weiter. Eine Pause endet nach 60 Minuten von selbst.

Prüfen Sie Ihren ersten Bildschirm

Geben Sie Ihrem Agenten den vorgesehenen Bildschirm und bitten Sie ihn, eine einfache Willkommensnachricht zu veröffentlichen. Fordern Sie einen Screenshot an, wenn der Player diese anzeigt.

Wenn der Bildschirm in der Agentenliste fehlt, bestätigen Sie, dass der Player geöffnet ist und die Einrichtung abgeschlossen ist. Wenn Inhalte nicht aktualisiert werden, prüfen Sie die Verbindung des Geräts und bitten Sie den Agenten, den Bildschirmstatus und Wiedergabe-Nachweise zu überprüfen.

Ein Chip auf dem Bildschirm oder ein Code in screen show wird unter Player-Statuscodes erklärt.

Sobald der Bildschirm gekoppelt ist, benennt sein Operator-Menü den Bildschirm und zeigt seine Playlist und Seite an.

Mit dem Agenten-Workflow fortfahren.