Création d'une session — Python

Vous pouvez utiliser la bibliothèque Python 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 :

import OpenTok

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

opentok_sdk = OpenTok.OpenTok(api_key, api_secret)
session = opentok_sdk.create_session(media_mode=MediaModes.routed)
print 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 Python qui crée une nouvelle session avec le mode média à transmettre :

import OpenTok

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

opentok_sdk = OpenTok.OpenTok(api_key, api_secret)

session = opentok_sdk.create_session()
print 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 Python permettant de créer une session archivée automatiquement :

import OpenTok

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

opentok_sdk = OpenTok.OpenTok(api_key, api_secret)

session = opentok.create_session(media_mode=MediaModes.routed, archive_mode=ArchiveModes.always)
print 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.