Création d'une session — Ruby

Vous pouvez utiliser la bibliothèque Ruby d'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

Le code suivant permet de créer une session utilisant OpenTok Media Router :

api_key = "your_API_key"        # Replace with your OpenTok API key.
api_secret = "your_API_secret"  # Replace with your OpenTok API secret.

opentok = OpenTok::OpenTok.new api_key, api_secret
session = opentok.create_session :media_mode => :routed
session_id = session.session_id

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 generate_token() 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. (Dans une session à relais, chaque client doit envoyer un flux audio-vidéo distinct à chaque client qui y est abonné.)
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 Ruby qui crée une nouvelle session avec le mode média à transmettre :

api_key = "your_API_key"        # Replace with your OpenTok API key.
api_secret = "your_API_secret"  # Replace with your OpenTok API secret.

opentok = OpenTok::OpenTok.new api_key, api_secret
session = opentok.create_session
session_id = session.session_id

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

api_key = "your_API_key"        # Replace with your OpenTok API key.
api_secret = "your_API_secret"  # Replace with your OpenTok API secret.

opentok = OpenTok::OpenTok.new api_key, api_secret
session = opentok.create_session :archive_mode => :always, :media_mode => :routed
session_id = session.session_id

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.