Quick start

It's easy to run Accurate.Video Validate using launch templates. In fact, if you have tried our demo you have already used them!

https://apps.accurate.video/launch/validate?launchTemplate=https://apps.accurate.video/assets/json/default-template.json

You can examine the launch template by adding the query parameter manual to the url.

https://apps.accurate.video/launch/validate?launchTemplate=https://apps.accurate.video/assets/json/default-template.json&manual

Opening the link above will take you to the launch template editor view. The editor view displays the launch template and allows you to modify the different configurations of the launch template, like changing the media, adding markers and so on.

note

Read more about the launch template format in the reference documentation.

Configure media

Let's change the media from Sintel to Tears Of Steel, starting with the video.

{
  "type": "VIDEO",
  "url": "https://accurate-player-static.s3.eu-central-1.amazonaws.com/TearsOfSteel/TearsOfSteel.mp4",
  "metadata": [
    {
      "key": "filename",
      "value": "Tears Of Steel"
    },
    {
      "key": "language",
      "value": "en"
    }
  ]
}

We just replace the url. Accurate.Video Validate will analyze the file and extract information such as frame rate and duration.

Next we change the discrete audio file. This file is actually not necessary since the video already has muxed audio but we'll keep it for demonstration purposes.

{
  "url": "https://accurate-player-static.s3.eu-central-1.amazonaws.com/TearsOfSteel/audio/en-US.wav",
  "type": "AUDIO",
  "metadata": [
    {
      "key": "filename",
      "value": "Tears Of Steel (Stereo)"
    }
  ],
  "container": {
    "audioStreams": [
      {
        "channels": 2
      }
    ]
  }
}

Again, we just replace the url. Audio files are not analyzed so we need to provide a channel count, but the new file is also a stereo.

We add two subtitles providing the correct container format.

{
  "type": "SUBTITLE",
  "url": "https://accurate-player-static.s3.eu-central-1.amazonaws.com/TearsOfSteel/subtitles/TOS-en.vtt",
  "metadata": [
    {
      "key": "filename",
      "value": "Tears Of Steel (English)"
    }
  ],
  "container": {
    "format": "vtt"
  }
},
{
  "type": "SUBTITLE",
  "url": "https://accurate-player-static.s3.eu-central-1.amazonaws.com/TearsOfSteel/subtitles/TOS-de.vtt",
  "metadata": [
    {
      "key": "filename",
      "value": "Tears Of Steel (German)"
    }
  ],
  "container": {
    "format": "vtt"
  }
}

Try it out

Configure markers

A marker always belongs to a marker track within a marker group. So before we can add markers we must define groups and tracks. Let's replace the entire markerGroups array and build a new one from scratch. We start with a group of manual markers.

{
  "markerGroups": [
    {
      "title": "Manual markers",
      "markerTracks": [
        {
          "title": "Info",
          "markerStyle": {
            "backgroundColor": "#4b6db4"
          }
        },
        {
          "title": "Warning",
          "markerStyle": {
            "backgroundColor": "#ffd635"
          }
        },
        {
          "title": "Error",
          "markerStyle": {
            "backgroundColor": "#c83635"
          }
        }
      ]
    }
  ]
}

We don't provide any markers for this group, the intention is to create them from within Accurate.Video Validate.

We add another group to show AI generated data.

{
  "title": "AI",
  "markerStyle": {
    "backgroundColor": "#ff9900"
  },
  "readOnly": true,
  "markerTracks": [
    {
      "title": "Person",
      "markers": [
        {
          "start": {
            "frame": 601,
            "numerator": 24,
            "denominator": 1
          },
          "end": {
            "frame": 966,
            "numerator": 24,
            "denominator": 1
          },
          "metadata": [
            {
              "key": "name",
              "value": "Person"
            },
            {
              "key": "description",
              "value": "Confidence 99.1%"
            }
          ]
        }
      ]
    }
  ]
}

This group is read only, which is normally the case for generated markers. The markerStyle and readOnly properties are defined on group level but will propagate down to the tracks.

The marker has a start and end point defining its position and an array of metadata fields describing the content. The default metadata fields you can use are name and description.

Try it out

Configure settings

Accurate.Video Validate allows for customization using the settings block in the launch template.

{
  "data": [
    ...
  ],
  "settings": {
    "videoFileDisplay": "%filename",
    "audioFileDisplay": "%filename (%channels channels)",
    "subtitleFileDisplay": "%filename"
  }
}

In the example above we configure the labels which are displayed in the Accurate.Video Validate interface which results in the following:

Next step

You've seen how to modify a launch template to configure media, markers and settings. Next step is to learn how to launch Validate with a custom template.