Gruveo Embed API for Web - Gruveo for Developers

Gruveo Embed API for Web

The Embed API lets you add a Gruveo embed to your page and control the embed using JavaScript. Using the methods exposed by the API, you can make the embed perform functions like starting or ending a call. You can also add event listeners that will get triggered in response to certain embed events, such as a state change.

Below is an example of a basic Gruveo embed with a pre-populated room name. (For more, check out the Examples section.)

Supported Platforms and Compatibility

Gruveo must be embedded in an HTTPS page of your web application. Due to security restrictions in certain browsers (e.g. Chrome), the embed WILL NOT work if inserted in a non-secure HTTP page.

The Embed API supports the following devices and platforms:

  • Desktop or laptop
    • Chrome, Firefox and Opera on Windows, Mac and Linux
    • Microsoft Edge on Windows (experimental support, requires setting the enableedgesupport parameter)
    • Safari 7+ on Mac with Temasys plugin installed
  • Android phones and tablets
    • Chrome, Firefox and Opera

Safari 11 enforces a same origin policy for camera and microphone access in iframes. Accordingly, the Embed API does not work in Safari 11 on macOS or Safari in iOS 11. However, the Embed API supports Safari 7+ on macOS with the Temasys plugin installed.

Exploring Further

Use the table of contents to the right to dig deeper and learn how to use the Gruveo Embed API to add video and voice calling functionality to your web app.