Mettre le lecteur sur votre écran

Quels Players sont disponibles ?

Lecteurs : l’application Web du lecteur (PWA), Android sur Google Play, Amazon Signage Stick, Apple TV, macOS, iPhone et iPad, Windows, les paquets pour Linux et Raspberry Pi, LG webOS Signage, BrightSign et Samsung Smart Signage (Tizen). Installer un lecteur natif pour une lecture la plus rapide et fiable.

L’application Web du lecteur (PWA) à play.screenrig.ai/player/ fonctionne sur tout écran avec un navigateur moderne : une télé intelligente ou un afficheur commercial avec navigateur intégré, un appareil ChromeOS géré en mode kiosque, une tablette ou un ordinateur branché à l’écran. Un embed en lecture seule du lecteur est à play.screenrig.ai/player/embed/status/.

Chaque Player affiche un code de jumelage. Donnez-le à votre agent, et il s’en occupe.

Chaque Player, sauf Windows, affiche aussi un code QR sur son écran de jumelage. Scannez-le avec un téléphone connecté au tableau de bord et confirmez avec Jumeler l’écran.

Synchronisation éventuelle

Les Players Android, Amazon Signage Stick, macOS, Windows, Linux et Raspberry Pi alignent progressivement les changements de page avec les Players proches affichant la même révision de liste de lecture. Assignez la même liste de lecture aux écrans sur un même sous-réseau IPv4. Utilisez des durées de page fixes d’au moins une seconde, supprimez les transitions et les animations d’entrée. Chaque Player diffuse une petite balise de début de page et ajuste légèrement son attente avant la page suivante. Les ajustements de synchronisation s’activent seulement après la découverte d’un second Player sur cette même révision de liste de lecture. Les écrans sur différentes listes de lecture ne s’influencent pas. Un écran seul garde son timing de lecture normal ; le groupe suit la position médiane de lecture une fois que des pairs rejoignent.

Le réseau doit autoriser la diffusion UDP de périphérique à périphérique sur le port 49817. Autorisez l’accès au réseau local lorsque l’appareil le demande. Les écrans continuent de jouer malgré la perte de paquets, les cycles d’alimentation et les partitions réseau, et convergent à nouveau à l’arrivée des balises de page. Chaque attente ajoutée est plafonnée à 40 millisecondes. Les pages longues et les grandes différences de synchronisation prennent plus de temps à converger ; cela synchronise les changements de page plutôt que les images vidéo ou les pistes sonores.

Pour rapprocher rapidement un emplacement, demandez à votre agent de redémarrer la lecture sur ses écrans avec screen reload --tag LOCATION, en remplaçant LOCATION par leur balise partagée. Les lecteurs redémarrent les listes de lecture éligibles à la première page et terminent l’alignement via leurs balises régulières. Le jumelage et les contenus téléchargés restent en place.

Installer un lecteur natif

Chaque téléchargement se trouve aussi sur la page Téléchargements.

1. 01

   Installez le lecteur pour votre appareil écran.

2. 02

   Lancer. S’ouvre en plein écran et affiche un code de jumelage.

3. 03

   Donnez le code de jumelage à votre agent. Il jumelle l’écran et y publie du contenu.

Chaque lecteur natif télécharge les médias une seule fois, les met en cache et les relit à partir du stockage local.

Installez le APK Android

Utilisez l’APK sur les téléviseurs Android, appareils Google TV, tablettes et boîtiers d’affichage sous Android 9 ou plus récent qui n’utilisent pas Google Play. Utilisez-le lors de l’installation par ADB.

L’APK est signé et public. C’est le même lecteur que la version Google Play. Son nom de fichier porte la version, utilisez donc https://screenrig.ai/android/manifest.json comme seul pointeur vers le fichier actuel.

Avant de commencer, activez les options développeur et le débogage USB ou réseau sur l’appareil. Vous avez aussi besoin de adb sur votre ordinateur.

1. Connectez-vous à l’appareil. Pour un appareil réseau, exécutez adb connect DEVICE_IP:5555.

2. Téléchargez, vérifiez et installez le fichier APK :

   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. Le lecteur s’ouvre en plein écran et affiche un code de jumelage. Donnez le code à votre agent.

Démarrer au démarrage

Démarrer au démarrage est activé par défaut. C’est un interrupteur dans les paramètres de l’opérateur du Player : une fois l’écran jumelé, appuyez sur OK sur la télécommande pour ouvrir le menu et choisissez Paramètres. Sur Android 9, aucune permission n’est requise. Sur Android 10 et versions ultérieures, accordez Afficher par-dessus les autres applications sauf si l’appareil est géré en tant que propriétaire de l’appareil : sélectionnez Démarrer au démarrage et suivez l’invite. Quand un écran de permission est disponible, le Player demande cette permission au premier affichage du code de jumelage : sélectionnez Ouvrir les paramètres et autorisez Afficher par-dessus les autres applications. Tant que la permission n’est pas accordée, la ligne affiche Permission requise et le Player ne démarre pas au démarrage. Vous pouvez aussi l’accorder avec ADB :

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

