Publish and play an Apple HLS live stream with Wowza Streaming Engine

Configure Wowza Streaming Engine™ media server software to receive an encoded live stream from an HLS-based source and play the live stream over multiple streaming protocols.

Note: Wowza Streaming Engine 4.5.0.01 or later is required.

Before you start


You should complete the following tasks:

1. Configure playback


Before connecting a live source and publishing a live stream, complete the following steps to configure playback support for your application.

  1. Click the Applications tab at the top of the page and then select your application in the contents panel.
  2. Click the Setup tab on your application's page and then click Edit.
  3. Under Playback Types, select any streaming protocols you need to support for playing streams sent to this application. The playback types enable transmuxing a source stream into MPEG-DASH, HLS, RTMP, and RTSP/RTP.
  4. Click Save.

  1. In the application's contents panel, click Playback Security, and then click Edit.


     
  2. Under Client restrictions, select No client restrictions to allow players to connect from any IP address.

  3. Click Save and then restart the application.

For more information about Playback Security options, see Playback security options.

2. Connect to a source stream


This section provides the basic steps for creating a .stream file to publish the encoded live stream to Wowza Streaming Engine.

Notes:
  • Consult your HLS encoder documentation for information about how to configure an outgoing live stream.
  • Wowza Streaming Engine doesn't support query parameters, such as CDN authentication information, in stream URLs.
  1. In Wowza Streaming Engine Manager, click Server in the menu bar, click Stream Files in the contents panel, and then click Add Stream File.

  1. In the Add Stream File dialog box, enter a unique name for the stream file, for example, applehls.stream.
  2. For Stream URI, enter the URI of the HLS source to connect to, making sure it ends with the .m3u8 suffix.

  3. Click Add.

When your source encoder is connected, start the stream.

  1. Click Stream Files in the contents panel and then click the Connect icon for your HLS .stream file.

  1. In the Connect a Stream File dialog box, click the Application Name menu and choose your application.
  2. Click the MediaCaster Type menu and choose applehls.


     
  3. Click OK.

The Connection successful notification displays.

3. Verify the connection


To verify that Wowza Streaming Engine is receiving the published stream, complete the following steps in Wowza Streaming Engine Manager.

  1. Click Incoming Streams in the contents panel for your live application.

    You should see your stream listed with Active for the status.

  2. Click the stream name to see the uptime, network throughput, and other information about the published stream.

4. Test playback


  1. In Wowza Streaming Engine Manager, in the contents panel for your application, click Stream Files.
  2. In the Stream Files list, click the name of your stream file.
  3. From your stream file's page, click Test Playback.
  4. Review and, if needed, edit the following information in the Test Playback window for your stream:
     
    • Server – The IP address or domain name of the server and the streaming port ([address]:[port]).

    Note: The stream name should include the .stream file extension.
  5. (Optional) In the Streaming URLs section, select Secure URL for the streaming protocol you want to use to test playback if you have configured SSL/TLS for streaming over https, rtmps, or rtsps.
  6. Click the Copy icon for the streaming protocol you want to use to test playback.
  7. Paste the playback URL into your player or a mobile browser depending on the protocol. Alternatively, you can use the Wowza Video Test Players webpage.

For more information about playback URLs, see About playing Wowza Streaming Engine streams.

5. (Optional) Debug HLS publishing


If you run into an issue with Wowza Streaming Engine ingesting an HLS live stream, enable the cupertinoMediaCasterDebug property to capture additional information in the logs.
 
Note: The cupertinoMediaCasterDebug property is turned off by default and should only be enabled for troubleshooting. Using it significantly increases the size of log files.
  1. Click the Applications tab and then click the name of your live application (such as live) in the contents panel.
     
  2. On the application page's Properties tab, click Custom in the Quick Links bar.
  3. In the Custom area, click Edit.
     
  4. Click Add Custom Property, specify the following settings in the Add Custom Property dialog box, and then click Add:
     
    • Path - Select /Root/Application/MediaCaster.
       
    • Name - Enter cupertinoMediaCasterDebug.
       
    • Type - Select Boolean.
       
    • Value - Enter true.
  5. Click Save, and then restart the live application to apply the changes.

Next steps


More resources