&totalroombitrate

The total bitrate a guest in a room can view video streams with

Viewer-Side Option! (&view, &scene, &room) Director Option! (&director)

Aliases

&totalroomvideobitrate
&trb

Options

Example: &totalroombitrate=4000 or &totalroombitrate=2000,1000

Value

Description

(integer value)

set this to be the total combined room bitrate

1000,500

Desktop bitrate, Smartphone bitrate

Details

The total bitrate a guest in a room can view video streams with; their combined bitrate total of all inbound video streams.

The default value is 500-kbps.

Split between the number of streams that guest is viewing.

So for example, with 6-guests in a room, the default of 500-kbps will have each guest requesting 100-kbps from each other. 5 streams x 100-kbps.

Two values

&totalroombitrate can take two values; the second of which gets used if the device is a 'mobile' device, while the first gets used otherwise. ie: &totalroombitrate=1000,500Useful if you don't know if the guest is going to join via Desktop or via Smartphone, and you wish to avoid overloading a mobile device.

Please note the difference between &totalroombitrate and &totalscenebitrate. &totalroombitratecontrols what the total bitrate for guests in a room is limited to. &totalscenebitrate, on the other hand, is what you will want if you want to do the same for a view-link, added to OBS, for example.

Limitations

Total room bitrate does not override any limits other guests in the room may have set to limit their outbound bandwidth.

Mobile devices are also coded to typically refuse requests of higher bitrates by other guests, even with a high total room bitrate set. Mobile devices will quickly overheat if publishing to many guests using software-encoding, so they are treated somewhat special.

In general, setting a high total room bitrate will increase the CPU and network requirements of the group room. Higher bitrates mean higher resolution, which means higher compute loads, so some computers may become overloaded. The default of 500-kbps seems low, but it was carefully selected to reduce such issues as much as reasonable.

Consider using &broadcast, combined with either a powerful host computer or a service like Meshcast.io if you'd like to share high quality video to a larger room. A high total room bitrate value may cause severe problems in large rooms or on slower computers.

Director's ability to control

If the director joins the room, they automatically set the default total room bitrate for every guest that joins the room; guests will match the director's value. This feature may even override the URL-parameter that any guest might have added to their URL already, depending on version of VDO.Ninja. (still being tweaked based on user feedback)

The director can also dynamically change their total room bitrate value using a slider that appears when pressing the room-settings button in the lower control bar. This will instantly change the total room bitrate value for all guests.