Ruby gem for opentok api
Ruby JavaScript
#5 Compare This branch is 18 commits ahead, 1 commit behind kblake:master.
Latest commit 92b79d1 Apr 27, 2012 @stijnster bumped to version 0.0.6
Failed to load latest commit information.
lib bumped to version 0.0.6 Apr 27, 2012
spec added test cases Apr 26, 2012
.gitignore initial commit - ruby gem for opentok Mar 22, 2011
CHANGES bumped to version 0.0.6 Apr 27, 2012
Gemfile initial commit - ruby gem for opentok Mar 22, 2011
LICENCE * moving filestructure to match casing and foldernames Apr 11, 2011 added Apr 24, 2012
Rakefile initial commit - ruby gem for opentok Mar 22, 2011
opentok.gemspec * minor documentation fix Oct 29, 2011


OpenTok is a free set of APIs from TokBox that enables websites to weave live group video communication into their online experience. With OpenTok you have the freedom and flexibility to create the most engaging web experience for your users. OpenTok is currently available as a JavaScript and ActionScript 3.0 library. Check out and for more information.

This is the official Opentok rubygem.


To install using bundler, add Opentok to your gemfile and run bundle install:

gem 'opentok'

To install as a regular gem just type gem install opentok

How to use

API-key and secret

Request your api-key and secret at You can use the staging environment for testing. The gem uses this staging environment by default.


In order to use any of the server side functions, you must first create an OpenTokSDK object with your developer credentials.
You must pass in your Key and Secret. If your app is in production, you must also pass in a hash containing api_url
For more information about production apps, check out

Example: ( Staging )

@api_key = ''                # should be a string
@api_secret = ''            # should be a string
@opentok = @api_key, @api_secret

Example: ( Production )

@opentok = @api_key, @api_secret, :api_url => ''

Creating Sessions

Use your OpenTokSDK object to create session_id
create_session takes 1-2 parameters:

location (string) - give Opentok a hint on where you are running your application
properties (object) - OPTIONAL. Set peer to peer as enabled or disabled

Example: P2P disabled by default

@location = 'localhost'
session_id = @opentok.create_session(@location)

Example: P2P enabled

session_properties = {OpenTok::SessionPropertyConstants::P2P_PREFERENCE => "enabled"}    # or disabled
session_id = @opentok.create_session( @location, session_properties )

Generating Token

With the generated session_id, you can start generating tokens for each user. generate_token takes in hash with 1-4 properties:

session_id (string) - required
role (string) - OPTIONAL. subscriber, publisher, or moderator
expire_time (int) - OPTIONAL. Time when token will expire in unix timestamp
connection_data (string) - OPTIONAL. Metadata to store data (names, user id, etc)


token = @opentok.generate_token :session_id => session, :role => OpenTok::RoleConstants::PUBLISHER, :connection_data => "username=Bob,level=4"

Downloading Archive Videos

To Download archives, first you must first create a token that has a moderator role

Get Archive Manifest

get_archive_manifest() takes in 2 parameters: archiveId and moderator token

returns an OpenTokArchive. The resources property of this object is array of OpenTokArchiveVideoResource, and each OpenTokArchiveVideoResource object represents a video in the archive.

Get video ID

With your OpenTokArchive object, call getId() getId() will return the video ID (a String)

Get Download Url

downloadArchiveURL takes 1 parameters: video ID and returns download URL for the video