Player configurations consist of the following categories:
- General
- Appearance
- Plugins
The Player Configuration Details page reference article contains all of the configuration options and definitions available to configure your player.
1. Add a new player
To create a new player configuration:
- Click Configurations under Players on the navigation.
- Click New Player on the Players list.
2. Set the general settings
Besides the name of the player configuration, the other general settings are optional. Configure the options you want the player to have.
- Set the name for the player configuration. This name will help you distinguish between your configuration and what you use them for.
- Select a Preload configuration from the drop-down menu.
- Select a Starting quality from the drop-down menu.
- Check any Playback options you want the player to have.
- Add any restricted hostnames to prevent access to the stream.
See More about hostname restrictions below. - Select an Ad Schedule from the drop-down menu.
See More about ad schedules below. - Click Continue.
More about hostname restrictions
You can secure your player configuration from being embedded in non-authorized sites by adding hostname restrictions.
Note: The hostname should be written without protocol or port and should not include the path to a specific page. If your content is accessible with both a www.domain.com and a domain.com url, you need to enter both versions.
Note: If you would like to allow all subdomains, you can enter *.domain.com to allow domain.com as well as all subdomains (hosts) of domain.com such as www.domain.com, web.domain.com, sub.domain.com.
Examples of good hostnames are:
flowplayer.com play.flowplayer.com embed.cnn.com comcast.com *.domain.com localhost my.very.own.hostname.org
Examples of incorrectly specified hostnames are:
http://play.flowplayer.com //embed.cnn.com embed.cnn.com:8888 localhost:5000 localhost:80 https://comcast.com/page http://my.very.own.hostname.org my.hostname.org/page
Note: If you want to allow the share links/iframes to work in a restricted player, you must allow
embed.wowza.com
in the host restrictions.
More about ad schedules
If you want to programmatically override the ad configuration that's configured, you can do that using the JavaScript embed. An example of how it might look is below.
<div data-player-id="cdcc4202-ef0b-4e03-a43a-d1fcf6d83157"> <script src="//cdn.flowplayer.com/players/ffdf2c44-aa29-4df8-a270-3a199a1b119e/native/flowplayer.async.js"> { "src": "f576651c-4cc6-4664-84fa-bb3b35ef1aba", "ima": { "ads": [{ "time": 0, "adTag": "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1&cust_params=deployment%3Ddevsite%26sample_ct%3Dskippablelinear&correlator=" }] } } </script> </div>
In the sample code above:
- data-player-id="<player id>" identifies the skinning and behavior configuration you created. You can see the ID in the page URL when selecting a player design.
- //cdn.flowplayer.com/players/<site id>/native/flowplayer.async.js is the URL of the hosted player script, specific to your site.
- "src": "<videoid>" contains the Flowplayer video ID, if it’s a remote asset, or "src": "//edge.flowplayer.org/bauhaus.m3u8" is the URL to the video stream/file.
See Get started with advertising in Wowza Video for more information.
3. Set the appearance
Under the Appearance tab set the appearance of the player:
- Select the Play icon design.
- Select the Control bar design.
- Select the Color for the color player interface elements using HEX format.
- Check the Buttons you want to be visible on the control bar.
- Check any Metadata you want to display like the asset's title and/or description.
- Select a Language for used in the player UI.
- Click Continue.
4. Set the plugins
Plugins are used to add more features and functionality to the player. For some plugins, you simply add them to the player to set them. With other plugins, you can further configure them.
To add a plugin:
- Click Add plugin on the Plugins tab.
- Review the selection of plugins.
- Click Add plugin for the plugin you want to add. The plugin displays under Selected plugins.
- If there is an Open config drop-down on the plugin, click it, then complete the configuration. Click Close config.
- Repeat steps 1-4 as needed.
- Click Create player.
See Player configuration setup page in Wowza Video for more information about each available plugin.