Wowza Media Server Pro Examples: MediaCaster Stream Manager

Description

This package provides a Flash tool to interface with the MediaCasterStreamManager API. This to tool is used to start and stop the publishing of non-pushed based encoder streams such as Native RTP, MPEG-TS and SHOUTcast. It provides greater control over the publishing and recording process when using these encoder technologies. This tool is designed to work with the live, live-lowlatency and liverepeater-origin stream types rather than the MediaCaster stream types (rtp-live[-*] and shoutcast[-*]). The MediaCasterStreamManager API can also be accessed using the JMX/JConsole interface to the server. The MediaCasterStreamManager interface is available in JConsole in the MBean tab in the application folder of the application you wish to control.

To install

1. Upgrade to Wowza Pro 1.6.0-patch17 or greater (Development Builds).

2. If it doesn't exist already, create the folders [install-dir]/applications/live and [install-dir]/conf/live.

2. Copy the file [install-dir]/conf/Applications.xml into [install-dir]/conf/live.

3. Edit the newly copied Application.xml file and set the Streams/StreamType setting to live. Add the following module definition to the end of the <Modules> list:


<Module>
	<Name>ModuleMediaCasterStreamManager</Name>
	<Description>ModuleMediaCasterStreamManager</Description>
	<Class>com.wowza.wms.plugin.mediacasterstreammanager.ModuleMediaCasterStreamManager</Class>
</Module>

Also add the following property to the application properties at the bottom of the Application.xml file:


<Property>
	<Name>mediaCasterStreamManagerPassword</Name>
	<Value>#%$de@vf^</Value>
</Property>

This property is the password used to protect the ModuleMediaCasterStreamManager interface. See the Note at the bottom of this document for more information.

4. Copy file lib/wms-plugin-mediacasterstreammanager.jar from this zip archive to the [install-dir]/lib/ folder of the Wowza Pro server.

To use

To use the MediaCaster Stream Manager tool, double click the client/mediacasterstreammanager.html, change the RTMP in the Connect field to rtmp://[wowzapro-ip-address]/live (where [wowzapro-ip-address] is the ip address of server running Wowza Pro) and click the Connect button. You can now start and stop the publishing and recording of streams. To do this, enter the full stream name of the stream into the Stream field and select the appropriate MediaCaster type from the drop down menu and click the Start Stream button.

To stop a stream either enter the stream name in the Stream field or select it from the Active list and click the Stop Stream button.

These MediaCaster types correspond to the MediaCasters defined in the [install-dir]/conf/MediaCasters.xml configuration file. The rtp and rtp-record types are for starting Native RTP (streams with SDP files, RTSP urls, or where SDP data is located at an HTTP url) and MPEG-TS streams and the shoutcast and shoutcast-record types are for starting SHOUTcast and Ice Cast streams. The [*]-record types will also record the streams server side. If you specify the stream prefix flv: or do not provide a stream prefix then then the stream will be recorded to an FLV container. If you specify the stream prefix mp4: the stream will be recorded to an MP4 (Quicktime) container.

NOTE: The ModuleMediaCasterStreamManager API is protected by a password to guard against non-administrators from calling the API. The password is sent with each API call. The default password is #%$de@vf^. If you wish to change it you will need to edit [install-dir]/conf/live/Application.xml and change the mediaCasterStreamManagerPassword property to the new value as well as edit client/mediacasterstreammanager.fla (using Flash CS3 or greater) and change the mediaCasterStreamManagerPassword variable at the top of the ActionScript code to the same value.