Revision as of 01:32, 17 February 2018

How is WebRTC different from Discord, Google Hangouts, Skype, etc?

WebRTC is a HTML5 technology that runs video and voice through a web browser without the need of a java applet. Applications like Skype or Discord aren't browser-based and therefore have access to hardware acceleration and data compression that Roll20 cannot take advantage of. Those applications use a Client/Server or All-to-One-to-All connection rather than a Peer-to-Peer connection. With an "All-to-One-to-All" connection, applications like Skype send your video/voice data one time to their server which then carries that load of data to each of the other people in the call. With "Peer-to-Peer", you are sending your video/voice data again to each peer connection in the call. This means that the upload bandwidth cost for a WebRTC call is higher than other VOIP options in anything more than a two person call. This higher upload bandwidth cost can result in stability problems for users with low upload bandwidth connections.

Roll20 WebRTC Bandwidth Requirements

Roll20 WebRTC can only be used in web browsers that natively support it. Roll20's officially supported browsers, Chrome and Firefox, are both compatible. A Roll20 WebRTC call has a suggested download and upload bandwidth of 512Kbps per additional user in the chat. That means that in a six person call (five users other than yourself), you would need around 2.5Mbps of bandwidth for a stable call. If your group has members whose connections cannot support these requirements we suggest using a 3rd party, non-browser based chat option, that can make use of both hardware acceleration and data-compression to lower bandwidth requirements.

Check My Settings

The Video & Voice Performance Settings on the Settings Tab of Roll20

If you or your players are experiencing issues with video and voice, the first thing everyone should check is the Video + Audio Chat Options under the My Settings tab of the Sidebar.

Chat Tech

The GM should have Chat Tech either set to Roll20 WebRTC (Chrome + Firefox) or Legacy Roll20 WebRTC(deprecated) selected in order for WebRTC to activate. If Chat Tech is set to None (no audio/no video) a WebRTC call will not initiate call connections between players.

If you are still using the Legacy Roll20 WebRTC(deprecated) option and are still suffering audio and video problems, we recommend swapping over to the more modern Roll20 WebRTC (Chrome + Firefox) option.

Broadcast and Receive Settings

Everyone (GM and Players) should check their settings for I want to broadcast to others as well as I want to receive from others to see if video and/or voice has been unintentionally disabled here.

Output and Input Sources

Check that the correct devices are being used for video and voice. Audio Output Source selects the speaker device you wish to hear voice with. Audio Input Source selects the microphone device you wish to speak with. Video Input Source selects the webcam you wish to capture video with. Note that the Audio Output Source drop-down menu is not available unless an a call is already active.

When in Doubt, hit the Reconnect Button

Always click on the Reconnect Button if you make any device input/output or broadcast/receive settings. Beyond that, often if a video or voice problem occurs, hitting the Reconnect button can often fix a broken connection that failed silently in a call.

Browser Settings

At present, Roll20 only fully supports Firefox and Chrome web browsers for our VTT. Other browsers may be able to handle WebRTC with little to no issues, but we can't devote reliable tech support for them if you do run into any issues.

Keeping your Browser Up to Date

It's generally a good idea to keep your browser updated to take advantage of browser bug fixes and optimization measures.

Updating Chrome

1. Click on the More Button (vertical row of three dots icon) in the upper right hand corner.
2. Click on the Help option from the resulting drop down menu.
3. Click on About Google Chrome option from the secondary drop down menu that appears.

OR

1. Paste chrome://help/ into the URL bar and hit Enter.

Either method will open Chrome's "About" page that will inform you of your current browser version and will automatically prompt you to update to the latest stable version if you're not using it.

Updating Firefox

1. Click on the Menu Button (three horizontal lines icon) in the upper right hand corner.
2. Click on ? icon at the bottom of the drop down menu.
3. Click on About Firefox from the resulting roll out menu.
4. Firefox will tell you your current browser version and automatically prompt an update to the latest stable version if you're not using it. Click the Restart to Update button if necessary.

Microphone and Camera Browser Permissions

To protect your privacy, microphone and webcamera permissions are disabled from use on Chrome and Firefox by default. If this is the first time you've used Roll20, recently cleaned out your browser cookies/cache, or working from a fresh install of your browser, you'll need to approve the Roll20 website's use of your camera and microphone for them to be used for broadcasting either video or voice within a game.

