Push-to-talk#

Many games feature push-to-talk (PTT) functionality that allows users to control when they have a live microphone. For most users, it is sufficient to globally mute and unmute the microphone by using IAudioDevices.Muted. However, there are two notable situations where we recommend that you use transmission for muting purposes.

• If a user has more than one audio source (for example, when they are both speaking into a microphone and injecting audio), then muting only the microphone does not stop the injected audio (if someone else mutes the user, then all of their audio is muted).

  To ensure that PTT functionality can turn on or turn off muting for both microphone audio and injected audio, set transmission between None and Single/All.

• If a user is in two audio channels (for example, 2D team chat and 3D area chat), and you want separate PTT keys for each channel so a user can speak into one or both channels at a time when PTT is turned on, and into no channels when PTT is turned off, then use SetTransmissionMode() between each of the different modes.

  • If you want a single PTT key to turn on or turn off muting for all channels at a time rather than individually, then switching transmission between All/None has no real advantage over muting the microphone, except for when injecting audio.