Conditions Action

L'action Condition permet aux applications tierces de communiquer avec un Broadsign Control Player, activant des éléments de contenu spécifiques pour la lecture sur l'écran.

programmez des conditions dans Broadsign Control Administrator et associez-les à des bundles ou à des campagnes. Pour qu'un contenu spécifique apparaisse sur vos écrans, les circonstances doivent répondre à une condition spécifiée sur le lecteur.

Exemple : Deux copies publicitaires... une pour jouer quand il pleut dehors, et une pour jouer quand il fait beau. Une application tierce pourrait vérifier périodiquement un flux météo et définir la condition appropriée « Pluvieux » ou « Ensoleillé » dans le lecteur, ce qui lui permettrait d'afficher du contenu sensible à la météo.

Appelez les conditions d'actions en utilisant l'une des options 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) :

    • C:\Program Files\BroadSign\bsp\bin

  • Ubuntu Linux :

    /opt/broadsign/suite/bsp/bin/

Une condition peut être activée sur un lecteur en invoquant l'exécutable autonome remote_action fourni avec Broadsign Control Player. Il peut être trouvé dans le répertoire bin d'installation du lecteur.

Par exemple, pour définir une condition, tapez :

Copier 
remote_action condition -e 1 -x 1 -n "Cloudy Skies"

Où:

En poursuivant l’exemple ci-dessus, la commande équivalente pour désactiver cette condition serait :

Copier 
remote_action condition -e 0 -n "Cloudy Skies"

Lorsque vous générez une liste de lecture après avoir défini une condition, par défaut, le lecteur gardera une trace de tous les éléments lus. Chaque fois que vous appliquez la même condition, l'opération reprendra là où elle s'est arrêtée. Si vous avez besoin d'un comportement différent et que vous souhaitez réinitialiser la liste de lecture conditionnelle, vous devez utiliser une option de régénération -r :

Copier 
remote_action condition -r 1 -e 1 -n "Cloudy Skies"

Lister toutes les conditions actives sur un lecteur :

Ce qui suit vous permet de lister toutes les conditions actives sur un lecteur :

Copier 
remote_action condition --la

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).

Copier 
<rc version="1" id="1" action="condition" exclusive="1" enabled="1" name="cloudy"/>\r\n\r\n

Note : Vous devez terminer la requête avec \r\n\r\n.

Le lecteur répondra avec le document suivant :

Copier 
<rc id="1" version="1" action="condition" status="1"/>

Note : Chaque commande envoyée nécessite un identifiant unique (id). L'application peut utiliser ici une valeur d'incrémentation simple.

Lorsque vous générez une liste de lecture après avoir défini une condition, par défaut, le lecteur gardera une trace de tous les éléments lus. Chaque fois que vous appliquez la même condition, l'opération reprendra là où elle s'est arrêtée. Si vous avez besoin d'un comportement différent et souhaitez réinitialiser la liste de lecture conditionnelle, vous devez utiliser l'option de régénération :

Copier 
<rc version="1" id="1" action="condition" enabled="1" name="cloudy" regenerate="1"/>\r\n\r\n

Lister toutes les conditions actives sur un lecteur :

Vous pouvez créer une application personnalisée pour répertorier toutes les conditions actives sur un lecteur. Envoyer un message XML au port monitor_remote (2324) :

Copier 
<rc version="1" id="1" action="condition" list_active="1" />\r\n\r\n

Le lecteur générera le document XML suivant :

Copier 
<?xml version="1.0"?>
<active_conditions>
    <condition id="12323" name="Sunny"/>
    <condition id="13323" name="Warm"/>
</active_conditions>

Conditions Action - 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 condition.
enabled Réglez sur « 0 » pour désactiver la condition ; réglez sur « 1 » pour activer la condition.
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.
regenerate Si défini sur « 1 », ce paramètre permet de réinitialiser la playlist avec la même condition.
exclusive

Si défini sur « 1 », après avoir généré la boucle, le lecteur supprimera tous les emplacements qui ne présentent pas cette condition.

  • Si un emplacement n'a aucune condition, le lecteur l'interprète comme n'ayant PAS la condition exclusive. Le lecteur le retire ensuite.
  • Si plusieurs conditions sont définies comme exclusives, le lecteur suppose une condition OU. Par conséquent, un forfait avec l’une des conditions exclusives appliquées restera dans la boucle.

Pour plus d'informations, voirCritères et conditions et Génération de playlists.
list_active Utilisez ce paramètre lorsque vous souhaitez répertorier toutes les conditions du lecteur.

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».

Copier 
{
    "rc": {
        "version": "1",
        "id": "1",
        "action": "condition",
        "exclusive": "1",
        "enabled": "1",
        "name": "cloudy"
    }
}

Le lecteur répondra avec le document suivant :

Copier 
{
    "rc": {
        "id": "1",
        "version": "1",
        "action": "condition",
        "status": "1"
    }
}

Lorsque vous générez une liste de lecture après avoir défini une condition, par défaut, le lecteur gardera une trace de tous les éléments lus. Chaque fois que vous appliquez la même condition, l'opération reprendra là où elle s'est arrêtée. Si vous avez besoin d'un comportement différent et souhaitez réinitialiser la liste de lecture conditionnelle, vous devez utiliser l'option de régénération :

Copier 
{
    "rc": {
        "version": "1",
        "id": "1",
        "action": "condition",
        "enabled": "1",
        "name": "cloudy",
        "regenerate": "1"
    }
}

Lister toutes les conditions actives sur un joueur :

Vous pouvez créer une application personnalisée pour répertorier toutes les conditions actives sur un lecteur. Envoyer un message JSON au serveur WebSocket (port 2326) :

Copier 
{
    "rc": {
        "version": "1",
        "id": "1",
        "action": "condition",
        "list_active": "1"
    }
}

Le lecteur affichera le document JSON suivant :

Copier 
{
    "active_conditions": {
        "condition": [
            {
            "id": "12323",
            "name": "Sunny"
            },
            {
            "id": "13323",
            "name": "Warm"
            }
        ]
    }
}

Conditions Action - 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 condition .
activé Réglez sur « 0 » pour désactiver la condition ; réglez sur « 1 » pour activer la condition.
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.
exclusive

Si défini sur « 1 », après avoir généré la boucle, le lecteur supprimera tous les emplacements qui ne présentent pas cette condition.

  • Si un emplacement n'a aucune condition, le joueur l'interprète comme n'ayant PAS la condition exclusive. Le lecteur le retire ensuite.
  • Si plusieurs conditions sont définies comme exclusives, le joueur suppose une condition OU. Par conséquent, un forfait avec l’une des conditions exclusives appliquées restera dans la boucle.

Pour plus d'informations, voirCritères et conditions et Génération de playlists.
regenerate Si défini sur « 1 », ce paramètre permet de réinitialiser la playlist avec la même condition.
list_active Utilisez ce paramètre lorsque vous souhaitez répertorier toutes les conditions du lecteur.