timedmeta
Inserts a timed metadata key/value pair into the stream for the asset currently being sliced.
Request body parameters are described below.
Request Parameter | Type | Description |
---|---|---|
key Required | String | Sets the key value of the key/value pair that will be inserted into the stream. |
offset_from_now_ms | Integer | Requires 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_ms | Integer | Identifies a time relative to the start of the current asset, in milliseconds, when an operation will take effect. |
start_timecode | String | Identifies the video frame at which this operation will take effect. |
value Required | String | Set 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 Parameter | Type | Description |
---|---|---|
owner Required | String | Identifies 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_ms | Integer | Requires 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_ms | Integer | Identifies a time relative to the start of the current asset, in milliseconds, when an operation will take effect. |
start_timecode | String | Identifies the video frame at which this operation will take effect. |
value Required | String | Defines 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=="
}