Sur Fire OS 8, utilisez ADB pour accorder cette permission ; l’écran des paramètres ne la propose pas.

Économiseur d’écran

Sur Android TV et Google TV, screenRIG est l’un des économiseurs d’écran de la TV. Ouvrez Économiseur d’écran dans les Paramètres de la TV et sélectionnez screenRIG. Quand la TV démarre son économiseur d’écran, le Player vient au premier plan et joue votre contenu. Aucune permission n’est requise.

Mise à jour

Refaites les étapes d’installation. Android installe la version supérieure par-dessus celle installée et conserve votre jumelage. Seule une version supérieure remplace celle installée.

Google Play

L’APK et la version Google Play partagent le même package ai.screenrig.player. Si la version Google Play est installée, désinstallez-la d’abord. Jumeler de nouveau le lecteur après avoir installé l’APK.

Linux et Raspberry Pi

Le lecteur Linux est un paquet autonome pour Linux 64 bits, conçu pour les PC x86_64 et les cartes aarch64 comme le Raspberry Pi. Qt, Qt WebEngine et GStreamer sont inclus. La machine nécessite la version de glibc indiquée pour son architecture sur screenrig.ai/linux/, une session Wayland ou le compositeur kiosque cage, ainsi que ses propres pilotes GPU, polices, certificats CA et service audio.

Installez-le avec l’installateur, qui choisit la version adaptée à la machine et la vérifie avec SHA256SUMS :

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

Sur un écran dédié, ajoutez --kiosk (sh -s -- --kiosk) pour démarrer le Player au démarrage dans cage sous un service systemd. Exécutez à nouveau l’installateur pour mettre à jour, ou avec --uninstall pour le supprimer. Installation manuelle : téléchargez screenrig-player-linux-x86_64.tar.gz ou screenrig-player-linux-aarch64.tar.gz et SHA256SUMS depuis screenrig.ai/linux/, vérifiez-les avec sha256sum --ignore-missing -c SHA256SUMS, extrayez-les dans /opt/screenrig-player et exécutez /opt/screenrig-player/screenrig-player.

Debian 13, Raspberry Pi OS (trixie, 64 bits), Ubuntu, Fedora et Arch Linux exécutent le Player lorsqu’ils respectent l’exigence de glibc du paquet. Debian 12 et Raspberry Pi OS bookworm livrent une glibc plus ancienne ; mettez-les à jour d’abord. Les paquets par distribution pour une installation kiosque sont dans les notes de téléchargement Linux.

Raspberry Pi

Utilisez Raspberry Pi OS (64 bits) basé sur trixie ; les images 32 bits et bookworm ne peuvent pas exécuter le lecteur. Le Raspberry Pi 5 décode le HEVC en matériel jusqu’en 4K à 60 i/s et n’a pas de décodeur H.264 : téléversez donc chaque vidéo qui lui est destinée avec screenrig media upload --codec hevc, quelle que soit sa taille. Le Raspberry Pi 4 lit le 1080p. Raspberry Pi OS Lite avec --kiosk démarre directement dans le lecteur.

Conservez la résolution choisie pour l’écran : une vidéo HEVC 4K se lit sur une sortie de 1920×1080. Pour mettre à jour un lecteur Pi, relancez l’installateur Linux avec le préfixe d’installation et le compte du lecteur existants; le jumelage et les réglages d’affichage sont conservés. Le rechargement d’un écran actualise le contenu et n’installe pas une nouvelle version du lecteur.

Murs vidéo

Un Player pilote de 2 à 12 afficheurs comme un seul mur : le Player Linux sur une installation --kiosk avec wlr-randr (sudo apt install wlr-randr), et le Player Windows. Un Raspberry Pi 5 pilote deux afficheurs ; un PC en pilote autant que ses sorties graphiques le permettent, et un mini PC Intel comme le Quieter 4C en pilote jusqu’à trois. Le Player Windows règle lui-même la disposition des afficheurs de Windows : il positionne et fait pivoter les afficheurs, et les met en miroir grâce au mode duplication de Windows pour une liste de lecture sans format. Windows conserve sa propre mise à l’échelle de l’affichage.

screen show liste les sorties de l’écran, par exemple HDMI-A-1 sous Linux ou DISPLAY1 sous Windows. Un mur est une row (de gauche à droite), une column (de haut en bas) ou une grid. Une grille prend --columns, le nombre d’afficheurs par rangée, et remplit au moins deux rangées : 12 afficheurs en 4 colonnes font 3 rangées. Les afficheurs sont numérotés de gauche à droite, puis de haut en bas, et --outputs nomme les sorties dans cet ordre. --rotation fait pivoter chaque afficheur de 0 (par défaut), 90, 180 ou 270 degrés ; 90 et 270 sont des panneaux en mode portrait.

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

Après un changement de mur, chaque afficheur affiche son numéro et le nom de sa sortie pendant 20 secondes, pour vérifier l’ordre.

