How to play video on Apple iOS devices (Apple HLS)

This article describes how to play a video-on-demand (VOD) or live stream from Wowza Streaming Engine™ media server software on Apple iOS devices.

Play a VOD .mp4 file on iOS


This section describes how to play the default [install-dir]/content/sample.mp4 video file from an application named vod. If your video file has a different name or if you're streaming from an application that has a different name, substitute those values in the sample URLs.

For details about how to create a Wowza Streaming Engine application for streaming VOD content to all supported player technologies, see Set up video-on-demand streaming in Wowza Streaming Engine.

Enter the following URL into Safari on the iOS device:

http://[wowza-ip-address]:1935/vod/mp4:sample.mp4/playlist.m3u8

This stream can also be played by using Safari or QuickTime 10.x on a computer that's running OS X 10.6 or later.

The test players in Wowza Streaming Engine Manager are preconfigured to play the default sample.mp4 video file. On the VOD application page, click the Test Players button in the upper-right corner. In the Test Players window, on the Mobile tab, verify the Server and Media File Name information and then enter the iOS mobile streaming URL into Safari on the device.

To play your own content, copy it to the server [install-dir]/content folder and substitute its file name in place of sample.mp4 in the Media File Name box.

To send the URL to an email application on the device, enter your email address in Send These Links To Me and then click Email Me.

Note: In Wowza Streaming Engine, MP4 is the default stream format and you're not required to use the mp4: stream name prefix to play the sample video file. For example:
 
http://[wowza-ip-address]:1935/vod/sample.mp4/playlist.m3u8

In Wowza Media Server™ 3.x, however, the default stream format is FLV and you must use the mp4: stream name prefix to play the sample video file. For example:

http://[wowza-ip-address]:1935/vod/mp4:sample.mp4/playlist.m3u8
 

To play content that's not in the content root folder ([install-dir]/content), add the default application instance name to the playback URL. For example, if the sample.mp4 video file is in [install-dir]/myVideos/sample.mp4, the playback URL is:

http://[wowza-ip-address]:1935/vod/_definst_/myVideos/mp4:sample.mp4/playlist.m3u8

Play a live stream on iOS


This section describes how to play a live stream named myStream from an application named live. If your live stream has a different name or if you're streaming from an application that has a different name, substitute those values in the sample URLs.

For details about how to send a stream from your encoder to Wowza Streaming Engine, see one of these tutorials:

Enter the following URL into Safari on the iOS device:

http://[wowza-ip-address]:1935/live/myStream/playlist.m3u8

This stream can also be played by using Safari or QuickTime 10.x on a computer that's running OS X 10.6 or later.

Wowza Streaming Engine Manager includes test players that are preconfigured to play a live stream named myStream. On your live application page, click the Test Players button in the upper-right corner. In the Test Players window, on the Mobile tab, verify the Server and Stream information and then enter the iOS mobile streaming URL into the Safari web browser on the device.

If your live stream has a different name, use it instead of myStream in the Stream box.

To send the URL to an email application on the device, enter your email address in Send These Links To Me and then click Email Me.


If you're having problems or want to discuss this article, post in our forum.