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.

Get a list of SMIL files

View a list of all configured SMIL files associated with an application:

curl -X GET \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/{serverName}/vhosts/{vhostName}/applications/{appName}/smilfiles

View a list of all configured SMIL files associated with an application named testlive.

Note: All examples on this page use the application name testlive. You will replace this with the name of your application.

curl -X GET \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/{serverName}/vhosts/{vhostName}/applications/testlive/smilfiles

Create a SMIL file

Create a SMIL file named mytestsmil:

curl -X POST \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/{serverName}/vhosts/{vhostName}/applications/testlive/smilfiles/mytestsmil \
-d'
{
  "restURI": "http://localhost:8087/v2/servers/{serverName}/vhosts/{vhostName}/applications/testlive/smilfiles/mytestsmil",
  "smilStreams": [{
    "systemLanguage": "en",
    "src": "myfile_750.mp4",
    "systemBitrate": "50000",
    "type": "video",
    "audioBitrate": "44100",
    "videoBitrate": "750000",
    "restURI": "http://localhost:8087/v2/servers/{serverName}/vhosts/{vhostName}/applications/testlive/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/{serverName}/vhosts/{vhostName}/applications/testlive/smilfiles/mytestsmil",
    "width": "640",
    "height": "360"
  }]
}'

Remove a SMIL file

Delete a SMIL file named mysmilefile:

curl -X DELETE \
-H 'Accept:application/json; charset=utf-8' \
-H 'Content-Type:application/json; charset=utf-8' \
http://localhost:8087/v2/servers/{serverName}/vhosts/{vhostName}/applications/testlive/smilfiles/mysmilfile