Use Wowza Player with Wowza Streaming Cloud

This article explains how to play streams from the Wowza Streaming Cloud™ service with Wowza™ Player.

Add a live stream


Follow the basic instructions to add a live stream in Wowza Streaming Cloud, paying attention to the following settings:
 
  1. On the Video Source and Transcoder Settings page, you must specify the following options to add a live stream that Wowza Player can play:
     
    • Specify the Delivery Protocol option Apple HLS over HTTPS to play the stream in Wowza Player. This enables Wowza Streaming Cloud to generate a proper playback URL for the player.
       
    • Set the closed-captions option to None, even if your live stream has captions. Unexpected results may occur if you choose one of the closed-captions options.
  2. On the Playback Settings page, select Wowza Player as the player that you want to use.

If you can't select Wowza Player, this means that the Delivery Protocol and/or closed-captioning option isn't set correctly on the Video Source and Transcoder Settings page. Click Back to correct these settings if needed.

  1. On the Hosted Page Settings page:
     
    • To have Wowza Streaming Cloud host your live stream in Wowza Player, select Yes and then customize the appearance of the page.
       
    • To host your live stream in Wowza Player on your own website, select No.
  2. On the Review Settings page, review your choices. If necessary, click Back or click the Live Stream Setup, Video Source and Transcoder Settings, Playback Settings, or Hosted Page Settings icons to edit your selections. Click Finish when your settings are correct.

Control playback with Wowza Player and Wowza Streaming Cloud


You can control playback with Wowza Player and Wowza Streaming Cloud using geo-blocking or token authorization. Geo-blocking allows you to selectively allow or block access to Wowza stream targets to control where a stream can be viewed. Token authorization protects streams by requiring a token, which is hashed and appended to the playback URL, for viewer access. For more information, see Security features in Wowza Streaming Cloud.

Configure a redundant stream


You can optionally configure your live stream to send a redundant HLS 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 Cloud, enable the Redundant chunklists stream target property for the stream target associated with your live stream. See Edit an HLS stream target's properties for more information.

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.

Note: Redundant stream playback is available using Wowza Player Builder with an Apple HLS playback URL from Wowza Streaming Cloud, but it is not currently available with playback using the HTML5 player automatically configured with a live stream in Wowza Streaming Cloud.

Set up your live video source


Once your live stream is added to Wowza Streaming Cloud, configure your IP camera or other source encoder to connect to Wowza Streaming Cloud. For details, see Prepare and Connect Video Sources.
 
Important: Wowza Streaming Cloud accepts MP3-encoded audio but Wowza Player does not. To work with Wowza Player, you must encode your Wowza Streaming Cloud source stream using H.264 video and HE-AAC (v1/2) or LC-AAC (v1/2) audio.

Configure your playback setup


Next, configure the player and the webpage that hosts your live stream. In Wowza Streaming Cloud, select the stream on the Live Streams page and do one of the following:
 
  • If you're hosting your own Wowza Player, under Direct Playback URLs, copy the Apple HLS URL into the Source URL (HLS) field in Wowza Player Builder.
     
  • If you're using a Wowza Streaming Cloud-hosted page for video playback, give your viewers the Hosted Page URL so they can watch the event in the Wowza Player player.

Start streaming


Start your stream in Wowza Streaming Cloud and in your video source. For details, see Start streaming.

More resources