MyCujoo LiveServices logo



Product & Features

Getting started


API Documentation


Key concepts on this page: Annotations and Annotation sets

Similar to real life, everything in MCLS happens at a specific time on a timeline. And as per real life, these moments can be called something. In MCLS, they are called annotations.

Annotations can be anything that happens at a specific time, for example, a goal during a football match, a break during a keynote event, or even the start of a new chapter in an audiobook. In its simplest form, an annotation contains two pieces of information, a title and a time at which the annotation occurred.

Here are a few examples of annotations:

With this information, it's clear to identify all the individual ‘moments’ that occurred throughout a specific event.

Grouping annotations into sets

More often than not, you will end up with multiple annotations that are unique to a specific type of video content. In MCLS, you can group your annotations into sets, and give each set a unique name.

For example, Kickoff, Half time, Full time, Goal and Penalty are annotations related to football, and can be grouped in an annotation set called “Football match”. Similarly, Press Conference Start, Press Conference End, Display Sponsors, Display Reporter name can be grouped in a set called “Press conference”.

MCLS comes with a set of "Basic" annotations ready for production use, and perfect for experimenting with annotations. Tagging your events with annotations from the basic set, or your own annotations is done using the Annotation Manager in the console. To try out annotations in real-time, create an event, go to the Annotation Manager, and start playing around.

Why use annotations?

In addition to creating a timeline of events during a live stream, annotations can also trigger multiple actions. By using multiple actions, you can specify the exact behaviour for each annotation and your requirements.

Let's look at the football annotations mentioned earlier and assign some actions to each of them:

With no limitations on the number of actions you can use for each annotation and our continually growing library of configurable actions, you can deliver relevant event information on your live streams, at the moment when it matters.

What to read next

Create and configure custom annotations

Read more