Ninja Docs
Search…
What is VDO.Ninja?
Getting started
Guides
Advanced Options (URL Parameters)
Most common Parameters
Setup Parameters
Video Parameters
&blind
&quality
&width
&height
&mediasettings
&noscale
&framerate
&maxframerate
&effects
&effectvalue
&outboundvideobitrate
&controlroombitrate
&limittotalbitrate
&maxbitrate
&roombitrate
&fullscreen
&preview
&minipreview
&nopreview
&hideguest
&videomute
&ptz
&forcelandscape
&forceportrait
&videobitrate
&totalroombitrate
&maxtotalscenebitrate
&zoomedbitrate
&optimize
&scale
&codec
&h264profile
&buffer
&fadein
&broadcast
&novideo
&webp
&webpquality
&dpi
Audio Parameters
Settings Parameters
Mixer/Scene Parameters
Design Parameters
Director Parameters
Screen-share Parameters
Meshcast Parameters
API & MIDI Parameters
TURN & STUN Parameters
Newly Added Parameters
Upcoming Parameters
Other Parameters
Releases
Help!
Common errors and known issues
Platform specific issues
FAQ
Edit this documentation
Redirect
Redirect 2
Powered By GitBook
&broadcast
A useful flag to allow the director to present their own video to the group, often used in conjunction with a virtual webcam; it can allow for larger groups rooms by reducing load on guests
Viewer-Side Option! (&view, &scene, &room)

Aliases

  • &bc

Options

Value
Description
(string)
You can pass an optional stream-ID to specify the stream's source manually. If no value is passed, the source will be the room's director video out feed.

Details

This command is like &novideo, but with some extras added to make setup of large group rooms easier.
  • It also disables the local video preview..
  • it also disables the video from other guests, unless their stream ID is specified as the {xxx} value
  • It hides the audio-only guest windows that would appear normally; this is akin to &style=1.
  • It disables the top page header (&noheader).
  • It defaults to the director's stream, if no value is passed.
  • You cannot pass multiple stream IDs to the &broadcast flag; just one. If needing more, consider using the &novideo flag instead
You can imitate the &broadcast parameter using &novideo=PC1,PC2&noheader&nopreview&style=1

Performance considerations

While the &broadcast flag is great for reducing the load on guests in a room, it will put all the load onto the director instead.
  • Consider using NVEnc or other hardware-encoders to encode any RTMP streams in your studio software to reduce CPU load there
  • Make sure you have a capable computer; an AMD 5900x CPU is recommend for most users using this mode, allowing for medium-sized group rooms with some headroom to spare.
  • A quad-core computer might only be able to support 1 or 2 guests adequately in this mode
  • Consider using the &webp flag to reduce the CPU load on the director further; this will lower the quality that the guests see however.
  • If you would like the guests to see even higher quality video, consider using &trb=2500 as an option to greatly improve the video quality. This also will greatly also increase the load on the director, so good internet and a powerful CPU will be needed
  • Using a service like meshcast.io, along with the &website parameter, can also greatly reduce load on the director and guests, but this comes at the cost of added latency usually.
If you'd like to understand how Meshcast.io can help reduce CPU load greatly, leveraging VDO.Ninja's group broadcast-feature, you can see this video:
Previous
&fadein
Next
&novideo
Last modified 1mo ago
Copy link
Contents
Aliases
Options
Details