Local Web API

Local Web API is a simple way to integrate outside devices and trigger Content on the Player through a local network HTTP call.

The Local Web API is supported by OnSign TV on Android, Windows, Linux, Mac, and BrightSign Players.

Important: To use the Local Web API this option must be enabled in the Player settings.

 

Local Web API for Android Player 9.8.5

Endpoint Method Meaning

http://127.0.0.1:5544/trigger/{pattern}

POST

Triggers the play of a campaign or a Playlist which is configured with an interactivity containing the pattern {pattern}.

http://127.0.0.1:5544/campaign/current/stop

POST

Stops the current content playing, skipping to the next one in the loop.

http://127.0.0.1:5544/attribute/{name}/{value}

PUT

Sets the attribute {name} with the value {value}.

http://127.0.0.1:5544/attribute/{name}

GET

Retrieves the attribute named {name} as JSON, in the format {"name": "attr_name", "value": "attr_value"}. If no value is set for this attribute or attribute doesn't exist, returns {"name": "attr_name", "value": null}.

http://127.0.0.1:5544/attributes

GET

Retrieves list of all attributes currently set as JSON, in the format {"attributes": [{"name": "attr_name", "value": "attr_value"}]}. If no value is set for an attribute, it is not listed.

Local Web API for Windows/Mac/Linux Player 9.3.9:

Endpoint Method Meaning

http://127.0.0.1:5544/trigger/{pattern}

GET, POST

Triggers the play of a campaign or a Playlist which is configured with an interactivity containing the pattern {pattern}.

http://127.0.0.1:5544/campaign/current/stop

GET, POST

Stops the current content playing, skipping to the next one in the loop.

http://127.0.0.1:5544/playback/status

GET, POST

Retrieve the playback status as JSON, in the format {"visible": true, "playing": true}.

http://127.0.0.1:5544/playback/show

GET, POST

Shows the Player window. If window is already visible, nothing happens.

http://127.0.0.1:5544/playback/hide

GET, POST

Hides the Player window. Playback still happens in the background.

http://127.0.0.1:5544/playback/start

GET, POST

Starts playing content. If content is already playing, nothing happens.

http://127.0.0.1:5544/playback/stop

GET, POST

Stops playing content. Displays a black screen until playback is resumed.

OnSign TV Academy - Keyboard and Local Network Interacticity