Use Wowza Player with Wowza Streaming Engine

This article explains how to play streams from Wowza Streaming Engine™ media server software with Wowza Player. To do this, you must use Wowza Streaming Engine Manager to create a streaming application with HLS playback enabled.

Note: Wowza Streaming Engine 4.5.0 or later works best with Wowza Player. 

Configure an application in Wowza Streaming Engine Manager


First, create an application in Wowza Streaming Engine to ingest your stream from the source. Then, configure the application as needed, such as for low latency HLS streaming.
 
  1. In Wowza Streaming Engine Manager, click the Applications tab at the top of the page, and then click Add Application in the contents panel.
     
  2. On the Add Application page, click Live (for live streams), VOD (for on-demand streams), or VOD Edge (for on-demand content provided by a Media Cache source).
     
  3. In the New Application dialog box, enter a name for your application, and then click Add.
     
  4. With its default settings, your application can deliver a stream to Wowza Player. Note that under Playback Types, the Apple HLS playback type is selected by default. This is required and you shouldn't change this setting.

    We recommend that you keep the Cross-origin resource sharing (CORS) (for HTTP-based streams) option selected.
     
    Note: Instead of creating new streaming applications, you can use the default live application (named live) or the default on-demand application (named vod), which are included in default Wowza Streaming Engine software installations.
  5. (If desired) for lower-latency HLS streaming, configure the application to handle smaller chunk sizes. See Improve playback of lower-latency Apple HLS streams from Wowza Streaming Engine.

Set up the video source for your streaming application


To set up source video from a camera or encoder for your live streaming application, follow the instructions in Connect a live source to Wowza Streaming Engine.

To set up source video for a video-on-demand (VOD) streaming application, copy your encoded video files to your VOD application's content directory. If you didn't change any of the application's default values, upload the files to the content folder in the Wowza Streaming Engine installation directory ([install-dir]/content). If you changed the application's Content Directory setting to an application-specific directory (${com.wowza.wms.context.VHostConfigHome}/content/[application-name]) or to a fully customized location on the media server, upload the files to these alternate locations.

To set up a source video for your VOD edge streaming application, follow the instructions in Scale video-on-demand streaming with Wowza Streaming Engine Media Cache to configure the Media Cache feature and upload the encoded video files to your Media Cache source.

Important: To work with Wowza Player, your encoded live streams and files must use H.264 video and HE-AAC (v1/2) or LC-AAC (v1/2) audio.

Play the HLS stream in Wowza Player Builder


After your live stream is running or your encoded files are uploaded to your VOD application's content directory, enter your stream's playback URL in Wowza Player Builder.
  1. Sign in to Wowza Player Builder with your Wowza account.
  2. On the Source Stream Information tab, enter a valid License Key. For licensing details, see Access Wowza Player.
  3. Enter your stream's playback URL in the Source Stream field. For more information, see Create a custom Wowza Player with Wowza Player Builder.
  4. Click Update Preview and then click the Play button to test stream playback. 

Control the Wowza Player connection to Wowza Streaming Engine


You can control the Wowza Player connection to Wowza Streaming Engine applications using the player IP address. By default, connections from any IP address are allowed. For more information about configuring the Client Restrictions options that enable you to control which IP addresses players can connect from, see Playback Security.

Enable DVR (seek) capability for live streams in Wowza Player


DVR capability enables your viewers to pause/resume playback of live streams and rewind backward in the live stream/fast-forward to current live playback point. To support this feature in Wowza Player, you must enable and configure nDVR technology in Wowza Streaming Engine. For more information, see Set up and run Wowza nDVR in Wowza Streaming Engine.

Manage redundant HLS live streams in Wowza Player


If your application is delivering a live stream via the Stream Targets feature to Wowza CDN or Akamai, you can configure the stream target to send a redundant stream with redundant chunklists. This means that each bitrate rendition has a duplicate within the playlist. In the event of failure of the primary stream chunklist of a certain bitrate rendition, Wowza Player switches to the backup stream chunklist of the same bitrate rendition.

To configure a redundant stream in Wowza Streaming Engine, set Destination Server to redundant for a Wowza CDN stream target configuration or select Send To Backup Server for an Akamai stream target configuration. For more information about the Stream Targets feature, see Use CDNs and services to distribute live streams from Wowza Streaming Engine

Wowza Player doesn't require configuration to enable playback for redundant streams. However, you can use the onChunklistURIChanged method in the Wowza Player JavaScript API to listen for events when the player switches between a primary chunklist and a backup chunklist within a redundant stream.

More resources