Add webcam troubleshooting tips to the About page
This commit is contained in:
parent
358e8d5aec
commit
134f9218a8
|
@ -109,7 +109,8 @@ func AboutPage() http.HandlerFunc {
|
||||||
"CacheHash": util.RandomString(8),
|
"CacheHash": util.RandomString(8),
|
||||||
|
|
||||||
// The current website settings.
|
// The current website settings.
|
||||||
"Config": config.Current,
|
"Config": config.Current,
|
||||||
|
"Hostname": r.Host,
|
||||||
}
|
}
|
||||||
|
|
||||||
tmpl.Funcs(template.FuncMap{
|
tmpl.Funcs(template.FuncMap{
|
||||||
|
|
|
@ -2237,7 +2237,7 @@ export default {
|
||||||
// Begin dark video detection.
|
// Begin dark video detection.
|
||||||
this.initDarkVideoDetection();
|
this.initDarkVideoDetection();
|
||||||
}).catch(err => {
|
}).catch(err => {
|
||||||
this.ChatClient(`Webcam error: ${err}`);
|
this.ChatClient(`Webcam error: ${err}<br><br>Please see the <a href="/about#troubleshooting">troubleshooting guide</a> for help.`);
|
||||||
}).finally(() => {
|
}).finally(() => {
|
||||||
this.webcam.busy = false;
|
this.webcam.busy = false;
|
||||||
})
|
})
|
||||||
|
|
|
@ -51,14 +51,15 @@
|
||||||
<li><a href="#features">Feature Highlights</a></li>
|
<li><a href="#features">Feature Highlights</a></li>
|
||||||
<li><a href="#browsers">Supported Browsers</a></li>
|
<li><a href="#browsers">Supported Browsers</a></li>
|
||||||
<li><a href="#privacy">Privacy</a></li>
|
<li><a href="#privacy">Privacy</a></li>
|
||||||
|
<li><a href="#troubleshooting">Troubleshooting</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<h1 id="tour">Tour of the user interface</h1>
|
<h1 id="tour">Tour of the user interface</h1>
|
||||||
|
|
||||||
<div class="has-text-centered mb-4">
|
<div class="has-text-centered mb-4">
|
||||||
<img src="/static/img/screenshot.png" alt="Screenshot of the user interface on desktop">
|
<img src="/static/img/screenshot.png" width="1269" height="582" alt="Screenshot of the user interface on desktop">
|
||||||
<br><em>Pictured: Screenshot of the user interface on tablet or desktop-sized screens.</em><br><br>
|
<br><em>Pictured: Screenshot of the user interface on tablet or desktop-sized screens.</em><br><br>
|
||||||
<img src="/static/img/mobile.png" alt="Screenshot of the user interface on mobile">
|
<img src="/static/img/mobile.png" width="720" height="703" alt="Screenshot of the user interface on mobile">
|
||||||
<br><em>Pictured: Screenshot of the mobile interface</em>
|
<br><em>Pictured: Screenshot of the mobile interface</em>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
@ -197,6 +198,8 @@
|
||||||
in to their webcams, respectively).
|
in to their webcams, respectively).
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
|
||||||
<h1 id="features">Feature Highlights</h1>
|
<h1 id="features">Feature Highlights</h1>
|
||||||
|
|
||||||
<h3 id="emoji-reactions">Emoji Reactions</h3>
|
<h3 id="emoji-reactions">Emoji Reactions</h3>
|
||||||
|
@ -259,6 +262,8 @@
|
||||||
website.
|
website.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
|
||||||
<h1 id="video-sharing">Video Sharing How-To's</h1>
|
<h1 id="video-sharing">Video Sharing How-To's</h1>
|
||||||
|
|
||||||
<h3 id="webcam">About webcam sharing</h3>
|
<h3 id="webcam">About webcam sharing</h3>
|
||||||
|
@ -374,6 +379,8 @@
|
||||||
sure that you have booted them!
|
sure that you have booted them!
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
|
||||||
<h1 id="browsers">Supported Browsers</h1>
|
<h1 id="browsers">Supported Browsers</h1>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
|
@ -382,6 +389,8 @@
|
||||||
Edge, Safari, Androids and iPads).
|
Edge, Safari, Androids and iPads).
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
|
||||||
<h1 id="privacy">Privacy</h1>
|
<h1 id="privacy">Privacy</h1>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
|
@ -426,6 +435,214 @@
|
||||||
so choose your risk tolerance accordingly.
|
so choose your risk tolerance accordingly.
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
|
||||||
|
<h1 id="troubleshooting">Troubleshooting</h1>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
This section contains some troubleshooting advice for issues commonly experienced in the chat room.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h2>Webcam Sharing</h2>
|
||||||
|
|
||||||
|
<h3>Permission Denied, or NotAllowedError</h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
If you see an error message from <strong class="has-text-danger">ChatClient</strong> that says
|
||||||
|
something like "Webcam error: Permission denied" or a "NotAllowedError," this section is for you.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
The reason for this error is that your web browser did not grant access to your Camera and Microphone
|
||||||
|
for the chat room to use. This may be because you accidentally clicked on the "Deny" button when your
|
||||||
|
browser asked you for permission, or because your web browser <em>itself</em> does not have permission for
|
||||||
|
these devices on your computer.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
When you encounter this error, there are two places to look to resolve this:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ol>
|
||||||
|
<li>
|
||||||
|
In your web browser's settings (e.g. in Google Chrome or Firefox), make sure that you are granting
|
||||||
|
permission for your Camera and Microphone to the chat room's website ({{.Hostname}}).
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
In your operating system's settings, ensure that your web browser itself has permission to use
|
||||||
|
your Camera and Microphone. <strong>Notice:</strong> on recent Mac OS and Windows systems, your
|
||||||
|
web browser might not have permission by default to access these devices!
|
||||||
|
</li>
|
||||||
|
</ol>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Please see the following sections for in-depth guidance on where to look.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<strong>Notice:</strong> webcam sharing will require both your Camera <em>and</em> your Microphone
|
||||||
|
permission - if either one is denied, webcam sharing will fail.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h4>1. Check your web browser's permissions for {{.Hostname}}</h4>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Go into your web browser's settings, to the "Privacy" or "Permissions" section and verify that
|
||||||
|
<code>{{.Hostname}}</code> has permissions to use your Camera <strong>and</strong> your Microphone.
|
||||||
|
Or at the very least: make sure that these settings are not set to "Deny" for {{.Hostname}}.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
For example, on <i class="fab fa-chrome"></i> <strong>Google Chrome:</strong>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Go into your browser Settings -> "Privacy and security"</li>
|
||||||
|
<li>Click on "Site settings" <small>("Controls what information sites can use and show (location, camera, pop-ups, and more")</small></li>
|
||||||
|
<li>From here you can check the permissions in two ways:
|
||||||
|
<ul>
|
||||||
|
<li>Under the "Recent activity" section, look for {{.Hostname}} or click "View permissions and data stored across sites" to look for it there.</li>
|
||||||
|
<li>Or: under the "Permissions" section, click into the "Camera" and "Microphone" settings to see the list of sites you've given/denied
|
||||||
|
permission for, and change {{.Hostname}} to "Allow" or remove {{.Hostname}} from the list of sites.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Or for example, on <i class="fab fa-firefox"></i> <strong>Mozilla Firefox:</strong>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Go into your browser Settings -> "Privacy & Security"</li>
|
||||||
|
<li>Scroll down to the "Permissions" section where you see buttons for Camera and Microphone.</li>
|
||||||
|
<li>Click on the "Settings..." button for Camera and Microphone to see the list of websites you've given/denied permission for.</li>
|
||||||
|
<li>Find <code>{{.Hostname}}</code> and remove it from the list.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
After changing your browser settings, <strong>exit and restart your web browser</strong> and log on to the chat room.
|
||||||
|
When going on webcam, hopefully your browser should ask you for permission for your webcam and microphone: be sure to
|
||||||
|
click on "Allow" when prompted.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
If the change in your web browser's settings doesn't resolve the permission error, then check in your operating system's settings.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h4>2. Check in your operating system's settings</h4>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
For example, <strong>if you are on <i class="fab fa-apple"></i> Mac OS:</strong>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Click on the Apple icon in your top menu bar and open "System Settings"</li>
|
||||||
|
<li>Click on "Privacy & Security"</li>
|
||||||
|
<li>Look for the Camera and Microphone settings and ensure that they are <strong>allowed</strong> for your web browser.</li>
|
||||||
|
<li>For more information, try: <a href="https://support.apple.com/guide/mac-help/control-access-to-your-camera-mchlf6d108da/mac">https://support.apple.com/guide/mac-help/control-access-to-your-camera-mchlf6d108da/mac</a></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Or for example, <strong>if you are on <i class="fab fa-windows"></i> Windows 10 or Windows 11:</strong>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Click on the Start button > Settings > Privacy & Security > Camera, and make sure Camera access is turned <strong>on.</strong></li>
|
||||||
|
<li>Make sure that "Let apps access your camera" is also turned on.</li>
|
||||||
|
<li>Ensure that your web browser (e.g. Google Chrome) has permission to access your camera and microphone.</li>
|
||||||
|
<li>For more information, try: <a href="https://support.microsoft.com/en-us/windows/manage-app-permissions-for-your-camera-in-windows-87ebc757-1f87-7bbf-84b5-0686afb6ca6b">https://support.microsoft.com/en-us/windows/manage-app-permissions-for-your-camera-in-windows-87ebc757-1f87-7bbf-84b5-0686afb6ca6b</a></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<h3>Other Webcam Errors</h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
The most common error is a Permission Error as described above, but there are some less common
|
||||||
|
error messages you may experience. Here is a short list of some of them:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<strong>AbortError:</strong> e.g. "Starting videoinput failed"
|
||||||
|
<br><br>
|
||||||
|
A common cause for this error may be that your webcam device is already in use by a different program,
|
||||||
|
so that your web browser was not able to open it. Please make sure that you are not running another video
|
||||||
|
chat program (such as Skype or Zoom) which has your camera active, and try again.
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<strong>NotFoundError</strong> or <strong>NotReadableError</strong>
|
||||||
|
<br><br>
|
||||||
|
This error may indicate that your camera device was not available to your web browser. For example, your
|
||||||
|
webcam might not be plugged in to USB or you may be missing hardware drivers for it. To begin diagnosing
|
||||||
|
this problem, check whether <other>other</other> websites or apps are able to use your camera: if none of
|
||||||
|
them can either, it heavily points toward a hardware or driver error.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Other possible errors should be uncommon. If this troubleshooting guide has not been helpful, try copying
|
||||||
|
the error message into a search engine and find information online: all of the text following "Webcam error:"
|
||||||
|
will be coming from your web browser, so relevant results may be found online. A possible place to start may
|
||||||
|
be the <a href="https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia">Mozilla documentation for getUserMedia.</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h3>Other peoples' webcams don't load</h3>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
It may sometimes happen that you clicked to watch somebody else's webcam on chat, and their video doesn't
|
||||||
|
load. If it only happens with <em>some</em> cameras (but other cameras load correctly), then the problem is
|
||||||
|
most likely on <em>that person's</em> side and not your own: their camera likely doesn't work for anybody
|
||||||
|
else who is trying to watch it, either.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Webcam sharing on the chat room works by "peer to peer" direct connections between chatters. Usually, this
|
||||||
|
tends to "just work" for most people, but sometimes your network connection or firewall can get in the way
|
||||||
|
and prevent a connection from being established.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
The most common kinds of network conditions that cause problems connecting to webcams include:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
If you are on a heavily firewalled network, such as in a school or workplace.
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
If you are on a cellular network, e.g. from a smartphone or tablet. Some cell phone carriers
|
||||||
|
add firewalls to their network to prevent direct peer-to-peer connections with mobile devices.
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
If you are using a Virtual Private Network, or VPN: some VPN providers don't forward the kind
|
||||||
|
of network messages that are needed to establish a peer-to-peer connection.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
For some specific advice:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
If you can not connect to <strong>any</strong> webcam at all (e.g. many people are on webcam but you
|
||||||
|
can not get <strong>any</strong> of them to work): most likely it is because you are on a firewalled
|
||||||
|
network, like those listed above. If you are on a cell network, try switching to WiFi; or if you are
|
||||||
|
using a VPN, try turning off your VPN.
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
If <strong>only one or two webcams</strong> won't open for you, but others on the chat room are working:
|
||||||
|
the problem is likely not on your end! It is likely that the people whose cameras are not working are
|
||||||
|
on a firewalled network, and they are likely having worse problems than you are!
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
If somebody's webcam button has a slash \ through it, like <i class="fa fa-video-slash has-text-info"></i>
|
||||||
|
then it <em>probably</em> means that this person requires <strong>you</strong> to share your webcam first
|
||||||
|
before you can open theirs. You can click on their camera button to see an exact reason why their camera
|
||||||
|
has the \ slash through it.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue
Block a user