Construire un scénario de lecture avec les balises

Grâce à un système de balises, vous pouvez modifier dynamiquement le comportement du lecteur en ajoutant des paramètres directement dans les noms de vos dossiers ou fichiers.

Que vous souhaitiez créer une boucle de lecture, ajuster le volume automatiquement, synchroniser plusieurs lecteurs, ou encore contrôler des périphériques externes (comme des vidéoprojecteurs ou des pages web), les balises vous offrent une flexibilité totale.

TABLE DES MATIÈRES

• Introduction aux balises
• Exemples d'utilisation des balises pour les dossiers
  • Saut vers un dossier avec [Jxxx]
  • Lecture en boucle avec [LOOP]
  • Reprise de lecture avec [RESUME]
  • Retour au dossier précédent avec [RET]
  • Lecture aléatoire ou séquentielle avec [RND] ou [SEQ]
  • Réglage absolu du volume avec [Vx]
  • Réglage relatif du volume avec [V+x] ou [V-x]
  • Désactivation des commandes avec [NT]
  • Désactivation du redéclenchement avec [NRST]
  • Lecture conditionnelle avec [WHL]
  • Lecture d'un nombre défini de fichiers avec [NXTxxx]
  • Affichage des sous-titres avec [SUBS x] et [SUBE x]
  • Ouverture de pages web avec [WEBS x] et [WEBE x]
  • Fermeture de pages web avec [WEBS OFF] et [WEBE OFF]
  • Contrôle du vidéoprojecteur avec [PROJS ON/OFF]
  • Activation des contacts de sortie avec [RESxxxxxxxx] et [REExxxxxxxx]
  • Envoi de trames RS-232 avec [RSSxxx] et [RSExxx]
  • Description des dossier SYSTEM et WWW (optionnels)
• Organisation des fichiers à l'intérieur des dossiers
• Ajout de balises aux noms de fichiers pour construire un scénario de lecture
• Exemples d'utilisation des balises pour les dossiers
  • Saut vers le dossier xxx à la fin de la lecture du fichier avec [Jxxx]
  • Désactivation des événements de commande en cours de lecture du fichier avec [NT]
  • Attribution de la durée de lecture d'une image avec [DUR x] ou [DURATION x]
  • Synchronisation de lecteurs entre eux pour démarrer la lecture en même temps [SYNCHRO] 
  • Ouverture d'une page web en début ou en fin de lecture du fichier avec [WEBS x] et [WEBE x] 
  • Fermeture d'une page web en début ou en fin de lecture du fichier avec [WEBS OFF] et [WEBE OFF]
  • Gestion des projecteurs avec [PROJS ON], [PROJE ON], [PROJS OFF] et [PROJE OFF]

Introduction aux balises

• Définition : Les balises sont des paramètres optionnels encadrés par des crochets [ ].
• Utilisation : Elles permettent de construire des scénarios de lecture personnalisés.
• Exemple : 001[LOOP][V50] MonDossier

Cas d'un dossier sans balise
Le lecteur lit le dossier en cours en entier et en aléatoire puis s'arrête. Le dossier est interruptible.

Cas d'un dossier absent
Si un dossier est absent mais qu'une action le désigne, l'action est ignorée

Exemples d'utilisation des balises pour les dossiers

Saut vers un dossier avec [Jxxx]

Cette balise définit le comportement à la fin de la lecture du dossier. Il indique le numéro 0 à 999 du prochain dossier à jouer. Ce numéro peut également être celui du dossier lui-même afin de le jouer en boucle. Par défaut, en l'absence de cette balise, la lecture s'arrête à la fin du dossier.

Exemple de lecture en boucle à la mise sous tension
000[J000] : Lit des fichiers en boucle à la mise sous tension.

Autres exemples
001[J002] : Saut vers le dossier 002 à la fin de la lecture du dossier 001
003[J003] : Saut vers le dossier 003 à la fin de la lecture de 003 -> Création d'une boucle du dossier
003
008[J023] : Saut vers le dossier 023 à la fin de la lecture du dossier 008
127[J000] : Saut vers le dossier 000 à la fin de la lecture du dossier 127
A chaque boucle, les balises de début et de fin de dossier sont exécutées.