Une liste de lecture conçue pour le mur porte un format (displays, arrangement, orientation et, pour une grille, columns) et une toile d’une page, en unités de conception 1080p par afficheur : une tuile fait 1920 × 1080 en paysage ou 1080 × 1920 en portrait, et la toile est la tuile multipliée par les colonnes et les rangées. Un panneau 4K ne nécessite rien de différent. Un écran joue une liste de lecture murale seulement lorsque son mur a la même forme.

Placez un élément avec displays : [1,2,3] couvre trois afficheurs en rangée, [2] est sur un afficheur et [1,2] couvre deux. Les afficheurs remplissent un rectangle du mur : sur une grille de 4 colonnes, [1,2,5,6] est le bloc en haut à gauche et [3,7,11] une colonne de trois. Ou donnez un rect libre sur la toile du mur. Une carte se place à l’intérieur de son displays, donc center sur [2] est au centre de l’afficheur 2 ; sans displays elle utilise tous les afficheurs. Sur un écran avec un mur, une liste de lecture ordinaire (sans format) joue en miroir sur chaque afficheur.

Rendre la vidéo murale au ratio d’aspect du mur dans une résolution 4K, par exemple 3840 × 720 pour trois afficheurs en paysage alignés, 3840 × 1080 pour deux et 3840 × 1620 pour une grille de 4 colonnes et 3 rangées, et la placer avec content_fit: fill. Gardez le texte et les visages hors des jonctions entre afficheurs.

{
  "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"
        }
      ]
    }
  ]
}

Bandeaux

Un bandeau est une liste de lecture tracée sur la page le long d’un bord d’un afficheur, par exemple un bandeau défilant en bas ou un logo en haut. La page continue de jouer en dessous; le bandeau masque la partie qu’il couvre. Un bandeau est conçu pour une région : header (le bord supérieur), footer (le bord inférieur) ou side (le bord droit, sur toute la hauteur).

Une liste de lecture de bandeau est une liste de lecture de région : elle porte format: {"region": "footer", "orientation": "landscape"}, où orientation est l’orientation de l’afficheur pour lequel elle est conçue, telle que la voit le spectateur. Elle a une seule toile de bandeau, de la forme de son bord : le grand côté longe le bord et fait au moins le double du petit, par exemple 1920 × 240 pour un pied de page ou un en-tête en paysage et 240 × 1080 pour un côté en paysage. Un bandeau ne contient que des éléments image et carte, sans vidéo, flux, iframe, application ni emplacement publicitaire, et n’a pas de bande sonore. Un bandeau n’est jamais une liste de lecture par défaut ni une prise de contrôle.

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

Une campagne ou une entrée de calendrier affiche un bandeau au moyen de covers : footer, header ou side joue un bandeau de cette région, et full (la valeur par défaut) ou main joue une liste de lecture ordinaire comme page. Un niveau qui couvre une région exige une liste de lecture conçue pour cette région.

Le bandeau conserve le rapport d’aspect de sa toile et longe le bord de chaque afficheur de son orientation, après rotation, et couvre au plus la moitié de l’afficheur. Un afficheur de l’autre orientation ne montre que la page, de même qu’un afficheur que le bandeau couvrirait à plus de la moitié (sa hauteur pour un en-tête ou un pied de page, sa largeur pour un côté). La barre d’alerte d’un déclencheur de superposition se dessine au-dessus d’un bandeau. Une campagne ou une entrée qui ne convient à aucun des écrans visés est refusée (playlist_format_mismatch); sur un écran d’un public mixte où elle ne convient pas, campaign explain signale region_not_laid_out et l’écran affiche la page. Faire passer une liste de lecture dans une région, hors d’une région ou vers une autre région est refusé tant qu’un écran, un dossier ou une campagne l’utilise.

Installez l’application Web du lecteur

1. 01

   Ouvrez play.screenrig.ai/player/ sur l’appareil écran.

2. 02

   Sur iOS, utilisez Safari : Partager → Ajouter à l’écran d’accueil. Sur Android, utilisez Chrome : Installer l’app ou Ajouter à l’écran d’accueil.

3. 03

   Ouvrez la PWA installée et suivez ses instructions d’installation affichées.

4. 04

   Maintenir la PWA au premier plan sur l’appareil écran.

Démarrez un navigateur de kiosque avec la lecture automatique autorisée (Chrome --autoplay-policy=no-user-gesture-required, Autoplay Audio de Fully Kiosk) et l’app web Player joue le son aussitôt ; un navigateur qui refuse le son lit la vidéo en sourdine, et le journal du Player l’indique.

Un Player se jumelle à l’API de son propre environnement : play.screenrig.ai avec api.screenrig.ai. Quand la CLI utilise une autre origine d’API, --api-url https://api.DOMAIN, ouvrez plutôt https://play.DOMAIN/player/.

Votre agent a besoin du plugin officiel pour publier du contenu sur le lecteur.

Applications sur le réseau local

