How to 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 Apple HLS playback enabled.

Notes:
  • Wowza Streaming Engine 4.5.0 or later works best with Wowza Player. 
     
  • Wowza Player supports playback of streams protected with SecureToken. For more information, see How to protect streaming using SecureToken in Wowza Streaming Engine.
  • You can use Streaming Engine Manager with the latest versions of most web browsers that support HTML5 and Cascading Style Sheets level 3 (CSS 3). We recommend the Google Chrome browser.

Contents


Configure an application in Wowza Streaming Engine Manager
Set up a media source for your streaming application
Play the stream in Wowza Player Builder
Control the Wowza Player connection to Wowza Streaming Engine
Enable DVR (seek) capability for live streams in Wowza Player
More resources

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 Apple 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.

    To avoid potential issues, we recommend that you leave the Cross-origin resource sharing (CORS) (for HTTP-based streams) option selected as well.
     
    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 Apple HLS streaming, configure the application to handle smaller chunk sizes. See How to improve playback of lower-latency Apple HLS streams

Set up a media source for your streaming application


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

To set up source video for your 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 ([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 How to scale video on demand streaming with 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 stream in Wowza Player Builder


After your live stream is running (or your encoded files are uploaded to your VOD application's content directory), send your stream's playback URL to Wowza Player Builder.
 
Note: This step uses the Wowza Player that's integrated with Wowza Streaming Engine Manager in Wowza Streaming Engine 4.6.0 and later for live and VOD applications and Wowza Streaming Engine 4.7.0 and later for VOD Edge applications.
  1. In Wowza Streaming Engine manager, click the application name in the contents panel, and then click Wowza Player.


     
  2. In the Wowza Player page, specify an Apple HLS stream to send to Player Builder. If you have configured your media server with an SSL certificate, you can select either HTTP or secure HTTP streaming (HTTPS) versions of your published live stream or on-demand playback URLs in the live or VOD Wowza Player page. Wowza provides free 256-bit SSL certificates to users with Perpetual and Subscription licenses via the Wowza StreamLock™ AddOn. If your Wowza Streaming Engine host server address is null, you have to enter the media server's IP address in Stream Source (HLS) in Wowza Player Builder.

    Live applications

    Select the playback URL for an incoming stream that's published to this application in Select a playback URL or enter a live stream Apple HLS playback URL in Enter a playback URL. A basic Apple HLS should have the following format:
     
    http://[wowza-ip-address]:1935/[live-application-name]/[live-stream-name]/playlist.m3u8

    If your application is delivering a live stream via the Stream Targets feature to a CDN, and if that CDN provides an Apple HLS playback URL, you can enter that URL in Enter a playback URL. For more information about the Stream Targets feature, see How to use CDNs and services to distribute live streams (push publishing). If your application is delivering a live stream that's transcoded to multiple output renditions, you can enter the Apple HLS URL for the SMIL file or Stream Name Group that describes the adaptive bitrate stream in Enter a playback URL. For more information about adaptive bitrate (ABR) streaming and creating a playback URL for an ABR stream, see How to create and play SMIL files with streams created by Wowza Transcoder or Adaptive bitrate streaming with Stream Name Groups.
     
    Note: You can find your Apple HLS stream URL on the Mobile tab in the Test Players window.

    VOD applications

    Select a Host server and enter the details for your video source file asset in File Path. A preview of the URL that will be passed to Player Builder is shown next to Result. The file path for your source file is composed of a media type prefix, the relative file path from [installdir]/content, the file name, and file extension. For more information on media type prefixes, see Supported media file formats. The File Path for your source file varies based on the file location and if you're steaming an adaptive bitrate set of files:
     
    To stream sample.mp4 from the default content folder, enter sample.mp4 in File Path. If a file path in a playback URL doesn't include a media type prefix, Wowza Streaming Engine adds the mp4: prefix to that file path. You don't have to specify a media type prefix when streaming mp4 files.
    http://[wowza-ip-address]:1935/vod/_definst_/sample.mp4/playlist.m3u8
    To stream other types of media files from the default content folder, enter the media type prefix and the full file name in File Path.
    http://[wowza-ip-address]:1935/vod/_definst_/flv:sample.flv/playlist.m3u8
    To stream an adaptive bitrate set of files in the default content folder using a SMIL file, enter the SMIL file name with the smil: media prefix in File Path.
    http://[wowza-ip-address]:1935/vod/_definst_/smil:myStream.smil/playlist.m3u8
    To stream sample.flv from [install-dir]/content/myVideos, enter flv:myVideos/sample.flv in File Path. Place the media type prefix before the full file path when the source media file is in a subfolder of the default content folder. If you're streaming a video file from a subfolder in [install-dir]/content, place the media type prefix before the full file path and always keep the application instance name (_definst_ by default) in your playback URL.
    http://[wowza-ip-address]:1935/vod/_definst_/flv:myVideos/sample.flv/playlist.m3u8

    VOD Edge applications

    Select a Host server and a Media Cache Prefix, and enter the details for your video source file asset. A preview of the URL that will be passed to Player Builder is shown next to Result. The file path for your source file is composed of a media type prefix, the relative file path from [installdir]/content, the file name, and file extension. For more information on media type prefixes, see Supported media file formats. The File Path for your source file varies based on the file location and if you're steaming an adaptive bitrate set of files:

    To stream sample.mp4 from a Media Cache source with the prefix http/, enter sample.mp4 in File Path. You don't have to specify a media type prefix when streaming mp4 files.
    http://[wowza-ip-address]:1935/vod/_definst_/http/sample.mp4/playlist.m3u8
    To stream other types of media files from a Media Cache source with the prefix http/, enter the media type prefix and the full file name in File Path.
    http://[wowza-ip-address]:1935/vod/_definst_/http/flv:sample.flv/playlist.m3u8
    To stream an adaptive bitrate set of files from a Media Cache source with the prefix http/, enter the SMIL file name with the smil: media prefix in File Path.
    http://[wowza-ip-address]:1935/vod/_definst_/http/smil:myStream.smil/playlist.m3u8
    To stream sample.flv from a Media Cache source with the prefix http/, enter flv:myVideos/sample.flv in File Path.
    http://[wowza-ip-address]:1935/vod/_definst_/flv:myVideos/sample.flv/playlist.m3u8
  3. Click Launch Player Builder to open the Player Builder webpage. Your stream's playback URL is automatically copied into Stream source (HLS) in the Player Builder settings. Click Update Preview to test stream playback. For more information about creating a customized player, see Creating a custom Wowza Player with Wowza Player Builder.
     
    Note: If you're using the Google Chrome browser and the Player Builder webpage doesn't launch when you click Launch Player Builder, you may have to allow pop-ups for Wowza Streaming Engine Manager. Click the Pop-ups blocked icon on the right side of the browser window address bar, and then either click the Wowza Player URL or select Always allow popups from http://[wowza-ip-address]:8088, click Done, and then click Launch Player Builder again.

Control the Wowza Player connection to Wowza Streaming Engine


You can control the Wowza Player connection to your 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 media server software. For more information, see How to set up and run Wowza nDVR for live streaming.
 
Note: Currently, the Wowza Streaming Cloud live-streaming service doesn't provide DVR capability for live streams.

More resources


How to find your way around Wowza Streaming Engine Manager
How to get started with Wowza Player
How to customize video quality choices for adaptive bitrate streams in Wowza Player
How to use a specific version of Wowza Player