Cannon VoIP Help

The desktop app on Citrix, Remote Desktop and virtual desktops

Run the Cannon VoIP computer app on Citrix, Remote Desktop, Azure Virtual Desktop or VMware Horizon: the audio settings IT turns on, installing it once for everyone, and who updates it.

Updated 2 weeks ago

If your company runs Windows on a server (Citrix, Remote Desktop Services, Azure Virtual Desktop or VMware Horizon), the Cannon VoIP computer app works there too. This page is for whoever looks after those servers.

Where the call's sound comes from

The app runs on the server, but the call's audio does not. The microphone and speakers are the ones on the computer the person is sitting at, passed through by the remote session. So two things have to be on in the remote session's settings:

  • Audio playback redirection, so the person hears the call
  • Microphone (audio recording) redirection, so the other side hears them

The app knows when it is running in one of these sessions. Its audio settings say so, and if no microphone reaches it, the call screen tells the person to ask IT to turn on redirection.

Citrix

Set the policies Client audio redirection and Client microphone redirection to Allowed. Audio quality High or Medium both work well for calls.

Remote Desktop and Azure Virtual Desktop

Use the RDP properties audiomode:i:0 (play sound on this computer) and audiocapturemode:i:1 (record from this computer). In Group Policy, under Remote Desktop Session Host, Device and Resource Redirection, turn on Allow audio and video playback redirection and Allow audio recording redirection.

VMware Horizon

Turn on the Horizon Agent's audio-in feature, and Allow access to microphone in the Horizon client.

Installing it once for everyone

As an administrator on the server, install it for all users without any prompts:

Cannon_VoIP_x.y.z_x64-setup.exe /S /ALLUSERS

It goes into Program Files and every user on the server gets it in the Start menu. Each person signs in with their own Cannon VoIP account. Nothing is shared between users.

Updates: let IT do them

On a shared server the app should not update itself: people can't run the installer, and an update would close the app for everyone on the server. Turn its self-updates off with any one of these:

  • the policy value HKLM\SOFTWARE\Policies\Cannon VoIP\ManagedUpdates set to 1 (DWORD), for example through Group Policy Preferences
  • the environment variable CANNON_MANAGED_UPDATES=1
  • an empty file named managed-updates next to Cannon VoIP.exe in the install folder

The app then never offers or installs an update. Install new versions with the same /S /ALLUSERS command at a quiet time.

Good to know

  • Calls through a remote session add a little delay, because the sound crosses the remote link both ways. On a good network you won't notice. On a slow link, a desk phone or the mobile app is the better choice.
  • Headset buttons (answer, mute) on the person's own computer usually don't reach an app running on the server.
  • If the app's window comes up blank, start it with --software-rendering, or set CANNON_SOFTWARE_RENDERING=1.

Need a hand setting it up? Call Cannon VoIP support at 888-973-0515.

Was this helpful?
← All help articles