Commande d'action Skip Next
Les applications tierces, ou les fichiers HTML5, peuvent invoquer la commande d'action Skip Next via le Broadsign Control Player API. La commande « Skip Next » force le lecteur à ignorer la prochaine copie publicitaire dans la boucle et à commencer immédiatement à précharger la copie publicitaire suivante en préparation. Cela n'interrompt pas le contenu en cours de lecture.
Une application tierce surveillant un événement pourrait vouloir signaler à Broadsign Control Player quoi jouer lors de la phase de pré-mise en mémoire tampon. De même, un fichier HTML5 dynamique pourrait devoir être diffusé dans un créneau à durée dynamique. Puis, en fonction d'un événement ou d'une variable, la session se ferme automatiquement.
Vous pouvez réaliser ces cas d'utilisation avec l'action skip_next.
Si le contenu ne doit pas être lu, au lieu d'envoyer une commande d'arrêt au moment de la lecture pour ignorer le contenu une fois la pré-mise en mémoire tampon terminée, l'action skip_next permet d'ignorer le contenu à l'étape de pré-mise en mémoire tampon. Cela évite les mises en mémoire tampon indésirables et permet d'entrer plus tôt dans la phase de pré-mise en mémoire tampon du contenu suivant.
Lorsque l'action skip_next est appelée, l'étape de pré-mise en mémoire tampon du contenu suivant démarre immédiatement. Cela fonctionne même si la mise en mémoire tampon du contenu suivant est déjà terminée.
Note : Lorsqu'une copie publicitaire HTML appelle l'action skip_next, l'emplacement suivant est complètement supprimé de la boucle, et aucun autre emplacement (régulier ou préempté) ne le remplacera. Ce comportement aura pour effet de raccourcir la boucle.
Appelez l'action skip_next 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
Pour utiliser l'outil remote_action en ligne de commande, recherchez l'exécutable dans le répertoire bin d'installation de Broadsign Control Player. Par exemple, pour envoyer une commande skip_next, tapez :
remote_action.exe skip_next -f 1234
Où :
-
skip_next : Le type d'action.
-
-f : Spécifie l'identifiant du cadre à ignorer.
Avertissement : Omettre l'option -f permet au lecteur de sauter les cadres suivants prêts à être lus et de commencer immédiatement à pré-mettre en mémoire tampon le contenu suivant en préparation. Cela n'interrompt pas le contenu en cours de lecture.
Une application personnalisée peut utiliser l'action Skip Next sur Broadsign Control Player en envoyant un message XML au port monitor_remote (2324) :
<rc version="1" id="1" action="skip_next" frame_id="1234" />\r\n\r\n
Note : Vous devez terminer la requête avec \r\n\r\n.
Le lecteur répondra avec le document suivant :
<!DOCTYPE rc>
<rc id="1" version="1" action="skip_next" status="1"/>
Note : Chaque commande envoyée nécessite un identifiant unique (id). L'application peut utiliser ici une valeur d'incrémentation simple.
Action de commande Skip Next - 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 |
|---|---|
| id | Contient l'identifiant de la requête. |
| version | La version est toujours 1. |
| action | Le type d'action à entreprendre, dans ce cas skip_next. |
| status | Un résultat de « 1 » indique que la commande a réussi. |
| frame_id | Facultatif. Il s'agit de l'identifiant du cadre dans lequel le contenu doit être ignoré. Si vous omettez frame_id, le lecteur ignore les cadres suivants prêts à être lus et commence immédiatement à précharger le contenu suivant en préparation. Cela n'interrompt pas le contenu en cours de lecture. |
Une application personnalisée peut utiliser l'action Skip Next en envoyant un message JSON au serveur WebSocket de monitor_remote (port 2326). Vous devrez activer le serveur WebSocket. Pour plus d'informations, consultez L'onglet «Remote Control».
{
"rc": {
"version": "1",
"id": "1",
"action": "skip_next",
"frame_id": "1234"
}
}
Note : Chaque commande envoyée nécessite un identifiant unique (id). L'application peut utiliser ici une valeur d'incrémentation simple.
Le lecteur répondra avec le document suivant :
{
"rc": {
"id": "1",
"version": "1",
"action": "skip_next",
"status": "1"
}
}
Action de commande Skip Next - 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 |
|---|---|
| id | Contient l'identifiant de la requête. |
| version | La version est toujours 1. |
| action | Le type d'action à entreprendre, dans ce cas skip_next. |
| status | Un résultat de « 1 » indique que la commande a réussi. |
| frame_id | Facultatif. Il s'agit de l'identifiant du cadre dans lequel le contenu doit être ignoré. Si vous omettez frame_id, le lecteur ignore tous les cadres qui diffusent du contenu et passe à l'étape de pré-mise en mémoire tampon du contenu suivant. |
