The ModuleDuplicateStreams module for Wowza Streaming Engine™ media server software enables you to duplicate a stream from one application instance to another instance on the same Wowza Streaming Engine server.
Contents
Prerequisites
Installation
Configuration
Properties
Usage
For developers
Prerequisites
Wowza Streaming Engine 4.0.0 or later is required.
Installation
- Download wse-plugin-duplicatestreams.zip.
- Extract the contents from the downloaded (zipped) package, and then copy the lib/wse-plugin-duplicatestreams.jar file from the package to the lib folder in your Wowza Streaming Engine installation ([install-dir]/lib).
- 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
|
ModuleDuplicateStreams | Duplicates streams to another application instance. | com.wowza.wms.plugin.ModuleDuplicateStreams |
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 | duplicateStreamsStreamNames | String | * | A comma-separated list of stream names. Use the wildcard (*) character by itself to indicate all streams will be duplicated or to substitute for characters at the beginning or end of stream names. For example: *_720p,*_360p,*_240p,*_160p. (default: *) |
/Root/Application | duplicateStreamsTargetVHostName | String | _defaultVHost_ | Name of target virtual host (VHost). (default: _defaultVHost_) |
/Root/Application | duplicateStreamsTargetAppName | String | [application-name]/_definst_ | Name of the target application/application instance. |
/Root/Application | duplicateStreamsStreamNameSuffix | String | _dest | Suffix to add to the stream name on the target application instance. Set to an empty string to have the same name published on the target. (default: _dest) |
Usage
When a stream is published to the configured application, the stream name is checked against the values in the duplicateStreamsStreamNames property, and if a match is found, the stream is re-published to the application specified in duplicateStreamsTargetAppName. When the source stream is unpublished, the duplicate stream is also shut down.
For developers
- Get the source code on GitHub