Use Wowza Player with Wowza Streaming Cloud

Wowza Player is sunset and should only be used with existing Ultra-Low Latency (ULL) streams until that technology is also sunset.

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

Note: When using token authorization to play Wowza Streaming Cloud streams in Wowza Player, you must include the withCredentials Player configuration property in your player embed code and set its value to true. See Customize Wowza Player with configuration properties for more information.

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.

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 Playback URLs, copy the HLS URL into the Source Stream 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