Une application peut appeler des adresses http:// et ws:// du propre réseau de l’écran, comme un contrôleur à l’adresse http://192.168.1.20. Sur un navigateur de kiosque, le propriétaire du navigateur l’autorise. Sur Chrome et Edge 142 et versions ultérieures, définissez la politique d’entreprise LocalNetworkAccessAllowedForUrls à https://play.screenrig.ai : le Player transmet cette permission aux applications qu’il encadre, et les adresses IP privées et les noms .local se chargent alors par http et ws, fetch et images compris. Pour les autres noms d’hôte http://, définissez aussi InsecureContentAllowedForUrls à https://play.screenrig.ai, ou choisissez Contenu non sécurisé : Autoriser dans les paramètres du site. Les deux politiques désignent la page du Player, et non l’adresse de l’application. Joindre les appareils du réseau de l’écran traite des images et de CORS.

Kiosque ChromeOS

Les appareils ChromeOS gérés, comme un Chromebox, un Chromebase ou un PC ChromeOS Flex, exécutent l’application Player Web en mode kiosque depuis la console d’administration Google. L’appareil démarre directement sur le Player, le maintient en plein écran et le relance s’il se ferme.

1. 01

   Dans la console d’administration Google, ouvrez Appareils → Chrome → Applications et extensions → Kiosques et sélectionnez l’unité organisationnelle de vos écrans.

2. 02

   Ajouter l’application par URL : le lien de flotte de votre projet, ou https://play.screenrig.ai/player/ avec la barre oblique finale pour jumeler chaque appareil par son code.

3. 03

   Définissez-le pour un lancement automatique, et activez Autoriser l’application à gérer l’alimentation.

4. 04

   Dans les paramètres d’alimentation du kiosque de l’appareil, définissez l’action d’inactivité sur Ne rien faire, afin que l’écran ne s’assombrisse ni ne se mette en veille.

5. 05

   Redémarrez l’appareil. Avec un lien de flotte, le lecteur rejoint votre projet comme un nouvel écran à lui seul. Sans lien, il affiche son code de jumelage : donnez ce code à votre agent.

Dans la session kiosque, le lecteur lit le numéro de série de l’appareil ainsi que l’ID d’actif et l’emplacement que vous avez annotés sur l’appareil dans la console d’administration. Ils apparaissent dans les détails de l’hôte de l’écran dans le tableau de bord et dans screen show. Lorsqu’un nettoyage complet ou une réinstallation donne à l’appareil une nouvelle identité de lecteur, le numéro de série permet à votre agent de le reconnecter à son écran existant avec screen recover au lieu de jumeler un nouveau.

Pour la bande sonore, autorisez la lecture automatique pour https://play.screenrig.ai avec la politique AutoplayAllowlist.

Une URL pour toute la flotte

Un lien de flotte est une URL Player qui transforme chaque appareil l’ouvrant en son propre écran dans votre projet, sans code de jumelage. Demandez-en un à votre agent (screenrig fleet-links create), ou créez-le dans le tableau de bord sous Paramètres → Liens de flotte, puis mettez son URL dans l’application kiosque à l’étape 2. Chaque nouvel appareil rejoint avec les étiquettes et la playlist du lien et prend son nom de l’ID de l’actif, puis de l’emplacement que vous y annotez dans la console Admin.

Un appareil déjà un écran reste cet écran à travers redémarrages et mises à jour. Après un powerwash ou une réinstallation, il revient comme le même écran, une fois que son ancienne identité Lecteur est silencieuse depuis dix minutes. Limitez un lien avec une limite de nombre maximal d’écrans, désactivez-le pour empêcher de nouveaux écrans de se joindre, ou faites-le tourner pour remplacer une URL trop largement partagée. Les écrans déjà créés par un lien continuent de jouer à travers les trois. Gardez l’URL dans la console Admin : elle crée des écrans dans votre projet.

Alimentation de l’afficheur via RS-232

Connectez le port de contrôle RS-232 de l’afficheur à l’appareil ChromeOS avec un adaptateur série USB, et accordez l’adaptateur à https://play.screenrig.ai avec la politique SerialAllowUsbDevicesForUrls (les ID fournisseur et produit USB de l’adaptateur) ou SerialAllowAllPortsForUrls. Au démarrage, le Lecteur détecte un afficheur Samsung (MDC), LG, NEC ou Philips (SICP) sur le port accordé à la vitesse par défaut d’usine de 9600 bauds et l’ID d’afficheur. Il bascule ensuite l’alimentation, la veille et la remise sous tension de l’afficheur, et rapporte l’état d’alimentation que l’afficheur renvoie. La liste des capacités hôtes de l’écran inclut Alimentation de l’afficheur (RS-232).

Liens de flotte dans un gestionnaire d’appareils

L’URL d’un lien de flotte (tableau de bord Paramètres → Liens de flotte, ou screenrig fleet-links create) se saisit aussi dans votre gestionnaire d’appareils :

• Android, Google TV et Amazon Signage Stick. Dans votre EMM ou gestionnaire d’appareils, définissez la clé fleet_link dans la configuration gérée de l’application (package ai.screenrig.player).
• Apple (Mac, Apple TV, iPhone et iPad). Dans votre MDM, définissez la clé fleet_link dans la configuration d’application gérée.
• Linux et Raspberry Pi. Placez l’URL dans le fichier /etc/screenrig/fleet-link, ou ajoutez --fleet-link URL au programme d’installation (sh -s -- --kiosk --fleet-link URL).

