• How to control which streams get recorded by the nDVR Recorder (DvrRecorderControl)

    The ModuleDvrRecorderControl module for Wowza Streaming Engine™ media server software controls which streams get recorded by Wowza nDVR recorder. It can be used with Wowza Transcoder or any time when you don't need all of the streams to be recorded.

    Note: You can also control which streams get packetized by using ModuleTranscoderControl and which streams get packetized by using ModulePacketizerControl.

    Contents


    Prerequisites
    Installation
    Configuration
    Properties
    Usage
    For developers

    Prerequisites


    Wowza Streaming Engine 4.0.0 or later is required.

    Installation


    1. Download wse-plugin-dvrrecordercontrol.zip.

    2. Extract the contents from the downloaded (zipped) package, and then copy the lib/wse-plugin-dvrrecordercontrol.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 application configuration. See Configure modules for details.

    Name
    Description
    Fully Qualified Class Name
    ModuleDvrRecorderControl Controls which streams are recorded by nDVR. com.wowza.wms.plugin.DvrRecorderControl

    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 dvrRecorderControlSuffixes String * Can be an empty value, a "*", or a comma-separated list of name suffixes such as _source, _720p, _360p, _240p, _160p. The returned value is controlled by the settings of dvrRecorderControlMatchAllow and dvrRecorderControlNoMatchAllow. The suffixes are compared with the end of the stream name. (default: *)
    /Root/Application dvrRecorderControlMatchAllow Boolean true Controls the action taken when a match is found in the list of suffixes. If set to true, then the suffix list is is treated as a list of stream name suffixes that will be recorded. If set to false, then the suffix list is treated as a list of stream name suffixes that will not be recorded. If the list is a *, then this setting will be returned automatically. (default: true)
    /Root/Application dvrRecorderControlNoMatchAllow Boolean false Controls the action taken when no match can be found. If the list is empty, then this setting will be returned automatically. (default: false)

    Usage


    Enable the module and specify which streams you would prefer to be recorded or which you prefer not to be recorded (based on usage of the properties above).

    For Developers


    Source code is available on GitHub.

    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 4.0.6 on 08-11-2014.
    Updated: 09-28-2016.

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