Si le dossier de destination n'existe pas, la lecture est stoppée.
Un dossier de destination vide n'est pas un cas particulier. Sa lecture est simplement instantanée puisqu'il n'y a pas de fichier à jouer. Cela signifie que les balises éventuelles d'un dossier de destination vide sont appliquées normalement. La lecture s'arrête dans un tel dossier, à moins qu'il possède des balises [Jxxx] ou [RET].

Lecture en boucle avec [LOOP]

Contrairement au saut sur lui-même (ex 001[J001]), cette balise permet de lire en boucle le contenu du dossier sans exécuter les autres balises contenues dans le nom du dossier à chaque boucle. Cette fonction est particulièrement intéressante en cas d'utilisation des balises de gestion des contacts de sortie pour éviter l'envoi d'informations inutiles à chaque bouclage.

Exemple
001[LOOP]

Reprise de lecture avec [RESUME]

Quand un dossier est quitté pour lire un autre dossier puis que ce dossier est à nouveau lu, la liste de lecture est par défaut réinitialisée. Dans certains cas, il est utile de reprendre la lecture à l'endroit où elle s'est arrêtée.

Par exemple dans un dossier contenant 10 fichiers, les 5 premiers ont été lus, un nouveau dossier est appelé en lecture puis la lecture revient dans le dossier précédent. Avec la balise [RESUME] la lecture reprendra au fichier 6 plutôt qu'au début de la liste.

Exemple
001[RESUME]

Retour au dossier précédent avec [RET]

Au cours de la lecture d'un dossier, si un événement ou une balise ordonne de jouer un autre dossier ayant une balise [RET], alors le lecteur saute vers ce nouveau dossier et à la fin de sa lecture retourne au dossier initial. Cette fonction peut être utilisée pour reprendre la lecture d'un dossier interrompue par la lecture d'un message déclenchée par un événement.

Exemple
001[J100] : Lit le dossier 001 puis saute vers le dossier 100
002[J100] : Lit le dossier 002 puis saute vers le dossier 100
100[RET] : Lit le dossier 100 puis retourne au dossier précédent (001 ou 002)
Dans l'exemple ci-dessus, à la fin de la lecture du dossier 001 ou 002, le dossier 100 est joué, puis la lecture reprend dans le dossier initial (001 ou 002).

Remarque
La balise [RET] ne comprend qu'un seul niveau de retour, c'est-à-dire que le dossier d'arrivée est toujours le dossier précédemment joué, quel que soit le nombre de dossiers avec une balise [RET] joués à la suite.

Lecture aléatoire ou séquentielle avec [RND] ou [SEQ]

Par défaut, sans ce paramètre, le répertoire est lu de façon aléatoire. 

[ SEQ] : lecture des fichiers par ordre croissant du premier caractère alphanumérique du nom (de 1 à infini puis de A à Z puis de a à z puis les caractères spéciaux puis les alphabets non ASCII). La numérotation de tous les fichiers est la meilleure méthode à adopter.

[RND] : lecture dans un ordre aléatoire.

Exemple
001[SEQ] : Lit le dossier 001 en mode séquentiel, puis s'arrête
002[RND][J002] : Lit le dossier 002 en boucle et en aléatoire
003[J001] : Lit le dossier 003 en aléatoire puis saute vers le dossier 001

Réglage absolu du volume avec [Vx]

Le nom du dossier peut agir sur le volume de sortie. Cette fonction est utilisée pour changer le volume en fonction d'un dossier particulier. Une fois le volume changé, il reste mémorisé par le lecteur pour tous les fichiers restants à lire. Si les valeurs de changement dépassent les valeurs de niveau maximum ou minimum du lecteur, alors les valeurs maximum ou minimum sont utilisées.

Exemple
001[V5] : Fixe la valeur du volume à 5 sur 100 pas disponibles
001[V34] : Fixe la valeur du volume à 34 sur 100 pas disponibles
001[V100] : Fixe la valeur du volume à sa valeur maximum
001[V0] : Fixe la valeur du volume à sa valeur minimum (Mute)

