Action Play Now
L'action Play Now permet aux applications tierces de communiquer avec un Broadsign Control Player, générant des éléments de liste de lecture injectés à lire sur un écran.
Programmez des conditions dans Broadsign Control Administrator et associez-les à des campagnes.
Appelez l'action play_now en utilisant l'une des méthodes suivantes :
Serveur WebSocket :
-
JSON – Vous pouvez transmettre des paramètres depuis votre fichier HTML5 à l’aide de JSON.
Note : Assurez-vous de sélectionner Enable Remote Control dans l’onglet Remote Control du profil de configuration. Voir L'onglet «Remote Control».
Note : Si vous utilisez JSON via le serveur WebSocket, tout pare-feu présent sur Broadsign Control Player doit être configuré pour accéder directement au port 2326 pour utilisation.
Port 2324 :
- remote_action – Une application fournie avec Broadsign Control Player qui utilise la ligne de commande.
- XML – Si vous souhaitez développer vos propres applications, vous pouvez communiquer directement avec Broadsign Control Player API en utilisant XML.
Note : Assurez-vous de sélectionner Enable Remote Control dans l’onglet Remote Control du profil de configuration. Voir L'onglet «Remote Control».
Note : Tout pare-feu présent sur Broadsign Control Player doit être configuré pour permettre à bsp.exe d'ouvrir des ports, ou pour configurer directement le port 2324 ou le port 2326 pour l'utiliser.
Note : L'action Déclencheurs est la seule exception à cette règle. Elle utilise le port 2325. Voir Action Triggers.
Vous pouvez appeler cette action sur Windows et Ubuntu Linux, et la trouver via les chemins suivants :
- Windows (64 bits) :
- Ubuntu Linux :
/opt/broadsign/suite/bsp/bin/
C:\Program Files\BroadSign\bsp\bin
Il est possible de modifier une condition pour un lecteur en invoquant l'exécutable autonome remote_action fourni avec Broadsign Control Player. Il se trouve dans le répertoire d'installation bin du lecteur.
Par exemple, pour invoquer la fonction play_now, tapez :
remote_action play_now --name playthisnow --max-duration Value
Où :
- play_now est le type d'action.
- name correspond au nom de la condition (voir conditions). Dans l'exemple ci-dessus, le nom de la condition est
playthisnow. - max-duration correspond à la durée maximale de la lecture, en secondes.
- Si max-duration est supérieure à la longueur totale des éléments conditionnels, la lecture se poursuivra en boucle.
- Si max-duration est omise, inférieure à la durée des éléments, ou égale à 0, la boucle des éléments conditionnels ne sera lue qu'une seule fois.
Note : La condition spécifiée n'est pas activée sur le lecteur, elle ne sera utilisée que pour générer les éléments de la liste de lecture injectés.
Pour les lecteurs non-cinéma :
Le contenu en cours est interrompu et le contenu demandé sera lu. Une fois la lecture du contenu des conditions terminée, la liste de lecture interrompue reprendra là où elle a été interrompue.
Pour les lecteurs cinéma :
La lecture ne sera jamais interrompue, elle sera toujours lue intégralement selon la durée du créneau.
Play Now sera ignoré dans les conditions suivantes :
- Un film est en cours.
- Preshow
Lorsque Play Now est activé, il communiquera avec le périphérique JNIOR pour émuler un démarrage de pré-séance. Lorsque la lecture est terminée, le JNIOR reviendra à l'état dans lequel il se trouvait avant le début de Play Now.
Une application personnalisée peut définir et supprimer des conditions sur Broadsign Control Player en envoyant un message XML au port monitor_remote (2324).
<rc version="1" id="1" action="play_now" name="playthisnow" max-duration="20">/>\r\n\r\n
Note : Vous devez terminer la requête avec \r\n\r\n.
Le lecteur répondra avec le document suivant :
<rc version="1" status="1" action="play_now" id="1" />
Note : Chaque commande envoyée nécessite un identifiant unique (id). L'application peut utiliser ici une valeur d'incrémentation simple.
Action Play Now - Paramètres XML
Note : Tout pare-feu présent sur Broadsign Control Player doit être configuré pour permettre à bsp.exe d'ouvrir des ports, ou pour configurer directement le port 2324 ou le port 2326 pour l'utiliser.
| Paramètre | Description |
|---|---|
| version | La version est toujours 1. |
| id | Contient l'identifiant de la requête. |
| action | Le type d'action à entreprendre ; toujours play_now. |
| name | Le nom de la condition à définir. Cela doit correspondre au nom du critère dans Broadsign Control Administrator. La correspondance des conditions n'est pas sensible à la casse; cependant, les espaces blancs doivent être exacts. |
| max-duration |
Durée maximale de lecture, en secondes. Facultatif.
|
Une application personnalisée peut définir et supprimer des conditions sur Broadsign Control Player en envoyant un message JSON au port 2326. Vous devrez activer le serveur WebSocket. Pour plus d'informations, consultez L'onglet «Remote Control».
{
"rc": {
"version": "1",
"id": "1",
"action": "play_now",
"name": "playthisnow",
"max-duration": "20",
}
}
Le lecteur répondra avec le document suivant :
{
"rc": {
"id": "1",
"version": "1",
"action": "play_now",
"status": "1"
}
}
Action Play Now - Paramètres JSON
Note : Si vous utilisez JSON via le serveur WebSocket, tout pare-feu présent sur Broadsign Control Player doit être configuré pour accéder directement au port 2326 pour utilisation.
| Paramètre | Description |
|---|---|
| version | La version est toujours 1. |
| id | Contient l'identifiant de la requête. |
| action | Le type d'action à entreprendre ; toujours play_now. |
| name | Le nom de la condition à définir. Cela doit correspondre au nom du critère dans Broadsign Control Administrator. La correspondance des conditions n'est pas sensible à la casse; cependant, les espaces blancs doivent être exacts. |
| max-duration |
Durée maximale de lecture, en secondes. Facultatif.
|
