This following JSON template is followed by all applications involved in ingesting Video Clip metadata.
JSON clip data template
|
Field Name
* - required |
Description
|
|---|---|
| assetId* | Unique LVS Asset ID for the video that contains this clip. |
| startTime* | Offset, in milliseconds, where the clip begins. |
| endTime* | Offset, in milliseconds, where the clip ends. |
|
payload.category* |
The type of content contained within this clip. Standard clip categories are FACE, TRANSCRIPT, TAG, TOPIC, KEYWORD. You can map these categories to your original data however you'd like. For example: you might use “FACE” to indicate a player whenever he’s on screen, or use “TAG” to indicate a specific event (e.g. goal or penalty). |
| payload.indexerType |
Use this field to indicate where the data came from, e.g. “GameData”, “CloseCaptioning”, etc. |
| payload.payloadId |
Use this to reference the record ID from the original data source (e.g. the unique ID Optidata used for a specific event). This ID might be something you use to synchronize changes that occur in your original data source with your Linius search clip data. |
| payload.value* | The value (i.e. text string) that you want to be searchable. (E.g. a person's name, transcript text, etc.). |
| payload.confidence | Use this optional field to store an optional AI/ML confidence score as a value between 0-1 (e.g. a value of ".97" for an AI-derived topic may indicate that the AI service is 97% confident that it is an accurate interpretation.) |
| payload.additionalProperties | Use this field for any additional information that you may want to appear within your application's user interface (e.g. a biography that appears alongside a FACE search result). |
Using Search V4 Clip Example
{
// required
"assetId": "1234",
"startTime": 2000, // Time in milliseconds clip starts within the asset
"endTime": 6000, // Time in milliseconds clip ends within the asset
// optional
"title": "An Awesome Clip",
"tags": ["Demo", "Example", "Video Clip"]
"timestamp": 946684800, // UTC wall clock time (unix epoch), used for date range filtering "external_id": "5678", // ID of asset within a third-party system, multiple IDs should be concatenated e.g. `123|abc` "<additional_fields>":
"A field" // additional fields, can be string or a number, multiple values should be within an array
}
Using Search V3 Clip Example
{
"requests": [
{
"assetId": "95716",
"endTime": 200365,
"payload": [
{
"category": "TRANSCRIPT",
"indexerType": "DataSourceX",
"payloadId": "SourceDataOriginalClipID1",
"value": "The Spear-Danes in days gone by and the kings who ruled them had courage and greatness.",
"additionalProperties": {}
}
],
"startTime": 5
},
{
"assetId": "95670",
"endTime": 1800,
"payload": [
{
"category": "Keyword",
"indexerType": "DataSourceX",
"payloadId": "OriginalClipSourceID2",
"value": "king",
"additionalProperties": {}
}
],
"startTime": 1005
}
]
}
Comments
0 comments
Article is closed for comments.