Open UDP ports during Windows app installation

Note: In Vivox Core SDK version 5.21 and above, Vivox no longer requires binding Windows ports. You can ignore instructions on this page if you aren’t working in a restricted environment that requires specifying specific ports and are using a Vivox version of 5.21 or higher.

When writing a Windows application you can avoid opening ports for your application by setting the minimun_port and maximum_port in vx_config to 0. This is the default setting in Windows.

Setting UDP ports

If you don’t use the default or set the ports to zero, you must ensure that your app installer runs with elevated privileges and that you open User Datagram Protocol (UDP) ports for your app. This prevents Windows Defender from prompting users to allow the app, which can occur when they join a channel for the first time if UDP ports are not open during the installation of a Windows app.

To open the UDP ports, run your app installer with elevated privileges and then perform either of the following actions:

  • Open the specific UDP ports that you intend to use for the app (for example, minimum_port and maximum_port as specified in vx_req_connector_create).
  • Open all UDP ports for the app.

The following code displays an example of how to open all UDP ports:

netsh advfirewall firewall add rule name="SDKSampleApp" program="C:\Program Files\Vivox\SDKSampleApp\SDKSampleApp.exe" dir=in action=allow protocol=UDP enable=yes