Skip to main content

Embed Eyeson video meeting in your website with IFrame API

· 4 min read
Stefan Benicke
Senior Developer @ Eyeson

Using the new IFrame API is the easiest way to embed Eyeson video conferencing into your site or app using a few lines of HTML and Javascript.

  1. Integrate the Eyeson IFrame API script <script src="https://app.eyeson.team/iframe-api.js"></script>
  2. Provide an HTML element as meeting container <div id="meeting"></div>
  3. Call the EyesonIframe function and let the magic happen new EyesonIframe('#meeting', { accessKey: '...' });

IFrame API creates an iframe HTML element with all correct settings and loads Eyeson's default UI.

In advanced mode, methods to interact with Eyeson UI inside the iframe are available, like present, chat, snapshot, and also meeting events for the user like join and leave can be observed.

API playback changes

· 2 min read
Stefan Benicke
Senior Developer @ Eyeson

We've made changes to the playbacks API that you need to be aware of!

tl;dr
  • play_id is generated if omitted
  • playback_update sequence has changed
  • replacement_id takes userId, not clientId
  • EyesonJS (< 1.9.0) react to playback_update if _src: 'actioncable'
  • Update EyesonJS to v1.9.0 (npm or yarn)

Adaptive video layout with example app

· 4 min read
Dugar Enkhtuya
Code Enthusiast

Thanks to the implementation of Custom layout map API in Eyeson, you can now change the layout without having the need for pre-defined layouts provided by us. This has some major upsides regarding the control over the stream content.

In this tutorial we want to use the adaptive layout to arrange users around an image for a seamless presentation.

Example web app

You can instantly update the stream content during a live session using some HTML and Javascript.

This example includes

  • a local image uploading script which draws it on a canvas
  • layout calculation depending on the image size
  • sending canvas and calculated layout to show in Eyeson via AJAX requests

Custom layout map API

· 3 min read
Stefan Benicke
Senior Developer @ Eyeson

Developers are free to create and apply their own custom layout maps whenever they need it! You need a special layout for your app? Just go ahead and create it!

The existing layout endpoint is extended with the new parameter map. The map is a JSON stringified list of box-definition-lists with x, y, width, height, and objectFit definitions for each box.

Here's an example map that places 2 boxes (640x360px) above eachother in the center of the video podium.

[
[320, 0, 640, 360, "auto"],
[320, 360, 640, 360, "auto"]
]

Snapshot API changes

· 3 min read
Stefan Benicke
Senior Developer @ Eyeson

This change affects Custom UIs using Eyeson Javascript or one of the mobile SDKs.

When a new snapshot is created, the update event will only include a list with the latest snapshots instead of all existing snapshots of the current meeting.

caution

The old snapshot behaviour will shut down on 11th of September.

Furthermore, there will be 2 new API endpoints for retrieving the most recent snapshot information.

Customize the meeting video background color via API

· 2 min read
Stefan Benicke
Senior Developer @ Eyeson

We provide the new option background_color to let you customize the meeting video background color to your needs.

The option is only available on the meeting start request, see API room reference. It can not be changed during the meeting.

The following example shows how to use the new option with curl.

$ curl -X POST \
-H "Authorization: YOUR_API_KEY" \
-d "user[name]=John Doe" \
-d "options[background_color]=#121212" \
https://api.eyeson.team/rooms