How to 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 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 enables you to 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 SMIL file paths that will 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


Source code is available on GitHub.

Wowza Media Systems™ provides developers with a platform to create streaming applications and solutions. See Wowza Developer Tools to learn more about our APIs and SDK.

More resources



Wowza media server software and all components, including modules, source code, and other related items offered on this page, are copyrighted (c) 2006-2016 by Wowza Media Systems, LLC, all rights reserved, and are licensed pursuant to the Wowza Media Software End User License Agreement.
Originally Published: For Wowza Streaming Engine on 09-16-2014.
Updated: 05-17-2016.
 

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