• 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


    How to do adaptive bitrate streaming
    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.