Enabling Chrome Permissions

"Chrome AV Select"

1. When the VTT loads for the first time, you should be asked to Allow or Deny camera and microphone access from a grey bar pop-up that appears at the top of the screen.
2. Click Allow to enable your camera and microphone to be used within a Roll20 game.

OR

1. Click on the lock icon in the far left of the URL/search bar to reveal a drop down menu.
2. Ensure that both Camera and Microphone options have their permissions set to "Always allow on this site". Make sure you're currently on Roll20.net when you set this, this setting is URL sensitive.

Enabling Firefox Permissions

"Firefox AV Select"

1. When the VTT loads for the first time, you'll be asked to 'Share Selected Devices' from a drop down menu in the upper left hand corner of the screen.
2. If not, click on the Camera icon in the upper left hand corner next to the Back button.
3. Be sure to select the correct Camera and Microphone to share before clicking the Share Selected Devices button.

Clear your Web Browser's Cache

Clearing Out Chrome's Cache

1. Click on the Menu Button (three horizontal lines) in the upper right hand corner.
2. Click on More Tools from the dropdown.
3. Click on Clear browsing data from the new options.
4. From the drop down "Obliterate the following items from:" select the beginning of time option.
5. Check both Cookies and other site and plug-in data and Cached images and files.
6. Click on Clear browsing data button.

Clearing Out Firefox's Cache

1. Click on the Menu Button (three horizontal lines) in the upper right hand corner.
2. Click the Options Button' (a small gear) from the drop down menu.
3. On the Advanced tab, select the Network sub-tab.
4. Under the Cached Web Content section, select the Clear Now button.

Device and Bandwidth Tests

Webcam WebRTC Compatibility Test

• Check to see if your camera works with Google’s WebRTC demo.
• Go to: https://apprtc.appspot.com

Alternatively is to run a test of your webcam and mic through appear.in. This website is also a Peer-to-Peer WebRTC service that can have up to eight users in a conference call. You can test your entire gaming group in one pass.

Perform a WebCam/Microphone Test

• Check if your camera works with a different browser. For instance, if you are using Firefox check if it works with Chrome instead.
• Does the camera work with any other software that uses the camera such as Skype or Photobooth.

Perform a Bandwidth Test

If you don’t already know them, you can take a bandwidth speed test from OOKLA’s Browser-based Speedtest (Note: Adobe Flash is required to run the applet). You will want to run this test in the principle environment you normally play your games on Roll20 and have a Roll20 game currently open.

1. Once the applet loads on the home page, click the button "Begin Test".
2. Allow the test to run. This process can take a couple minutes to complete.
3. Once it's finished, Speedtest will give you your download and upload rate in megabits per second (Mbps).

Filing a Report on the Bug Forum

If none of the above tests and steps helped resolve your issues please follow Steps 1-3 from the Solving Technical Issues Guide, taking special care to temporarily disable all browser add-ons and extensions, temporarily pause your anti-virus (or whitelist Roll20.net), and try switching browsers (for Chrome/Firefox specific issues) to see if one of those components is causing the problem. If all of that fails, please follow Step 4 and file a bug report on the WebRTC Video and Voice Chat Issues forum thread. Please provide all of the information you gathered from Steps 1-4 of the Solving Technical Issues Guide as well as the following information:

WebRTC Connectivity Diagnostic Test

Additionally, we recommend that you try to run this WebRTC Connectivity Diagnostic Test and supply its test result in your report.
Once there:

1. Click on the Start button.
2. Allow the test to run itself through the various subtasks (Microphone, Camera, Network, Connectivity, and lastly Throughput).
3. If the test runs into any issues, click on the bug icon at the top, this brings up a new window to create a bug report.
4. Describe what issues you had with the diagnostic test and then click on “Upload Report”
5. This will pull up a new window that provides a link to the report (“The link to the report is now available”). This link will be available for the next 90 days. Copy the link and paste it here in this thread.

In-Game Bandwidth Settings

Let us know what your average Download and Upload speeds from the above Bandwidth Test as well as the "Video Bandwidth" setting (High, Medium, Low, or Very Low) under the Video + Voice section of the Settings tab within your Roll20 game.