13 posts tagged with "API"

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

Virtual situation rooms are a quick way to build a command and control structure, and since they are virtual, they do not require physical space and can be created in large numbers to give teams room to collaborate.

Welcome to a series of posts​

I will guide you through creating a virtual situation room in this series. It will have the following episodes.

1. Creating a virtual situation room Creating rooms, different kinds of users
2. Connecting the virtual situation room Inviting participants, adding sources
3. Optimize the layout Custom Layout
4. Permalink rooms Different usage, standard ops only?

Finally, developers are able to create pre-defined meeting rooms, get sharable guest-links, and start the meeting whenever needed with the same permanent links!

Share a meeting link, before the meeting has even being started!

POST /permalink
HEADERS Authorization

user[name]=<host-user-name>
# options[exit_url] and many more options

This will give you all the links you need.

{
  //...
  "links": {
    "gui": "https://app.eyeson.team/permalink?9clgjJXl1NzbcmF5vfXWhAVJ",
    "guest_join": "https://app.eyeson.team/permalink?guest=R2SdUxiqKhpBoUu0oi0pZZkZ"
  }
}

We're adding a new way for developers to receive information about a meeting in real-time!

Introducing the "Meeting Observer", a one-way WebSocket connection that allows to boost your application's meeting controls.

It is easier to use than the existing WebHooks and even more powerful, since a lot more information can be observed.

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

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

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"]
]

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.

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

Some key advantages of Eyesons MCU+ are that all participants see the same and the video stream can contain additional visuals and data. That means, you can choose one of the provided layouts and show images in the background and foreground layers.

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