Réglage relatif du volume avec [V+x] ou [V-x]

Par opposition à la balise [Vx], l'utilisation des ces options permettent de modifier le volume de façon temporaire durant la lecture du dossier en cours uniquement. Quand la lecture saute dans un autre dossier, le volume précédent est restauré. Cette fonction permet par exemple d'augmenter le volume d'une publicité puis revient à son niveau précédent. La valeur x est comprise entre 0 et 100.

Exemple
001[V+5][J002] : Augmente le volume de 5 pas pendant la lecture du dossier 001 puis le volume sera restauré à sa valeur précédente lors du saut dans le dossier 002
004[V-24][RET] : Diminue le volume de 24 pas pendant la lecture du dossier 004 puis le volume sera restauré à sa valeur précédente lors du retour du dossier précédent

Désactivation des commandes avec [NT]

Si cette option est inscrite dans le nom du dossier, les fichiers lus ne peuvent pas être interrompus, et les ordres reçus sont ignorés dans les différents cas listés dans le tableau ci-dessous :

Attention, l'action n'est pas mémorisée et l'information de déclenchement est perdue. Il est toutefois possible de rendre certains périphériques actifs malgré la balise NT en forçant les actions possibles dans le menu de configuration du lecteur.

Sans cette option, la lecture du dossier peut être interrompue à tout moment par un événement de commande (contact d'entrée, RS-232, Scheduler, etc.).

001[NT] : Les commandes reçues sont ignorées durant la lecture du dossier 001. Une action sur l'un des contacts d'entrée, par RS-232 ou autre est ignorée, et la lecture du dossier en cours n'est pas arrêtée.

Désactivation du redéclenchement avec [NRST]

Le dossier en cours de lecture ne peut pas être relancé par l'ordre qui l'appelle. Les autres ordres sont pris en compte.

Lecture conditionnelle avec [WHL]

Cette balise permet de lire le contenu d'un dossier tant que la combinaison d'entrée(s) correspondant à ce dossier est activée. Lorsque la combinaison d'entrée(s) associée au dossier est désactivée, le lecteur applique les balises relatives à la sortie du dossier. Tant que la combinaison d'entrée(s) correspondant au dossier est activée, le dossier est joué en boucle.

Exemple
001[WHL] : Le dossier 001 est lu en boucle tant que la combinaison d'entrée 1 est activée. Lorsque la combinaison d'entrée 1 est désactivée, le lecteur passe en STOP.
002[WHL][J045] : Le dossier 002 est lu en boucle tant que la combinaison d'entrée 2 est activée. Lorsque la combinaison d'entrée 2 est désactivée, le lecteur lit le dossier 045. 003[WHL][J999] : Le dossier 003 est lu en boucle tant que la combinaison d'entrées 3 est activée (entrées 1 et 2 activées). Lorsque la combinaison d'entrées 3 est désactivée (entrées 1 et 2 désactivées), le lecteur lit le dossier 999.

Les entrées contact sec du lecteur sont combinatoires. Par conséquent, toutes modifications de la combinaison des entrées activées seront prises en compte à tout moment par le lecteur.

Exemple
000[J000] : Le dossier 000 est lu en boucle à la mise sous tension
001[WHL][J000] : Le dossier 001 est lu en boucle tant que la combinaison d'entrée 1 est activée (entrée 1 seule). Si l'entrée 2 est activée en plus de l'entrée 1, cela active la combinaison d'entrées 3, et donc le lecteur lit le dossier 003.
002[WHL][J000] : Le dossier 002 est lu en boucle tant que la combinaison d'entrée 2 est activée (entrée 2 seule). Si l'entrée 1 est activée en plus de l'entrée 2, cela active la combinaison d'entrées 3, et donc le lecteur lit le dossier 003
003[WHL][J000] : Le dossier 003 est lu en boucle tant que la combinaison d'entrées 3 est activée (entrées 1 et 2 activées). Si l'entrée 1 est désactivée, le lecteur lit le dossier 002, mais, si l'entrée 2 est désactivée, le lecteur lit le dossier 001.

Lecture d'un nombre défini de fichiers avec [NXTxxx]

Ce paramètre permet de lire des fichiers parmi ceux présents dans le dossier. Une fois que les fichiers ont été lus, le lecteur applique les balises relatives à la sortie du dossier.

Si le nombre de fichiers demandés par cette balise est supérieur au nombre de fichiers présents dans le dossier, le lecteur boucle dans le dossier autant que nécessaire afin de jouer le nombre exact de fichiers demandés.

Avec cette balise, le lecteur mémorise les fichiers qui sont lus. Cela signifie que les fichiers déjà lus lors d'un précédent passage dans le dossier ne seront par rejoués tant que tous les fichiers du dossier n'auront pas été lus. Le paramètre xxx de la balise [NXTxxx] représente le nombre de fichiers à lire dans le dossier. Il est compris entre 1 et 999.

Exemple
001[NXT003] : 3 fichiers sont lus aléatoirement dans le dossier 001, puis le lecteur passe en STOP
002[NXT001][J000] : 1 fichier est lu dans le dossier 002, puis le lecteur lit le dossier 000
003[NXT005][RET] : 5 fichiers sont lus dans le dossier 003, puis le lecteur revient dans le dossier précédemment lu
004[NXT002][SEQ][J000] : Les 2 fichiers suivants dans l'ordre de numérotation sont lus dans le dossier 004 puis le lecteur lit le dossier 000

Affichage des sous-titres avec [SUBS x] et [SUBE x]

Ces balises permettent de définir les modalités d'affichage des sous-titres en début ou en fin de lecture d'un fichier ou d'un dossier.

Le paramètre peut être : le code ISO639-1, ISO639-2 ou ISO639-3 de la langue des sous-titres à afficher (ex : [SUBS ENG] sélectionne la langue anglaise)

Exemple
000[SUBS NONE] : les vidéos du dossier 000 sous lues à la mise sous tension, les sous-titres sont désactivés
001[SUBS AUTO] : les vidéos du dossier 001 sous lues avec les sous-titres définis dans les paramètres système

Ouverture de pages web avec [WEBS x] et [WEBE x]

Ces balises démarrent une page web (visible ou non) au démarrage ou à la fin de lecture du dossier. Le paramètre x est l'index de la page web tel que défini dans le fichier web-config.json .

Fermeture de pages web avec [WEBS OFF] et [WEBE OFF]

Ces balises ferment la page web en cours au démarrage ou à la fin de lecture du dossier.

Contrôle du vidéoprojecteur avec [PROJS ON/OFF]

Ces balises démarrent ou éteignent un vidéoprojecteur au démarrage ou à la fin de la lecture du dossier.

Se référer au menu Paramètres système pour configurer la connexion d'un vidéoprojecteur
en utilisant le protocole PJLink.

Activation des contacts de sortie avec [RESxxxxxxxx] et [REExxxxxxxx]

Les 8 contacts de sortie se commutent par le nom du dossier soit au début de la lecture du dossier par la balise RES soit à la fin du dossier par la balise REE.

[RESxxxxxxxx] : xxxxxxxx représente l'état des 8 contacts de sortie qui seront activés ou désactivés au début de la lecture du dossier.

[REExxxxxxxx] : xxxxxxxx représente l'état des 8 contacts de sortie qui seront activés ou désactivés à la fin de la lecture du dossier.

Ces deux balises permettent par exemple, d'allumer des lampes quand le dossier est lu et de les éteindre à la fin de la lecture du dossier.

xxxxxxxx représente les 8 sorties : 87654321

Si x = 0, la sortie n'est pas activée, le transistor Mosfet est bloqué, le courant ne passe pas entre la sortie et la masse GND,

Si x = 1, la sortie est activée, le transistor Mosfet est passant et le courant passe entre la sortie et la masse GND,

Si x = #, le transistor Mosfet reste dans l'état préalablement défini.

Exemple
001[RES00000001] La sortie 1 est activée au début de la lecture du dossier 001
002[REE00000000] Toutes les sorties sont désactivées à la fin du dossier 002
003[RES01010101][REE00000000] Les sortie 1,3,5,7 sont activées au début de la lecture du dossier 003 puis désactivées à la fin de la lecture du dossier

Envoi de trames RS-232 avec [RSSxxx] et [RSExxx]

Lorsque le dossier est appelé, une liste d'octets est transmise par la liaison série afin de piloter d'autres appareils (un autre lecteur, une grille de commutation, un vidéoprojecteur, etc). Les octets à envoyer sont contenus dans un fichier texte qui sera créé à cet effet.

[RSSxxx] : xxx désigne le numéro de la ligne du fichier serial.txt qui doit être envoyée quand le dossier est lu.

[RSExxx] : xxx désigne le numéro de la ligne du fichier serial.txt qui doit être envoyée à la fin de la lecture du dossier.

Le fichier de définition des octets à envoyer doit se nommer : serial.txt

Il sera copié dans le dossier SYSTEM du support de stockage.

Le débit (baud rate) est configurable dans le fichier de configuration du lecteur config.txt.

Le paramètre xxx de la balise représente le numéro de la trame à envoyer (identifiant de ligne dans le fichier serial.txt). Il est toujours écrit sur 3 chiffres (exemple : 001, 045, 999). Il est compris entre 001 et 999.

Le fichier de définition des octets à envoyer doit se nommer serial.txt. Ce fichier doit être placé à la racine du support de stockage (carte SD ou clé USB).

Ce fichier est un fichier texte (texte brut, sans mise en forme) qui pourra être créé avec tout éditeur de texte simple tel que « Notepad » de Windows ou similaire. Ce fichier doit être enregistré avec l'encodage « ANSI ». N'utilisez pas de caractères spéciaux.

Le fichier serial.txt de codes RS-232 est un fichier texte contenant une ou plusieurs lignes. Chacune de ces lignes contient une suite d'octets exprimés en hexadécimal (de 00h à FFh) et séparés par un espace. Vous ne devez noter que les deux caractères de la valeur hexadécimale souhaitée.

Chaque début de ligne de ce fichier devra présenter le paramètre suivant : #xxx : xxx identifiant de la ligne contenant les octets à envoyer en rapport avec le xxx de la balise. [RSS002] → ligne #002 - La balise [RSS002] enverra la suite d'octets de la ligne #002 du fichier serial.txt.

Exemple de lignes contenues dans le fichier serial.txt
#001:45 85 63 21 78 A5 B2
#002:98 75 21 35 45 98
#100:21 35 45 78 A5 B2

Il est également possible de mettre des commentaires en fin de ligne dans le fichier en utilisant 2 fois le caractère « barre de division » (// comment).

// fichier exemple
#001:05 A1 FF E4 // commentaire dans la ligne
#005:45 85 63 21 78 A5 B2
#100:98 75 35 45 98 // ma commande
// autre commande
#064: 48 25 Ce 8b
#128:4C 8E D9 5A //
#999:a4 Fc 48 3e 8B
// commentaires en fin du fichier

Exemple
001[RSS001] : Envoie les octets de la ligne #001 du fichier serial.txt à la lecture du dossier 001
002[RSS064] : Envoie les octets de la ligne #064 du fichier serial.txt à la lecture du dossier 002

Si un dossier est joué en boucle, le message xxx défini par la balise [RSSxxx] sera envoyé à chaque bouclage du dossier.

Exemple
001[J001][RSS099] : Lit le dossier 001 en boucle. À chaque bouclage du dossier, le message décrit à la ligne 099 du fichier serial.txt sera envoyé sur la sortie RS-232 du lecteur

Description des dossier SYSTEM et WWW (optionnels)

Ce dossier est optionnel. Il peut contenir des fichiers complémentaires pour personnaliser le lecteur ou lui apporter des fonctions supplémentaires :

• SYSTEM\scheduler.tm2 -> Fichier de programmation horaire
• SYSTEM\scenario-config.json -> Fichier d'indexation des pages web

D'autres fichiers peuvent être présents suivant des extensions/options spécifiques au lecteur.

Le dossier WWW héberge l'ensemble des pages web affichables de façon autonome, que le lecteur soit ou non connecté au réseau via Ethernet.

Organisation des fichiers à l'intérieur des dossiers

Comme les dossiers, le nom des fichiers a une influence directe sur la lecture des fichiers vidéo, images ou audio.

Le nommage des fichiers est libre si la lecture est aléatoire (option «(RND]» ou pas d'option dans le nom du dossier).

En lecture séquentielle, les fichiers sont lus suivant un tri ascendant tenant compte de la casse. Pour vous assurer de l'ordre de lecture, vous pouvez par exemple préfixer le nom de vos fichiers avec un nombre à 3 chiffres. Des options de lecture (balises) peuvent être ajoutées suivant votre besoin, comme le blocage de commandes ou une modification temporaire du volume.

Exemples
001 [J367] mon message.mkv
063 [RS020] nom du fichier.wav
845 [V+12] mon fichier.mp3 ma chanson [NT].wav

Pour plus d'informations sur les types de fichiers supportés par votre lecteur, veuillez vous reporter au chapitre Formats de fichiers audio supportés.

Ajout de balises aux noms de fichiers pour construire un scénario de lecture

Pour modifier le comportement du lecteur, vous pouvez ajouter des paramètres optionnels, appelés "balises", dans le nom du dossier. Ces paramètres sont encadrés par des symboles crochets «[ ]». Vous pouvez utiliser plusieurs paramètres dans le nom du dossier.

Exemples d'utilisation des balises pour les dossiers

Saut vers le dossier xxx à la fin de la lecture du fichier avec [Jxxx]

Cette balise définit le comportement du lecteur à la fin de la lecture d'un fichier ou d'un dossier. Il indique le numéro du dossier à jouer à la suite de ce fichier.

• Si le dossier de destination n'existe pas, la lecture est stoppée.
• Un dossier de destination vide n'est pas un cas particulier. Sa lecture est simplement instantanée puisqu'il n'y a pas de fichier à jouer. Cela signifie que les balises éventuelles d'un dossier de destination vide sont appliquées normalement. La lecture s'arrête dans un tel dossier, à moins qu'il possède des balises [Jxxx] ou [RET].

Exemple
mon fichier [J002].mp3 : Saut vers le dossier 002 à la fin de la lecture du fichier.
003[J023].mp3 : Saut vers le dossier 023 à la fin de la lecture du fichier 003.
034[J034].wav : Saut vers le dossier 034 à la fin de la lecture du fichier 034. Ce n'est pas une boucle avec le fichier 034, mais bien un saut vers le dossier 034.

Désactivation des événements de commande en cours de lecture du fichier avec [NT]

Cette balise fonctionne comme la balise [NT] des dossiers, à la seule différence qu'elle s'applique durant

la lecture du fichier, et non durant la lecture du dossier.

Attribution de la durée de lecture d'une image avec [DUR x] ou [DURATION x]

Cette balise force la durée de lecture d'un fichier de type image indépendamment du réglage de la durée

des images de diaporama. La valeur de x est un nombre de secondes ou le paramètre de lecture infinie

INF (ou INFINITE).

Exemple
[DUR 60], l'image s'affiche 60 secondes
[DUR INF], l'image est affiché indéfiniment
[Dur INFINITE], l'image est affiché indéfiniment
[DURATION 15], l'image s'affiche 15 secondes
[Duration infinite], l'image est affiché indéfiniment

Synchronisation de lecteurs entre eux pour démarrer la lecture en même temps [SYNCHRO] 

Se référer au chapitre "Synchronisation des lecteurs au démarrage d'un fichier"

Ouverture d'une page web en début ou en fin de lecture du fichier avec [WEBS x] et [WEBE x] 

Ces balises démarrent une page web (visible ou non) au démarrage ou à la fin de lecture du fichier. Le

paramètre x est l'index de la page web tel que défini dans le fichier "web-config.json".

Fermeture d'une page web en début ou en fin de lecture du fichier avec [WEBS OFF] et [WEBE OFF]

Ces balises ferment la page web en cours au démarrage ou à la fin de lecture du fichier.

Gestion des projecteurs avec [PROJS ON], [PROJE ON], [PROJS OFF] et [PROJE OFF]

Ces balises démarrent ou éteignent un vidéoprojecteur au démarrage ou à la fin de la lecture du fichier.