Suggestions

close search

Safari Browser Support

Safari now supports WebRTC, and you can now use OpenTok.js apps in Safari 11 for macOS and Safari on iOS 11.

In non-Safari OpenTok projects, Safari clients can use OpenTok, but without video support and with other limitations. See the list of limitations for details.

If you would like to see the OpenTok.js in action in Safari, see our demo.

In order to use OpenTok.js in Safari, follow these steps:

Additional resources:

Step 1: Creating a Safari OpenTok project

  1. If you don’t already have a TokBox account, sign up for a free trial (no credit card required).
  2. Log into your TokBox Account page.
  3. In the top of the page, click the Create Safari Project button.

    This generates an OpenTok API Key and API secret for your project, with support for Safari. You will need these credentials when developing your application.

Step 2: Setting up your application to use Safari

  1. Be sure your code loads v2.12 or later of OpenTok.js. Note that loading the following script loads the latest version of OpenTok.js v2:

    https://static.opentok.com/v2/js/opentok.min.js
  2. Ensure that all OpenTok session IDs and tokens being used in your application are generated from your new Safari project.

    If you already have a server component generating your connection credentials, you’ll need to update your server code to use your the Safari project API Key and API Secret. Otherwise you can generate session IDs and tokens manually from your Safari project page or set up an authentication server using the OpenTok server SDKs and your new project credentials.

If you’re building a new OpenTok web application, you can follow the Set up a Basic Web Client Tutorial to build a basic video chat application with OpenTok, then make the same adjustments as above. You can also view the pre-made demo if you would like to see the new functionality without your own application.

Step 3: Testing your application with Safari

The adjustments made above only work in Safari 11 on macOS and in Safari on iOS 11.

Important: A project using the OpenTok.js does not work with older versions of Safari.

Once you’ve installed the supported version, load your application in Safari to test it out. The application will also be compatible with Chrome, Firefox, apps using the OpenTok iOS v2.12 and later, and apps using the OpenTok Android 2.13-beta on reference Android devices (Samsung Galaxy S6, S7 and S8, Huawei Honor 8, and Google Pixel).

Demo

View the OpenTok Safari demo

Limitations

The following are limitations in OpenTok Safari projects:

You can use Safari in non-Safari OpenTok projects, with the following limitations:

Also, keep in mind these issues when developing in Safari (for any OpenTok project):