Use different locations for SMIL files and VOD assets (MediaListPathSelector)

When you use Synchronized Multimedia Integration Language (SMIL) files to define adaptive bitrate (ABR) streams, the video-on-demand (VOD) assets normally must be stored in the same folder as the SMIL file that references them. The ModuleMediaListPathSelector module for Wowza Streaming Engine™ media server software lets you store a SMIL file and the VOD assets it references in different locations.

Contents


Prerequisites
Installation
Configuration
Properties
Usage
For developers
More resources

Prerequisites


Wowza Streaming Engine 4.0.0 or later is required.

Installation


  1. Download wse-plugin-pathselector.zip.
     
  2. Extract the contents from the downloaded (zipped) package, and then copy the lib/wse-plugin-pathselector.jar file from the package to the lib folder in your Wowza Streaming Engine installation ([install-dir]/lib).
     
  3. Restart Wowza Streaming Engine.

Configuration


To enable this module, add the following module definition to your VOD application configuration. See Configure modules for details.

Name
Description
Fully Qualified Class Name
ModuleMediaListPathSelector Controls MediaList paths. com.wowza.wms.plugin.pathselector.ModuleMediaListPathSelector

Properties


After enabling the module, you can adjust the default settings by adding the following properties to your application. See Configure properties for details.

Path
Name
Type
Value
Notes
/Root/Application pathSelectorPrefixes String http/,myContent/ The file paths for the media assets referenced in the SMIL file to be checked, in a comma-separated list. (default: not set)

Usage


With VOD applications, when a SMIL file is read by Wowza Streaming Engine, the SMIL file location is prepended to all of the content paths defined in the SMIL file. This works if the referenced content is stored in the same folder as the SMIL file or in a subfolder below the folder that has the SMIL file.

Use this module in situations where the referenced content and SMIL file are stored in different directory paths or where the content is stored in a folder above the SMIL file folder in the same path. When the content files are processed, this module checks the path against the pathSelectorPrefixes property value and removes any prepended prefixes that match so the original content path defined in the SMIL file is used.

For developers


  • Get the source code on GitHub

More resources