RTCIceServer

Οι εθελοντές μας δεν έχουν μεταφράσει αυτό το άρθρο στα Ελληνικά, ακόμα. Γίνετε μέλος και βοηθήστε στη μετάφραση!
Μπορείτε επίσης να διαβάσετε το άρθρο στα English (US).

The RTCIceServer dictionary defines how to connect to a single ICE server (such as a STUN or TURN server). It includes both the URL and the necessary credentials, if any, to connect to the server.

Properties

credential Optional
The credential to use when logging into the server. This is only used if the RTCIceServer represents a TURN server.
credentialType Optional
If the RTCIceServer represents a TURN server, this attribute specifies what kind of credential is to be used when connecting. This must be one of the values defined by the RTCIceCredentialType enum. The default is password.
urls
This required property is either a single DOMString or an array of DOMStrings, each specifying a URL which can be used to connect to the server.
username Optional
If the RTCIceServer is a TURN server, then this is the username to use during the authentication process.

Avoid specifying an unnecessarily large number of URLs in the urls property; the startup time for your connection will go up substantially. Every server in the list will be contacted and tried out before one is selected to be used for negotiation.

Older versions of the WebRTC specification included an url property instead of urls; this was changed in order to let you specify multiple addresses for each server in the list, as shown in the example below.

Obsolete properties

The following properties have been removed from the specification and should not be used.

url
This obsolete property is a string specifies a single ICE server's URL. Do not use this property; use urls instead. Because many older books and examples still use this, we include it to help developers update their code or make sense of older examples.

Example

The configuration below establishes two ICE servers. The first one, stun:stun.services.mozilla.com, requires authentication, so the username and password are provided. The second server has two URLs: stun:stun.example.com and stun:stun-1.example.com.

var configuration = { iceServers: [{
                          urls: "stun:stun.services.mozilla.com",
                          username: "louis@mozilla.com", 
                          credential: "webrtcdemo"
                      }, {
                          urls: [
                                  "stun:stun.example.com",
                                  "stun:stun-1.example.com"
                          ]
                      }]
};

var pc = new RTCPeerConnection(configuration);

Once the configuration object has been created, it is passed into the RTCPeerConnection() constructor to use it as the configuration for the new peer connection.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
RTCIceServerChrome Full support YesEdge ? Firefox Full support 22IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android Full support YesFirefox Android Full support 24Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes
credentialChrome Full support YesEdge ? Firefox Full support 22IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android Full support YesFirefox Android Full support 24Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes
credentialTypeChrome Full support YesEdge ? Firefox Full support 47IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android Full support YesFirefox Android Full support 47Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes
url
Deprecated
Chrome Full support YesEdge ? Firefox Full support 22IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android Full support YesFirefox Android Full support 24Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes
urlsChrome Full support YesEdge ? Firefox Full support 37IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android Full support YesFirefox Android Full support 37Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes
usernameChrome Full support YesEdge ? Firefox Full support 23IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android Full support YesFirefox Android Full support 24Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.

See also

Εθελοντές και ετικέτες εγγράφου

Συνεισφέροντες σε αυτή τη σελίδα: Sheppy, mdnwebdocs-bot, fscholz, zarvox
Τελευταία ενημέρωση από: Sheppy,