Wowza Media Server 3: FixStreamPath

Description

This AddOn package contains two modules and a VHostListener to solve two common RTMP connection issues.

The module ModuleFixStreamPath is desiged to adjust for Flash based players that do not properly decode single URL stream names into the RTMP URL and stream name. These players assume that the last element of the path is the stream name and that the remain part of the URL is the RTMP URL. For example the URL:
```
rtmp://mycompany.com/live/_definst_/myfolder/mystream
```
Is improperly decoded into RTMP URL and stream name as:
```
RTMP URL: rtmp://mycompany.com/live/_definst_/myfolder
Stream name: mystream
```
This module when added to Application.xml will properly decode the single URL:
```
RTMP URL: rtmp://mycompany.com/live/_definst_
Stream name: myfolder/mystream
```
The module ModuleFixDefInst and VHostListener VHostListenerFixDefInst are designed to enable the use of RTMP URLs that do not include an application instance name. For example if you are playing the following URL:
```
rtmp://mycompany.com/live/myfolder/mystream
```
Most players will interpret this URL as:
```
RTMP URL: rtmp://mycompany.com/live/myfolder
Stream name: mystream
```
With this module and vhost listener when configured in Application.xml and Server.xml, the URL will be interepretted properly as:
```
RTMP URL: rtmp://mycompany.com/live/_definst_
Stream name: myfolder/mystream
```

Installation (ModuleFixStreamPath)

Copy lib/wms-plugin-fixstreampath.jar from this package to [install-dir]/lib
Edit [install-dir]/conf/[application]/Application.xml (where [application] is the name of your Flash application) and add the following module definition as the last entry in the <Modules> list.


<Module>
	<Name>ModuleFixStreamPath</Name>
	<Description>ModuleFixStreamPath</Description>
	<Class>com.wowza.wms.plugin.fixstreampath.ModuleFixStreamPath</Class>
</Module>

Installation (ModuleFixDefInst and VHostListenerFixDefInst)

Copy lib/wms-plugin-fixstreampath.jar from this package to [install-dir]/lib
Edit [install-dir]/conf/[application]/Application.xml (where [application] is the name of your Flash application) and add the following module definition as the last entry in the <Modules> list:
```
<Module>
	<Name>ModuleFixDefInst</Name>
	<Description>ModuleFixDefInst</Description>
	<Class>com.wowza.wms.plugin.fixstreampath.ModuleFixDefInst</Class>
</Module>
```
Edit [install-dir]/conf/Server.xml and add the following VHostListener definition as the last entry in the <VHostListeners> list.
```
<VHostListener>
	<BaseClass>com.wowza.wms.plugin.fixstreampath.VHostListenerFixDefInst</BaseClass>
</VHostListener>
```

Note: Source code is included in src folder.

Note: These modules only apply to RTMP streaming (RTSP and HTTP streaming protocols are not included).