Learn about different voice transmission modes in Vivox.
Read time 1 minuteLast updated 2 days ago
TransmissionMode::None
This is the default value of the
TransmissionMode
and results in no audio being broadcast to any channel.If transmitting into a specific channel with
TransmissionMode::Single
, and that channel is disconnected entirely or has its audio capability disconnected,
TransmissionMode
reverts to
TransmissionMode::None
even if you are joined to other audio capable channels. If you want the plug-in to switch transmission to another one automatically, you can use the delegate callbacks or state change events that are found in
at any point to enable transmission into all current and future channels. This enables users to broadcast audio into all channels they are or will ever be connected to until you change the policy. There is no additional resource cost for transmitting to multiple channels as compared to a single channel.
TransmissionMode::Single
Use this policy for when a user is in multiple audio-capable channels but only wants to speak in one at a time. In scenarios where the user is in one audio-only or audio and text channel at a time, this performs identically to TransmissionMode::All.When setting
, you must also include a ChannelId as the second argument, specifying which single channel you want to transmit to. There is no benefit to preemptively setting this value for a channel you are not already connected to because the audio does not have anywhere to go.The
to transmit only to that specific channel, effective as soon as the channel is joined or audio capability is available. Setting this method to false results in following whatever policy ILoginSession already has set. By using this parameter, applications that only join one audio channel at a time usually do not have to call any transmission-specific APIs.