Timed Metadata

timedmeta

Inserts a timed metadata key/value pair into the stream for the asset currently being sliced.

Request body parameters are described below.

Request ParameterTypeDescription
key RequiredStringSets the key value of the key/value pair that will be inserted into the stream.
offset_from_now_msIntegerRequires Live Slicer version 17061500 or higher. Identifies a time relative to now (local system time), in milliseconds, when an operation will take effect.
offset_time_msIntegerIdentifies a time relative to the start of the current asset, in milliseconds, when an operation will take effect.
start_timecodeStringIdentifies the video frame at which this operation will take effect.
value RequiredStringSet the value element of the key/value pair that will be inserted into the stream.

Sample request:

POST /timedmeta HTTP/1.1

{
	"start_timecode": "00:15:21;09",
	"key": "myKey",
	"value": "myValue"
}

The timedmeta endpoint may also be used to insert PRIV metadata with the following parameters:

Request ParameterTypeDescription
owner RequiredStringIdentifies the organization that owns a video frame by either of the following: A URL containing an email address. A link to a location where an email address can be found. Please refer to section 4.27 of the ID3v2.4.0 specification for more information.
offset_from_now_msIntegerRequires Live Slicer version 17061500 or higher. Identifies a time relative to now (local system time), in milliseconds, when an operation will take effect.
offset_time_msIntegerIdentifies a time relative to the start of the current asset, in milliseconds, when an operation will take effect.
start_timecodeStringIdentifies the video frame at which this operation will take effect.
value RequiredStringDefines the base64-encoded data that will be contained by the PRIV frame.

Sample request:

POST /timedmeta HTTP/1.1

{
	"start_timecode": "00:15:21;09",
	"type": "PRIV",
	"owner": "http://example.com",
	"value": "bXlWYWx1ZQ=="
}