This is the default value of the and results in no audio being broadcast to any channel.

If transmitting into a specific channel with , and that channel is disconnected entirely or has its audio capability disconnected, reverts to 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 . However, if set to , you continue to transmit into all channels.

You can call

ILoginSession::SetTransmissionMode(TransmissionMode::All)

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.

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 by using

ILoginSession::SetTransmissionMode()

, 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

IChannelSession

methods

BeginConnect()

and

BeginSetConnectedAudio()

, which let you join a channel or add audio capability to a text-only channel, each have the argument bool . When supplied with true, they override and set the of the

ILoginSession

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.