Création d'une session — Java

Vous pouvez utiliser la bibliothèque Java OpenTok pour 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

Voici un extrait de code utilisant OpenTok Media Router :

// Set the following constants to your OpenTok API key and API secret.
// See /account/.
OpenTok sdk = new OpenTok(API_KEY, API_SECRET);
SessionProperties sessionProperties = new SessionProperties.Builder()
  .mediaMode(MediaMode.ROUTED)
  .build();
Session session = sdk.createSession(sessionProperties);
String sessionId = session.getSessionId();

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 Java qui crée une nouvelle session avec le mode média à transmettre :

// Set the following constants to your OpenTok API key and API secret.
// See /account/.
OpenTok sdk = new OpenTok(API_KEY, API_SECRET);
Session session = sdk.createSession();
String sessionId = session.getSessionId();

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 Java permettant de créer une session archivée automatiquement :

Session session = opentok.createSession(new SessionProperties.Builder()
  .mediaMode(MediaMode.ROUTED)
  .archiveMode(ArchiveMode.ALWAYS)
  .build());
String sessionId = session.getSessionId();

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.