Skip to main content

Introducing API Image Sources

· 2 min read
Stefan Benicke
Stefan Benicke
Senior Developer @ Eyeson

We're excited to introduce Image Sources, a new REST API endpoint for adding images as additional video spots in Eyeson meetings.

Whether it's a company logo, presentation slide, floor plan, status board, or periodically updated camera snapshot, Image Sources make it easy to bring visual content into a meeting alongside participants. If you've already worked with the Playback API, you'll feel right at home - the concept is very similar, but designed for images instead of videos.

Example​

Image Sources can be created from either a public URL or an uploaded image file. URL-based images may also be refreshed automatically at a configurable interval, making them ideal for dynamically generated content.

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "url":"https://example.com/dashboard.png",
    "name":"Live Dashboard",
    "object_fit":"contain",
    "refresh_interval":30
  }' \
  "https://api.eyeson.team/rooms/$ACCESS_KEY/image_sources"

Once created, an image source remains part of the meeting until it's removed via the API.

Image Sources can optionally be assigned an image_source_id, allowing them to be updated in place or referenced from Meeting Layouts to keep images at fixed positions.

For a complete overview of all parameters and examples, see the Image Sources documentation.

Stay in Sync​

Applications using the Meeting Observer API can listen for the new image_source_update event. Whenever image sources are added, updated, or removed, the observer receives the complete list of active image sources, making it easy to keep clients synchronized with the meeting state.

We'd Love Your Feedback​

We're excited to see how you'll use Image Sources in your applications. If you have ideas, questions, or feedback, let us know on our GitHub issue board:

https://github.com/eyeson-team/api/issues

Thanks for building with Eyeson!