Sur Android et Apple, les clés facultatives asset_id et location nomment le nouvel écran (ID d’actif d’abord), et serial permet à un appareil réinstallé de retrouver son écran.

Un appareil sans écran rejoint de lui-même le projet du lien. Un appareil dont le lien ne fonctionne plus (renouvelé, désactivé, complet ou expiré) affiche son code de jumelage avec une ligne qui en explique la raison. Gardez l’URL dans le gestionnaire d’appareils : elle crée des écrans dans votre projet.

Un lien de flotte peut prendre fin au moment de votre choix : passez --expires-at (par exemple 2027-12-31T23:59:59Z) à screenrig fleet-links create ou à update, ou remplissez le champ Expire dans le tableau de bord. Après ce moment, les nouveaux appareils affichent leur code de jumelage, et les écrans créés par le lien continuent de jouer.

Propriétaire de l’appareil Android par code QR

Un appareil Android 10 ou ultérieur doté d’une caméra et réinitialisé aux paramètres d’usine rejoint un lien de flotte sans gestionnaire d’appareils. Ouvrez le lien dans le tableau de bord (Paramètres → Liens de flotte), choisissez Afficher le code QR sous Propriétaire de l’appareil Android, touchez six fois l’écran de bienvenue de l’appareil et numérisez le code. L’appareil télécharge le Player géré, le vérifie avec le certificat de signature contenu dans le code, l’installe comme propriétaire de l’appareil et rejoint le projet du lien sans code de jumelage. Le Player s’exécute ensuite comme application d’accueil de l’appareil, en plein écran, sans barre de navigation, notifications ni écran de verrouillage.

Le code contient une charge d’approvisionnement, et Copier le JSON d’approvisionnement la copie pour un gestionnaire d’appareils qui approvisionne à partir de JSON. Votre agent affiche la même charge avec screenrig fleet-links show ID --android-provisioning (une connexion Manage est requise, car la charge contient le secret du lien), prête à être encodée en code QR. La charge se présente ainsi :

