Création d'une session — Node.js

Vous pouvez utiliser la bibliothèque OpenTok pour Node.js afin de créer des sessions OpenTok. Chaque session dispose d'un identifiant unique, que vous pouvez utiliser dans une bibliothèque cliente OpenTok pour vous connecter à une session OpenTok. (Voir « Rejoindre une session » pour Web, iOSou Android.)

Création d'une session utilisant OpenTok Media Router

Le code Node.js suivant crée une session qui utilise OpenTok Media Router :

var opentok = new OpenTok(API_KEY, API_SECRET);
var sessionId;
opentok.createSession({mediaMode:"routed"}, function(error, session) {
  if (error) {
    console.log("Error creating session:", error)
  } else {
    sessionId = session.sessionId;
    console.log("Session ID: " + sessionId);
  }
});

Utilisez l'identifiant de session dans une bibliothèque cliente OpenTok pour vous connecter à une session OpenTok.

Vous devrez également générer un jeton pour chaque utilisateur se connectant à la session OpenTok. Voir Création d'un jeton de connexion pour plus d'informations sur le generateToken() méthode.

Les Routeur multimédia OpenTok offre les avantages suivants :

Le routeur multimédia OpenTok permet de réduire la consommation de bande passante lors des sessions multipartites. (Lorsque la propriété `mediaMode` est définie sur `MediaMode.RELAYED`, chaque client doit envoyer un flux audio-vidéo distinct à chaque client qui s'y abonne.)
Le routeur multimédia OpenTok permet d'améliorer la qualité de l'expérience utilisateur grâce à repli audio et récupération vidéo. Grâce à ces fonctionnalités, si la connexion d'un client se détériore au point de ne plus permettre la lecture de la vidéo d'un flux auquel il est abonné, la vidéo est interrompue pour ce client (sans affecter les autres clients), et celui-ci ne reçoit alors que le son. Si la connexion du client s'améliore, la vidéo reprend.
Le routeur multimédia OpenTok prend en charge le fonction d'archivage, qui vous permet d'enregistrer, de sauvegarder et de consulter des sessions OpenTok.

Création d'une session relayée

Voici un exemple de code Node.js qui crée une nouvelle session avec le mode média à transmettre :

var opentok = new OpenTok(API_KEY, API_SECRET);
var sessionId;
opentok.createSession({mediaMode:"relayed"}, function(error, session) {
  if (error) {
    console.log("Error creating session:", error)
  } else {
    sessionId = session.sessionId;
    console.log("Session ID: " + sessionId);
  }
});

Dans une session avec relais, les clients tentent d'échanger des flux directement entre eux. Toutefois, si les clients ne parviennent pas à se connecter en raison de restrictions imposées par un pare-feu, la session utilise le serveur TURN d'OpenTok pour acheminer les flux audio et vidéo.

Important : Certaines fonctionnalités, telles que l'archivage, ne sont disponibles que dans les sessions acheminées (et non relayées). Reportez-vous à la section précédente pour savoir comment créer une session acheminée.

Création d'une session archivée automatiquement

Vous pouvez créer une session qui sera automatiquement archivée. Voici un exemple de code Node qui permet de créer une session archivée automatiquement :

opentok.createSession({mediaMode:'routed', archiveMode:'always'}, function(err, session) {
  if (error) {
    console.log("Error creating session:", error)
  } else {
    sessionId = session.sessionId;
    console.log("Session ID: " + sessionId);
  }
});

Veuillez noter que les sessions archivées doivent utiliser le mode « routed media ».

Pour plus d'informations, voir le archivage guide du développeur.

Utilisation des sessions dans les applications clientes

Utilisez l'identifiant de session dans un Client SDK OpenTok pour se connecter à une session OpenTok.