Action Screenshot Request

Appelez l'action screenshot_request 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) :

C:\Program Files\BroadSign\bsp\bin

• Ubuntu Linux :

  /opt/broadsign/suite/bsp/bin/

Vous pouvez demander des captures d'écran à un lecteur en invoquant le fichier 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 demander une capture d'écran, tapez :

remote_action screenshot_request --dest-url "YourURLHere" --burst-duration 1000 --burst-frequency 100 --scale-factor 100

Où :

• screenshot_request : Le type d'action.
• dest-url : L'URL à laquelle vous souhaitez que le lecteur envoie la capture d'écran, au format jpeg.
• burst-duration : La durée totale (en millisecondes) pendant laquelle le lecteur doit envoyer plusieurs captures d'écran selon la burst_frequency spécifiée.
• burst-frequency : Si burst_duration_ms est spécifié, burst_frequency_ms détermine le nombre de millisecondes entre les captures d'écran.
• scale-factor : Facultatif. Entier, 1-100. 100 = résolution maximale. Le rapport hauteur/largeur est préservé.

Une application personnalisée peut demander des captures d'écran de Broadsign Control Player en envoyant un message XML au port monitor_remote (2324).

<rc version="1" id="1-abcdef" action="screenshot_request" dest_url="https://app.example.com/upload" scale_factor="50" burst_duration_ms="60000" burst_frequency_ms="3000"/>\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="screenshot_request" 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 « Screenshot Request » - 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.

Une application personnalisée peut demander des captures d'écran de Broadsign Control Player API 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-abcdef",
        "action": "screenshot_request",
        "dest_url": "https://app.example.com/upload",
        "scale_factor": “50”,
        "burst_duration_ms": 60000,
        "burst_frequency_ms": 3000
    }
}

Le lecteur répondra avec le document suivant :

{
    "rc": {
        "version": "1",
        "status": "1",
        "action": "screenshot_request",
        "id": "1",
    }
}

Action « Screenshot Request » - 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.