Applications are separate group of streams with specific set of parameters and settings. An application defines how streams can be published and viewed.
An origin application is the basis for creating video streaming clusters. It is very similar to a live application, with just a few minor differences. A single origin-type application will accept multiple connections from edge-type applications
The basic origin-type application configuration stored in config/preferences.xml looks as follow:
<Application name="origin" type="origin">
<StreamingClusterSettings>
<IPWhiteList>127.0.0.1, 192.168.0.2</IPWhiteList>
<Authorization>
<Auth username="admin" password="qwerty" />
</Authorization>
</StreamingClusterSettings>
<RTMPController>
<AllowStreamPublish>true</AllowStreamPublish>
<AllowStreamOverwrite>true</AllowStreamOverwrite>
<AllowClientPlayback>true</AllowClientPlayback>
<KeepClientStreamsAlive>true</KeepClientStreamsAlive>
<PlaybackAuthRequired>false</PlaybackAuthRequired>
<Authorization enabled="false" sourceType="local" sourceTarget="abc">
<Auth username="admin" password="qwerty" />
<Auth token="62cjdj" expire="2022-02-01 16:22:00" />
</Authorization>
</RTMPController>
<RecordingSettings enabled="false">
<SavePath>/Users/Johny/Desktop</SavePath>
<CacheSize>15</CacheSize>
<MaxFileSize>15</MaxFileSize>
<MaxFileDuration>0</MaxFileDuration>
<MaxStorageSize>0</MaxStorageSize>
<RemoveOldFiles>true</RemoveOldFiles>
</RecordingSettings>
<TranscoderSettings enabled="true">
<Preset name="720p" />
<Preset name="360p" />
</TranscoderSettings>
</Application>
| Application:name | Name of this application. If there are more applications within your preferences.xml they all must have unique names. |
| Application:type | This value must be set to “origin” for this type of Application. |
This block defines the source (or multiple sources) for this application. Edge application will copy all streams from the origin server the moment they appear. You can define more than one <sourceItem> for redundancy.
In case of two streams from different origin server having the same steamName, only the first one will be copied (depending on creation time).
| sourceItem:url | URL or IP to an origin server. |
| sourceItem:port | Port for origin-edge connection. |
| sourceItem:ssl | True/false depending on whenever SSL layer is required. |
| sourceItem:username | A username for origin-edge authentication. |
| sourceItem:password | A password for origin-edge authentication. |
Recording option allows for recording video streams into MP4 files.
| RecordingSettings:enabled | Defines whenever recording is enabled. |
| SavePath | Path were MP4 files should be saved. |
| CacheSize | Defines how much of a video stream should be kept in memory before being flushed to a file. |
| MaxStorageSize | Storm will calculate sum of all saved video files in particular folder and either stop saving new ones, or it'll start overwriting older files if RemoveOldFiles is set to true. This parameter is optional and if not present or set to 0 no limitation will be added. |
| RemoveOldFiles | If set to true and combined with MaxStorageSize, older video files will be removed to make space for new ones. |
| MaxFileSize | Maximum video file size. If a stream reaches this size, it will be split into additional files. This parameter is optional, and if not present or set to zero, no limit will be in effect. |
| MaxFileDuration | Maximum video file duration (time). If a stream exceeds this duration, it will be split into multiple files. This parameter is optional, and if not specified or set to zero, there will be no limit in effect. |
For each individual application a set of presets for transcoding can be selected.
| TranscoderSettings:enabled | If set to false, no video stream will be transcoded. |
| preset:name | Name of a preset, previously defined in main Transcoder tag. |