Player Internet Connection Status Plugin
Requires Players 10.1 or higher
Only available at selected plans
This player plugin continuously monitors the player's internet connectivity and updates Player Attributes with the connection status in real-time.
This plugin uses two attributes:
Player Internet Status: A text attribute that uses the values "online" and "offline" to indicate the current status.
Player Connectivity Status: A numeric attribute that assigns "1" when the player is online and "0" when offline.
This functionality can be particularly useful for restricting the playback of a specific item, like a streaming content to, only when the player is actually online (i.e., only play this streaming when the player attribute value is "1").
How to create and configure the Connection Status Plugin
First, let’s create a new Player Plugin. On your Content page, click New > Player Plugin > Player Plugins.
Select the Player Internet Connection Status plugin.
Enter a name and create a new player attribute to link with the player plugin. Check this link to learn how to create Player Custom Attributes.
This plugin allows connecting two App Attributes:
One of them, called Player Internet Status, is a text attribute. It uses the values “online” and “offline”.
The other attribute, called Player Connectivity Status, is numeric. It uses 1 for online and 0 for offline. For this tutorial, we will be using the Player Internet Status. Click on it select your player attribute and click on Save.
Adding the Connection Status Plugin to a player
This follows the same process, as adding any plugin to a player, or player group. Here are the steps:
Go the the player, or player group where the plugin will be added
Click on the "plugins menu"
Click the orange button "Add Plugin
Find the plugin you have created on the previous step
Select the Plugin and Save
Now the player plugin added will be listed on the Plugins page:
Creating Playback restriction rules based on the Connectivity Status Plugin?
Restrictions are a staple of the content programming. You can set restrictions:
When Publishing;
To items in a Playlist;
On an item in a Campaign Timeline;
As a general restriction on a piece of content.
Thinking of a scenario in which we have a YouTube video app that works as a streaming, we would only want that app to be displayed on the screen if the Connectivity Status attribute is “online”.
When editing a playlist, to add a restriction to the YouTube app, we need to click on the clock icon;
Then we select the option “Play only when…”
Select the Connectivity Status Player Attribute we have previously created as a player attribute.
Then we set it to only play when its value is “online”. Click on Done and Ok.
After clicking on Save on the playlist page, it’s all done!
Now the YouTube app will only be played when the device is connected to the internet.