Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nextcloud/spreed.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel Calviño Sánchez <danxuliu@gmail.com>2020-05-18 01:13:01 +0300
committerDaniel Calviño Sánchez <danxuliu@gmail.com>2020-05-18 01:13:01 +0300
commitb1cb811b9fc77e68ccce9a6bc0d28fc524de39ce (patch)
tree4c00aa4c2033e49df7d9a43a56a4283705956e7a /docs
parent1fcce25ce345bba07431d99ec7241802b073a53f (diff)
Add documentation about testing the TURN server
In order to know if a TURN server is working it is useful to actually test the data transfer through the TURN server instead of just checking if it generates relay candidates. When an RTCPeerConnection is created an RTCConfiguration can be provided to configure it. One of the values it accepts is "iceTransportPolicy", which can be either set to "all" to gather all types of candidates or to "relay" to only gather relay candidates. Signed-off-by: Daniel Calviño Sánchez <danxuliu@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/TURN.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/TURN.md b/docs/TURN.md
index 5d7cc6a08..e95ce2cae 100644
--- a/docs/TURN.md
+++ b/docs/TURN.md
@@ -100,6 +100,18 @@ simple-log
- The TURN server on `<yourChosenPortNumber>` needs to be accessible for all Talk participants, so you need to open it to the web and if your TURN server is running **behind a NAT**, forward it to the related machine. Also make sure to set the [`--external-ip` option](https://github.com/coturn/coturn/wiki/turnserver#options) when your TURN server is in a private network.
+#### 6. Testing the TURN server
+
+When the TURN server is set in the Talk settings a basic test against the TURN server is performed. You can perform a deeper test by forcing your browser to send the media of a call only through the TURN server:
+
+- Join a call
+- Open your browser console
+- Type `OCA.Talk.SimpleWebRTC.webrtc.config.peerConnectionConfig.iceTransportPolicy = 'relay'` in the console and press Enter
+- Leave the call
+- Join the call again
+
+Now, in that browser, the media sent to and received from other participants in the call should go through the TURN server. If the call works then the TURN server should work.
+
### What else
Nextcloud Talk´s WebRTC handling is still mostly based on the one from the [Spreed.ME](https://www.spreed.me/) WebRTC solution. For this reason, all guides about how to configure coTURN for it, applies to Nextcloud Talk too.