Manage SMIL files by using the Wowza Streaming Engine REST API

Use the Wowza Streaming Engine™ media server software REST API to view, create, and remove Synchronized Multimedia Integration Language (SMIL) file configurations in a Wowza Streaming Engine instance.

Notes:

• Wowza Streaming Engine 4.3.0 or later is required.
   
• PHP examples for the tasks in this article are available in the tests folder of the PHP REST Library for Wowza Streaming Engine on GitHub.
• Reference documentation for the Wowza Streaming Engine REST API is available by using OpenAPI (Swagger), which you can download and install locally. See Access reference documentation for the Wowza Streaming Engine REST API.

Contents

Get a list of SMIL files

View a list of all configured SMIL files associated with an application (live in this example):

curl -X GET \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/_defaultServer_/vhosts/_defaultVHost_/applications/live/smilfiles

Create a SMIL file

Create a SMIL file (mytestsmil in this example) for an application (live in this example):

curl -X POST \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/_defaultServer_/vhosts/_defaultVHost_/applications/live/smilfiles/mytestsmil \
-d'
{
  "restURI": "http://localhost:8087/v2/servers/_defaultServer_/vhosts/_defaultVHost_/applications/live/smilfiles/mytestsmil",
  "smilStreams": [{
    "systemLanguage": "en",
    "src": "myfile_750.mp4",
    "systemBitrate": "50000",
    "type": "video",
    "audioBitrate": "44100",
    "videoBitrate": "750000",
    "restURI": "http://localhost:8087/v2/servers/_defaultServer_/vhosts/_defaultVHost_/applications/live/smilfiles/mytestsmil",
    "width": "640",
    "height": "360"
  }, {
    "systemLanguage": "en",
    "src": "myfile_1100.mp4",
    "systemBitrate": "50000",
    "type": "video",
    "audioBitrate": "44100",
    "videoBitrate": "1100000",
    "restURI": "http://localhost:8087/v2/servers/_defaultServer_/vhosts/_defaultVHost_/applications/live/smilfiles/mytestsmil",
    "width": "640",
    "height": "360"
  }]
}'

Remove a SMIL file

Delete a SMIL file (mysmilefile in this example):

curl -X DELETE \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/_defaultServer_/vhosts/_defaultVHost_/applications/live/smilfiles/mysmilfile