RTCIceServer

RTCIceServer définit comment se connecter à un serveur ICE unique (comme un serveur STUN ou TURN). Il comprend à la fois l'URL et les éventuelle informations d'identification nécessaires pour se connecter au serveur.

credential (en-US) Facultatif

Les informations d'identification à utiliser lors de la connexion au serveur. Celles‑ci sont utilisées uniquement si RTCIceServer est un serveur TURN.

credentialType (en-US) Facultatif

Si RTCIceServer est un serveur TURN, cet attribut spécifie quel type d'information d'identification doit être utilisé lors de la connexion. Ce doit être l'une des valeurs définies par l'énumération RTCIceCredentialType (en-US). La valeur par défaut est password.

url (en-US)

Cette propriété obsolète est une chaîne spécifiant l'URL d'un serveur ICE unique. Ne pas utiliser cette propriété; utiliser plutôt RTCIceServer.urls (en-US). Étant donné que de nombreux livres et exemples anciens l'utilisent encore, nous l'incluons pour aider les développeurs à mettre à jour leur code ou donner un sens a des exemples plus anciens.

urls (en-US)

Cette propriété est obligatoire, elle peut être soit une seule DOMString ou un tableau de DOMString , spécifiant chacun une URL qui peut être utilisée pour se connecter au serveur.

username (en-US) Facultatif

Si RTCIceServer est un serveur TURN, alors ceci est le nom d'utilisateur à utiliser pendant le processus d'authentification.

Évitez de spécifier un nombre inutilement élevé d'URL dans la propriété urls; le temps de démarrage de votre connexion va augmenter sensiblement. Chaque serveur dans la liste sera contacté et testé avant d'en choisir un pour être utilisé pour la négociation.

L'enumeration RTCIceCredentialType spécifie les valeurs qui peuvent être renvoyés par la propriété credentialType pour définir quel type d'authentification est fournie dans la propriété RTCIceServer.credential (en-US). Cela peut être l'une des valeurs ci‑dessous.

La configuration ci-dessous établit deux serveurs ICE. Le premier, stun:stun.services.mozilla.com, nécessite une authentification, le nom d'utilisateur et le mot de passe sont donc fournis. Le second serveur a deux URLs : stun:stun.example.com et 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);

Une fois l'objet de configuration créé, il est passé dans le constructeur RTCPeerConnection() (en-US) pour l'utiliser comme configuration de la nouvelle connexion entre pairs.

• RTCPeerConnection
• RTCConfiguration (en-US)
• Durée de vie d'une session WebRTC
• Connectivité WebRTC