Skip to main content

Creating a playlist

It is very simple to create a playlist from the Ant Media Server dashboard by following a set of steps. So let's get started 🙂

VoD files​

To create a playlist, we need to have a set of VoD files that will be used as playlist items. Therefore, as the first step, we will upload some VoD files to the Ant Media Server.

Login to your Ant Media Server Dashboard​

Login to your Ant Media Server Web Panel/dashboard. The URL is like this: https://YOUR_ANT_MEDIA_SERVER:5443/

image.png

Accessing the Application​

  • Navigate to your preferred application from the left side. For this demonstration, we are using the LiveApp application.
  • Once you are in the LiveApp application, go to the VoD section.

image.png

Uploading the VoD files​

Using Web Panel​

Now we can upload the VoD files that we want to stream with the playlist.

  • Click on the Upload VoD tab and then click on Choose File to select the files you want to upload. For this demonstration, I will upload three VoD files.

image.png

info

Furthermore, uploading MP4 files to your Ant Media Server is optional. Ant Media Server can retrieve MP4 files from any location. You simply need to ensure that the file URL is accessible to AMS.

Using REST API​

You can upload MP4 files to Ant Media Server using the REST API with the following API call:

curl -X POST -F "file=@<YOUR-FILE-PATH>;type=video/*" https://AMS_URL:5443/APP-NAME/rest/v2/vods/create?name=YOUR-FILE-NAME.mp4

Here is the curl sample:

curl -X POST -F "file=@test.mp4;type=video/*" http://localhost:5080/WebRTCAppEE/rest/v2/vods/create?name=test.mp4

The uploaded file will be located in antmedia/webapps/APP-NAME/streams directory. The MP4 file name will be changed to a random VOD ID, which you can find in the VOD section of the web panel application page.

You can use the Get VOD list rest API call to get the VOD file list from the database.

You can access the uploaded VOD file through the below URL format:

http(s)://domain_or_IP:Port/AppName/streams/VOD-ID.mp4

Example:

http://localhost:5080/WebRTCAppEE/streams/722484094956241856650105.mp4

Creating the Playlist​

Now that we have the VoD files ready, we will create the playlist with these VoD files as the playlist items.

  • Go to the Live Streams section, click New Live Stream, and then select Playlist from the drop-down menu.

image.png

  • Name your playlist, and click on Add Playlist Item. Under the dropdown menu, there are two options.
  1. Add URL Directly
  2. Add From VODs

add-playlist-item-01

  • Let's discuss both options and you can use any of these options based on your convenience.

Add URL Directly​

If you have the VoD URL handy or are adding external VoDs, you can use this option.

Get the VoD URL​

  • The sample path of a VoD file uploaded to the Ant Media Server VoD section is like http(s)://ams-server-url:Port/LiveApp/streams/vod_id.mp4

  • To get the VOD URL, click on the hamburger icon, which is located on the right side of the screen, and then click Copy VoD URL

copy-vod

  • Now we have the VoDs accessible through the links below.
http://localhost:5080/LiveApp/streams/044283659243035008593467.mp4
http://localhost:5080/LiveApp/streams/127700726123231884567831.mp4
  • Add all the playlist items and then click Create.

  • The stream Id field is not mandatory but you can put your streamId.

Screenshot

  • The playlist is created and it is offline by default.

  • Click on the Start Broadcast to start streaming of the playlist.

start-playlist

  • Congratulations! The playlist is successfully created and running.

playlist-streaming

Add From VODs​

This option is more useful if all the VoD files you want to stream are on your Ant Media Server itself under the VoD section.

add-from-vod

  • You can search for the uploaded VoD items with their name or VOD Id and click on the Add option.

seraching-vods

  • After you have added all the VoD files, click Create.

vods-added

  • The playlist is created and it is offline by default.

created-playlist

  • Playlist length shows the overall duration of the playlist with the added items.

  • You can edit the playlist and the items as needed.

edit-playlist

  • Click on the Start Broadcast to start streaming of the playlist.

start-playlist

  • Congratulations! The playlist is successfully created and running.

playlist-streaming

Scheduling Playlist​

Starting from Ant Media server version 2.10.0, you can schedule your playlist to start at any time in advance with the Schedule to Start Automatically option and control the start of your playlist according to your schedule.

  • This can be set at both times: When creating the playlist as well as after the playlist is created.

schedule-while-creating

  • Click Schedule to Start Automatically, and choose the date from the calendar.

choose-date

  • Set the exact time when you want the playlist to be started and save.

choose-time

important

Please make sure that your server time is in sync with the NTP.

  • At the scheduled time, your playlist will start :)

playlist-scheduled

Optimizing Playlist for Better Playback Experience​

Now that we have learned how to create a playlist, let's make some configurations to optimize the playlist for a better playback experience.

  • Go to the Settings section of the application and scroll down.

image.png

  • Uncheck the Delete HLS files after the stream is finished as this setting will preserve the HLS files after the stream has ended.

image.png

  • Scroll to the bottom and Click the Save button to save the changes.

  • Scroll to the top and choose the settings mode from Basic to Advanced

image.png

  • Find hls flags and change its value to delete_segments+append_list+omit_endlist

image.png

  • Save the changes and start/restart the playlist to apply the changes.