Disable your browser’s sleep mode setting for WebRTC Media Helper

If you experience connection issues when using the WebRTC Media Helper in a VDI environment, you might want to consider disabling your browser’s sleep mode setting. This setting goes by different names in the different browsers, but the function is the same – to put tabs that the browser considers to be inactive into a sleep mode to conserve memory and power.

While in general putting inactive tabs to sleep is a good concept, it can cause connection issues for WebRTC Media Helper, which requires a consistent connection. When a browser puts a tab in which WebRTC Media Helper is running to sleep, WebRTC Media Helper can lose its connection to the VDI environment. When that happens, WebRTC Media Helper will cease to function correctly and can prevent your agents from working until the connection can be reestablished.

Microsoft Edge

In Microsoft Edge, you can disable sleep mode for specific sites.

  1. Start Microsoft Edge.
  2. Click Settings and more.... 
  3. Click Settings. The Settings tab appears.
  4. Click System and performance.
  5. Under Never put these sites to sleep, click Add. The Add a site dialog appears.
  6. Type your region domain in the Site box using this format [*].domain]. For example, [*.]mypurecloud.com.
  7. Click Add.

Google Chrome

In Google Chrome, you can disable sleep mode for specific sites.

  1. Start Google Chrome.
  2. Click Customize and control Google Chrome ….
  3. Click Settings. The Settings tab appears.
  4. Click Performance.
  5. On the Memory tile, locate the Always keep these sites active setting and click Add. The Add sites dialog appears.
  6. Click Add sites manually.
  7. Type your region domain in the Site box. For example, mypurecloud.com.au.
  8. Click Add.

Mozilla Firefox

In Mozilla Firefox, you must disable sleep mode for every tab you open; regardless of the site.

  1. Start Mozilla Firefox
  2. Type about:config in the Address bar and press Enter. The Advanced Preferences tab appears.
  3. Click Accept the Risk and Continue.
  4. Type browser.tabs.unloadOnLowMemory in the Search preference name box.
  5. When the browser.tabs.unloadOnLowMemory setting appears, click Toggle to change the setting to False.