RealityServer Configuration

RTMP Configuration Directives

The following directive configures the RealityServer RTMP server.

rtmp_address

Description RTMP address to listen on
Syntax rtmp_address [address:]port
Context global
Default none

The address and port number, separated by a colon, or only the port number, where RealityServer accepts client RTMP connections. The address 0.0.0.0 means "any interface"; other addresses identify a network interface, which is useful if the host has more than one network card. Port numbers are normally in the range 1024..65535; lower numbers are privileged. By default the RTMP server is disabled.

The special port number "0" may be specified and RealityServer will pick a random, available port to use.

On startup a log message is emitted with the system_resource tag and a code value of 34 containing the RTMP server listen address. The webhook log handler facility can then be configured to forward this message to another service to advertise the configured address.

default_video_codec

Description The default video codec to use if none specified
Syntax default_video_codec h264|sorenson|screen video
Context global
Default dependent on installed plugins
Specifies the default video codec to use if the client does not provide one when creating an RTMP encoder. If not specified, or no plugin is installed for the specified codec, then RealityServer will fallback to the first installed codec found in the following order:
  1. h264
  2. sorenson
  3. screen video