close search

OpenTok iOS SDK

The OpenTok iOS SDK lets you use OpenTok-powered video sessions in apps you build for iPad, iPhone, and iPod touch devices.
API reference     Download     Samples     Release Notes

This SDK interoperates with apps that use the following client SDKs:

Using the SDK

The OpenTok.framework directory contains the OpenTok iOS SDK.

The OpenTok iOS SDK is available as the Pod "OpenTok", for use with CocoaPods.

The OpenTok iOS SDK requires Xcode 5+.

The OpenTok iOS SDK requires the following frameworks:

Do not use the -all_load linker flag. Instead, use the -force_load linker flag to load specific libraries that require it.

The OpenTok iOS SDK links to the libc++ standard library. If another library that links to the libc++ standard library was compiled in a version of Xcode older than 6.0.0, it may result in segfaults at run time when using it with the OpenTok iOS SDK. Known incompatible libraries include, but are not limited to, Firebase (versions earlier than 2.1.2 -- see and Google Maps (versions earlier than 1.9.0). To fix this issue, download a version of the other library that was compiled using XCode 6.0.0 or later.

See the release notes for information on the latest version of the SDK and for a list of known issues.

See this document for information on using the SDK in apps running in the background mode.

System requirements

The OpenTok iOS SDK is supported on the following devices:

The OpenTok iOS SDK is supported in iOS 6+.

The OpenTok iOS SDK is supported on Wi-Fi and 4G/LTE connections.

The OpenTok iOS SDK supports one published audio-video stream, one subscribed audio-video stream, and up to three additional subscribed audio-only streams simultaneously. (This is the baseline support on an iPhone 4S.) To connect more than two clients in a session using the OpenTok iOS SDK, create a session that uses the OpenTok Media Router (a session with the media mode set to routed). See The OpenTok Media Router and media modes.

Sample apps

For sample code, go to the opentok-ios-sdk-samples repo at GitHub.


Reference documentation is included in the docs subdirectory of the SDK and at

More information

For a list of API and changes and user interface changes from version 2.1.7 of the OpenTok iOS SDK, see Migrating to the latest version of the OpenTok SDK.

For a list of new features and known issues, see the release notes.