You can use the OpenTok Python library to generate OpenTok sessions. Each session has a unique session ID, which you can use in an OpenTok client library to connect to an OpenTok session. (See "Joining a Session" for Web, iOS, or Android.)
The following code session that uses the 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
Use the session ID in an OpenTok client library to connect to an OpenTok session.
You will also need to generate a token for each user connecting to the OpenTok session.
See Connection Token Creation for information on
the generate_token()
method.
The OpenTok Media Router provides the following benefits:
Here is Python sample code that creates a new session with the media mode set to relayed:
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
In a relayed session, clients will attempt to send streams directly between each other. However, if clients cannot connect due to firewall restrictions, the session uses the OpenTok TURN server to relay audio-video streams.
Important: Some features, such as archiving, are only available in routed (not relayed) sessions. See the previous section for instructions on creating a routed session.
You can create a session that is automatically archived. Here is Python sample code that creates an automatically archived session:
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
Note that archived sessions must use the routed media mode.
For more information, see the archiving developer guide.
Use the session ID in an OpenTok client SDK to connect to an OpenTok session.
You will also need to generate a token for each user connecting to the OpenTok session.
See Connection Token Creation for information on
the generate_token()
method.