Live Broadcasting Settings

Bandwidth negotiation during live events is a feature from RealAudio 3.0 that is no longer supported in RealServer. If you are using RealAudio 3.0, connect one encoder for each encoding algorithm you want to support. Specify the same file name as the output from each encoder. RealServer recognizes the format of each stream and directs it to RealPlayers requesting that format.

Setting

Description

EncoderPassword Password used by RealAudio Encoder, RealVideo Encoder, and the rvslta utility program to connect to RealServer.
EncoderControlList List of users and passwords. Allows multiple people to encode and use the same file name for different files.
EncoderTimeout The time in seconds that the Server will wait before disconnecting a RealAudio Encoder or RealVideo Encoder that is not sending data.
LiveFilePassword Password used for archiving live broadcasts.
LiveFileSize Size of file, in megabytes, used for creating archive files of live broadcasts.
LiveFileTarget File or directory to use to create the archive files of live broadcasts.
LiveFileTime Maximum length, in time, of a archive file of a live broadcast.
URL URL that points to the live media stream to be recorded by rafile.
BandwidthEncoding The default bandwidth for archive files of live broadcasts.
LiveFileBandwidthNegotiation Specifies that the rafile program use bandwidth-negotiation style of naming for archive files of live broadcasts.
InputFile The path of a file to convert to a live file.
OutputFile Name of the simulated live stream sent using the rvslta utility.
ServerHost Name of a RealServer to receive the live file.
ServerPassword Password that rvslta must use to connect to RealServer.
ServerPort Number of port on the RealServer to receive the live file from rvslta.

 

EncoderPassword

Password used by RealEncoder, RealPublisher, and the rvslta utility program to connect to RealServer. Note that the default setting of no password allows any RealAudio Encoder or RealVideo Encoder to connect to the server.
Default value (none)
Range of values Alpha-numeric string without spaces

Syntax

EncoderPassword <password>

Example

EncoderPassword rmRecord1

EncoderControlList

Allows multiple people to encode live content and use the same file name for different files. The file is published to a virtual directory beginning with the user's name.
Default value (none)
Range of values Alpha-numeric string without spaces

Syntax

EncoderControlList [ {user1, user1password}, {user2, user2password}, ...]

Example

EncoderControlList [ {smith, encd} ]

In this example, any files encoded by the user "smith" will appear in a virtual directory named "smith." So if the user encodes a file and calls it "live.rm," the path to file will be "pnm://my.server.com/smith/live.rm".

 

EncoderTimeout

The time in seconds that the Server will wait before disconnecting a RealEncoder or RealPublisher that is not sending data. If the connection to the Encoder is lost, the Server must disconnect before the Encoder can reconnect. Setting EncoderTimeout to less than 10 seconds is not recommended.
Default value 30
Range of values 1 - 32767 seconds

Syntax

EncoderTimeout <seconds>

Example

EncoderTimeout 20

LiveFilePassword

Password used for archiving live broadcasts. Used by RealServer for automatic archiving and by the rmfile or rafile utility program.
Default value (none)
Range of values alphanumeric string without spaces

 

Syntax

LiveFilePassword <password>

Example

LiveFilePassword rmBroadcast1

LiveFileSize

Size of file, in megabytes, used for creating archive files of live broadcasts. Used by pnserver, rmfile, and rafile. By default, rmfile or rafile uses this setting unless overridden with the -s option.
Default value 0
Range of values Integers greater than or equal to zero

Syntax

LiveFileSize <value>

Example

LiveFileSize 5

LiveFileTarget

File or directory to use to create the archive files of live broadcasts. Used by pnserver, rmfile, rafile. By default, rmfile or rafile uses this value unless overridden by a file or directory name on the command line.

If name is a directory name, rmfile or rafile uses the filename of the live broadcast to name files. If it is a filename, it creates files in the working directory used to start rmfile or rafile or RealServer. In either case, it appends numbers to the archive files, starting at 0.
Default value (none)
Range of values Valid file name

Syntax

LiveFileTarget <name>

Example

LiveFileTarget pnfm.rm

Makes rmfile create archive files named pnfm1.rm, pnfm2.rm, and so on.

Windows
LiveFileTarget c:\real\server\content
UNIX
LiveFileTarget /usr/evand/rmfiles

Makes rmfile create archive files in the directory /usr/evand/rmfiles and names files using the filename list in the URL setting.

 

LiveFileTime

Maximum length, in time, of an archive file of a live broadcast. Specify time as a number and letter, such as 1m for one minute, 1h for one hour, and 1d for one day.
Default value 0
Range of values Integers greater than or equal to zero and letters d, h, and m.

By default, rmfile or rafile uses this setting unless overridden with the -t option.

Syntax

LiveFileTime <value>

Example

LiveFileTime 1h

URL

URL that points to the live media stream to be recorded by rafile. Used by rmfile, rafile. Rmfile and rafile use this setting unless overridden by a URL on the command line.
Default value (none)
Range of values valid URL

Syntax

URL <url>

Example

URL pnm://server:7070/live1.rm

BandwidthEncoding

Specifies the default bandwidth for archive files of live broadcasts. Required for rafile; not required for rmfile. By default, rafile uses this setting unless overridden with the -e option.
Default value None
Range of values 14_4.18, dnet.20, dnet.25, 28_8.36, dnet.50, dnet.100

Syntax

BandwidthEncoding <value>

Example

BandwidthEncoding dnet.20

Rmfile is the main utility and supports .rm files; .ra files were used in the RealAudio 3.0 Server.

 

LiveFileBandwidthNegotiation

Specifies that the rafile program use bandwidth-negotiation style of naming for archive files of live broadcasts. Used by pnserver, rafile; not required for rmfile. By default, rafile uses this setting unless overridden with the -b option.
Default value False
Range of values True, False

Syntax

LiveFileBandwidthNegotiation <value>

Example

LiveFileBandwidthNegotiation TRUE

Rmfile is the main utility and supports .rm files; .ra files were used in the RealAudio 3.0 Server.

 

InputFile

The path of a file to convert to a live file. Used by rvslta. By default, rvslta uses this value unless overridden by a filename on the command line.
Default value (none)
Range of values Valid file name

Syntax

InputFile <filename>

Example

Windows
InputFile c:\real\server\content\show1.rm
UNIX
InputFile /usr/content/show1.rm

OutputFile

Name of the simulated live stream sent using the rvslta utility. Rvslta uses this setting unless overridden by a filename on the command line.
Default value (none)
Range of values Valid media file name

Syntax

OutputFile <filename>

Example

OutputFile broadcast.rm

ServerHost

Name of a RealServer to receive the live file. The rvslta utility uses this setting unless overridden by a host name on the command line.
Default value (none)
Range of values Valid DNS name

Syntax

ServerHost <host>

Example

ServerHost server1.real.com

ServerPassword

Password that rvslta must use to connect to RealServer. By default, rvslta uses this value unless overridden by a password on the command line.
Default value (none)
Range of values Alpha-numeric string without spaces

Syntax

ServerPassword <password>

Example

ServerPassword StreamKey1

ServerPort

Number of port on the RealServer to receive the live file from rvslta. Must be the port number of the RealServer specified by the ServerHost setting. Rvslta uses this setting unless overridden by a port number on the command line. For information on using rvslta, see Delivering Live Content.
Default value (none)
Range of values Valid port number

Syntax

ServerPort <port>

Example

ServerPort 8081

© 1997 RealNetworks, Inc.