{
  "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 et CHECKSUM proviennent de l’entrée managed de https://screenrig.ai/android/manifest.json : son package, https://screenrig.ai suivi de son path, et son signer_sha256 en base64 compatible URL, sans remplissage. FLEET_LINK_SECRET est la partie de l’URL du lien qui suit #fleet=. Le fichier est versionné et conservé, et la somme de contrôle appartient au certificat de signature : un code imprimé continue donc de fonctionner quand un Player plus récent est publié. Le code contient le secret du lien : ne le partagez qu’avec la personne qui configure l’appareil.

Sources navigateur (vMix, OBS)

Une source navigateur ne conserve rien : le lecteur qui s’y trouve perdrait son jumelage à chaque chargement. Un lien d’écran est l’adresse d’un seul écran : le lecteur ouvert depuis ce lien est cet écran à chaque chargement, sans rien conserver. Utilisez-le pour une source navigateur vMix ou OBS, ou pour tout navigateur qui efface ses données.

1. 01

   Jumelez l’écran une seule fois. Ouvrez l’application Web du lecteur dans n’importe quel navigateur, donnez à votre agent le code affiché, puis attendez que l’écran soit actif.

2. 02

   Demandez à votre agent le lien de l’écran (screenrig screen link create SCREEN_ID), ou ouvrez l’écran dans le tableau de bord et choisissez Créer le lien dans la ligne Lien d’écran de son onglet Propriétés.

3. 03

   Copiez le lien : votre agent l’affiche avec screenrig screen link show SCREEN_ID, ou choisissez Copier le lien dans le tableau de bord. C’est https://play.screenrig.ai/player/#screen= suivi d’un secret.

4. 04

   Collez-le comme URL de la source navigateur.

5. 05

   La source lit aussitôt la liste de lecture de l’écran, et de nouveau après chaque rechargement.

Ouvrez un lien d’écran à un seul endroit. Ouvert à deux endroits, c’est un seul écran deux fois. Plusieurs sources navigateur dans un même navigateur, chacune avec son propre lien, fonctionnent comme des écrans distincts.

Un lien d’écran est un identifiant d’accès : quiconque le possède ouvre cet écran. S’il fuit, ou si vous voulez le reprendre, demandez de nouveau le lien (screenrig screen link create SCREEN_ID, ou Remplacer le lien) : l’ancienne adresse cesse de fonctionner aussitôt et une source qui l’affiche encore montre un avis et aucun contenu, sans code de jumelage. Collez la nouvelle adresse et la source rejoue. Désactiver le lien (screenrig screen link delete SCREEN_ID) met fin au lien sans en créer un nouveau. Le propre lecteur de l’écran, s’il en a un, n’est touché dans aucun cas.

Publicité sur vos écrans

Le lecteur que vous utilisez déjà est aussi le lecteur publicitaire : rien d’autre à installer.

La vente est un choix que vous faites par écran, via le même plugin officiel et la CLI. Incluez un écran détenu avec screenrig ads inventory update scr_LOBBY --enabled et décrivez-le publiquement avec le nom du site, la ville, la région, le type de lieu et les balises d’audience que vous choisissez. Définissez des emplacements publicitaires réutilisables avec screenrig ads slots create — médias acceptés (image ou vidéo), durées maximales d’image et de vidéo, et une option de remplacement de tarif pour cet emplacement. Une définition d’emplacement seule ne change rien sur l’écran ; placer sa page d’emplacement publicitaire dans l’une de vos listes de lecture donne à cet écran une vraie pause publicitaire, et toutes les autres pages continuent de jouer normalement.

Les publicités payantes nécessitent un Lecteur qui prend en charge la lecture d’emplacements publicitaires. Le serveur sert à un Lecteur sans ce support uniquement la liste de lecture ordinaire, de sorte que cet écran lit du contenu maison et aucune publicité payante ; un Lecteur capable demande un remplissage pour chaque page d’emplacement publicitaire et saute tout emplacement qu’il ne peut remplir, maintenant la liste de lecture en mouvement. Les acheteurs ne jumèlent rien — ils achètent dans votre inventaire via l’invitation que vous envoyez avec screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY.

Le plugin, le projet et les étapes du premier écran sont dans le Guide de démarrage.

Afficheurs commerciaux

Samsung Smart Signage (Tizen) exécute le lecteur natif screenRIG.

Les lecteurs BrightSign sous OS 9.1 ou plus récent démarrent automatiquement le Player screenRIG depuis une carte SD. Extraire le paquet à la racine de la carte, l’insérer et allumer. Le lecteur applique sa politique matérielle et ouvre le Player screenRIG.

1. 01

   Réglez d’abord l’horloge et le réseau du lecteur. Une horloge incorrecte bloque la connexion sécurisée.

2. 02

   Extrayez-le à la racine d’une carte SD FAT32 et insérez la carte.

3. 03

   Alimente le lecteur. Il démarre le paquet et affiche le code de jumelage.

4. 04

   Donnez le code à votre agent.

LG webOS Signage

Les afficheurs LG webOS Signage en version 6.0 ou plus récente (Chromium 79 ou plus récent) exécutent le lecteur screenRIG. Une application installée démarre à la mise sous tension et l’ouvre. Les afficheurs sous webOS Signage 4.x ou plus ancien utilisent un navigateur plus ancien que celui dont le lecteur a besoin. Téléchargez les paquets depuis screenrig.ai/webos/.

Un afficheur en mode de lancement d’applications Local installe com.lg.app.signage.ipk depuis une clé USB.

1. 01

   Réglez d’abord la date, l’heure et le réseau de l’afficheur. Une horloge incorrecte interrompt l’installation avec « Unknown error » et bloque la connexion sécurisée.

2. 02

   Sur une clé USB FAT32, créez à la racine un dossier nommé application et placez-y com.lg.app.signage.ipk. Conservez le nom du fichier.

3. 03

   Branchez la clé à l’afficheur. Dans Server Settings, réglez Application Launch Mode sur Local et le type sur IPK, puis lancez Local Application Upgrade depuis USB.

4. 04

   Redémarrez l’afficheur. Il démarre l’application et affiche le code de jumelage.

5. 05

   Donnez le code à votre agent.

Pour installer depuis le menu des applications de l’afficheur ou depuis un serveur SI, utilisez plutôt ScreenRig-webos.ipk. Les deux paquets sont des applications distinctes pour l’afficheur, chacune avec son propre jumelage : installez-en un seul par afficheur.

Un afficheur qui démarre avant que son réseau soit prêt affiche l’écran screenRIG et réessaie jusqu’à ce que le lecteur réponde. Appuyez sur Info sur la télécommande pour voir le modèle de l’afficheur, la version du navigateur et l’état de la connexion.

D’autres afficheurs commerciaux avec un navigateur HTML5 intégré ou un lanceur d’URL peuvent ouvrir directement play.screenrig.ai/player/ et suivre les étapes de l’application Web ci-dessus. L’afficheur doit garder la page au premier plan et lui permettre de stocker des données. Les boîtiers Android TV et de diffusion avec un navigateur Web complet peuvent faire de même : ouvrez play.screenrig.ai/player/ dans le navigateur du boîtier, donnez à votre agent le code de jumelage, et gardez la page au premier plan.

Flux et images de secours

Utilisez stream pour un flux en direct et video pour un fichier téléversé. Un flux nécessite une image téléversée prête du même compte comme secours. L’image apparaît lors de la connexion, si la lecture s’interrompt ou lorsque le lecteur ne peut pas recevoir la source.

Préparer un flux

Utilisez une playlist HLS HTTPS publique sans identifiants intégrés, ou l’URL RTSP d’une caméra. Pour le lecteur Web, la playlist, les segments et les clés doivent autoriser les requêtes cross-origin depuis l’origine du lecteur. La vidéo H.264 avec audio AAC est un profil de départ pratique ; le décodage dépend de l’appareil. L’audio est muet par défaut, et les règles d’autoplay du navigateur s’appliquent toujours.

Choisissez le moment et le transport

Utilisez au plus un flux par page et une avance basée sur la durée. Fournissez une ou deux sources avec des protocoles différents, par ordre de préférence. Une source peut ne donner que son url : une URL https est du HLS, une URL rtsp ou rtsps est du RTSP. Pour le multicast, utilisez un groupe IPv4 à portée administrative dans 239/8 et un port UDP ; ajoutez une alternative HLS pour les autres lecteurs. screenRIG ne convertit pas le multicast en HLS. Les flux ne sont pas mis en cache pour la lecture hors ligne ; l’image de secours l’est.

Lire une caméra directement

Les Players Android, Amazon et Linux ouvrent eux-mêmes les sources de caméra rtsp://, depuis le réseau du Player, sans relais. Utilisez l’URL fournie par la caméra ou l’enregistreur, y compris les identifiants user:pass@. Linux ouvre aussi les sources rtsps://.

Pour une caméra UniFi Protect, activez RTSP pour un canal dans les réglages Protect de la caméra et copiez son URL. Android et Amazon convertissent l’URL rtsps:// de Protect sur le port 7441 en rtsp:// non chiffré sur le port 7447, en retirant enableSrtp. Le Player doit pouvoir joindre le port 7447 de la console Protect; cette connexion n’utilise ni TLS ni SRTP. Pour les autres sources RTSPS chiffrées sur Android et Amazon, utilisez une source HLS alternative ou l’image de secours. Les autres Players lisent la source HLS alternative ou affichent l’image de secours.

Activer la réception multicast

Sur Android, ouvrez le menu opérateur, choisissez Paramètres et activez les flux Multicast ; c’est désactivé par défaut. Sur Qt, activez SCREENRIG_ENABLE_MULTICAST=1 dans l’environnement de lancement du Player et vérifiez --capabilities-json. Le réseau doit transporter le groupe multicast et le port sélectionnés. Cette version ne fournit pas DRM, RTP, en-têtes d’authentification personnalisés ni transcodage de flux.

Bandes sonores

Une bande sonore de liste de lecture joue sur chaque Player. Le Player télécharge et vérifie chaque piste MP3 avec le reste de la liste, puis joue les pistes dans l’ordre pendant que les pages changent. Les transitions de page ne stoppent ni ne redémarrent la musique, et la bande sonore continue de jouer hors ligne à partir des pistes en cache. Une bande sonore lancée (cued: true) joue une piste seulement quand un repère de page la démarre et reste silencieuse après la fin de cette piste jusqu’au repère suivant. Une page dont advance est audio_end se termine quand sa piste lancée se termine ; si le Player ne peut pas jouer la piste, la page dure la longueur de la piste.

Lorsque l'agent republie la liste de lecture, la piste en cours continue de jouer si elle fait toujours partie de la nouvelle bande sonore. Le volume de la bande sonore est multiplié par le volume du Player, donc le réglage du volume de l'opérateur ou le contrôle de volume propre à l'afficheur décide toujours du niveau sonore de l'écran.

Les navigateurs peuvent bloquer le son jusqu’à ce que quelqu’un touche la page. L’app web Player continue d’afficher les pages et lance la bande sonore au premier tapotement ou appui sur une touche. Pour un navigateur de kiosque sans surveillance, autorisez la lecture automatique avec son ; dans Chromium, lancez avec --autoplay-policy=no-user-gesture-required ; sur un kiosque ChromeOS, définissez la politique AutoplayAllowlist. Les Players natifs n’ont pas besoin de réglage.

Santé de l’appareil et contrôle de l’afficheur

Chaque Player rapporte la santé de l’appareil toutes les quinze minutes, et immédiatement quand sa connexion d’affichage ou son alimentation changent. Il déclare les contrôles d’appareil qu’il supporte : redémarrage à distance, et les méthodes d’alimentation d’affichage qu’il peut utiliser. Ce que le Player peut lire et changer dépend de la plateforme et de la configuration de l’appareil.

Les capacités réelles de chaque écran apparaissent dans screen show comme ses capacités d’hôte, à côté de son dernier rapport d’état, afin que l’agent sache avant d’agir si cet écran peut redémarrer ou changer d’afficheur. Le tableau indique ce que chaque lecteur peut faire.

Actions à distance

Trois autres commandes d’appareil parviennent à un Player sous forme de commandes : vider ses caches, redémarrer son application (pas l’appareil) et le mettre à jour vers la plus récente version. Un Player déclare clear_cache, restart_app ou update dans ses capacités hôtes seulement là où le comportement fonctionne sur cet appareil, donc screen show renseigne l’agent avant qu’il agisse ; un écran dont le Player ne déclare pas la capacité répond command_unsupported et rien n’est envoyé. Vider le cache conserve le jumelage et les paramètres et remplit de nouveau le contenu à partir du manifeste. Chaque commande est listée sous commands dans screen show, done ou failed avec la cause que le Player rapporte.

Assombrissement à l’inactivité, luminosité automatique et verrouillage du kiosque

Trois paramètres d’écran façonnent l’affichage sur l’appareil lui-même. Un Player en applique un lorsque screen show liste sa capacité d’hôte (display_power.idle, brightness.auto ou kiosk_lock) ; le paramètre est enregistré dans les deux cas.

• Assombrissement à l’inactivité. Après 30 à 86400 secondes sans toucher ni touche ou, lorsque presence est un événement de réveil, sans personne devant l’écran, l’écran s’assombrit et la lecture est mise en pause. Selon votre choix, touch ou presence le rallume ; le toucher qui réveille un écran sombre ne va pas plus loin. La présence lit la caméra de l’appareil sur l’appareil, et aucune image ne le quitte. Un horaire d’affichage ou une substitution qui garde l’afficheur éteint l’emporte.
• Luminosité automatique. auto règle la luminosité d’après le capteur de lumière de l’appareil ; fixed, valeur par défaut, conserve la luminosité de l’opérateur. Un appareil déclare brightness.auto seulement lorsqu’il a un capteur de lumière.
• Verrouillage du kiosque. Le Player Android s’épingle à l’écran avec l’épinglage d’écran, sans propriétaire d’appareil requis. La personne devant l’écran confirme la première fois, et la barre d’état, l’accueil et les applications récentes sont bloqués tant que l’épinglage est actif.

Votre agent les définit avec screen display-idle, screen brightness et screen kiosk-lock. L’onglet Propriétés de la page de l’écran dans le tableau de bord offre les mêmes trois sous Paramètres de l’appareil.

Vue en direct

La vue en direct montre ce qu’un écran diffuse sous forme de vidéo dans le tableau de bord, et screenrig screen live frame en enregistre des images JPEG pour un agent qui n’a que HTTPS. Le lecteur Android (Google Play et Amazon Signage Stick), Linux et Raspberry Pi la publient, et un écran qui en est capable affiche la capacité d’hôte live_view dans screen show. Sur Android, une personne devant l’écran autorise la capture d’écran une seule fois à chaque démarrage du lecteur. Une session en direct se termine d’elle-même quand sa durée est écoulée; relancez-la pour continuer à regarder.

Contrôler un écran sur l’appareil

Une fois l’écran jumelé, appuyez sur OK sur la télécommande pour ouvrir son menu opérateur. La première page du menu contient :

• Nom de l’écran. Sélectionnez-le pour renommer l’écran.
• Liste de lecture. Son indice est la liste de lecture que l’écran joue. Sélectionnez-la, ou appuyez sur Droite, pour afficher toutes les listes de lecture du projet par ordre alphabétique, et en choisir une pour changer l’écran. Une prise de contrôle, une campagne ou une programmation de liste décide encore ce qui joue ; l’indice nomme toujours ce qui est en lecture.
• Page. Son indice est le nom de la page affichée ; le nom d’une page est son identifiant. Le menu s’ouvre sur cette ligne. Appuyez sur Gauche ou Droite pour passer à la page précédente ou suivante, ou sélectionnez-la pour lister les pages de la liste de lecture dans l’ordre de lecture et en choisir une pour y accéder. La page choisie commence depuis son début.
• Paramètres. Luminosité, volume et réinitialisation, et sur Android réception multicast et démarrage au démarrage.
• Quitter les paramètres ferme le menu depuis n’importe quel écran.

Retour, ou Gauche dans une liste, revient à l’écran précédent. Le menu se ferme automatiquement après 60 secondes sans saisie.

Mettre en pause et reprendre

Appuyez sur Play/Pause sur la télécommande (K sous Windows) pour mettre l’écran en pause ; la puce Pause s’affiche. Un écran en pause conserve son minuteur de page, la vidéo de la page et la bande sonore. Appuyez de nouveau sur le bouton et tout reprend là où c’était arrêté : une page prévue pour 20 secondes, mise en pause à 10 secondes, s’affiche pendant les 10 secondes restantes, et la musique reprend au même point au lieu de recommencer. Passer à la page suivante ou précédente, ou en choisir une dans le menu, conserve la pause : la nouvelle page attend son début jusqu’à ce que vous repreniez. Les cartes, pages web et flux en direct continuent pendant la pause. Une pause se termine d’elle-même après 60 minutes.

Vérifiez votre premier écran

Donnez à votre agent l’écran prévu et demandez-lui de publier un simple message de bienvenue. Demandez une capture d’écran lorsque le lecteur l’affiche.

Si l’écran est absent de la liste de l’agent, confirmez que le lecteur est ouvert et que sa configuration est terminée. Si le contenu ne se met pas à jour, vérifiez la connexion de l’appareil et demandez à l’agent d’inspecter l’état de l’écran et les preuves de lecture.

Une puce à l’écran, ou un code dans screen show, est expliquée dans Codes de statut du Player.

Une fois l’écran jumelé, son menu opérateur nomme l’écran et affiche sa playlist et sa page.

Continuer avec le flux de travail de l’agent.