Chunk

A chunk represents one single part of a job. Some video servers feature chunk recording: a single recording job is split into several smaller recording jobs. In cases where the job is not split into chunks, only one chunk is present for the booking. For recording jobs, the chunk corresponds to the recorded file and is represented as an item in VidiCore. A chunk is also the core part of a recording, all recording related commands are attached to it as a command sequence.

Properties

Property	Possible Values	Example	Description	Writeable?
id	string	0B	External ID of the chunk.	Read only. Created by VidiControl.
vcItemId	string	ITEM-VX-39	ID of the associated item in VidiCore.	Read only.
metadata	string (JSON)	JSON `{ "timespan": [ { "field": [ { "name": "V3_Metadata1", "id": null, "value": [ { "value": "my metadata 1 value" } ] }, { "name": "title", "id": null, "value": [ { "value": "my bookingdef title" } ] } ], "start": "-INF", "end": "+INF" } ] }`	Metadata fields and values to set in VidiCore. The structure of the JSON document is similar to VidiCore metadata documents.	Write only. Set values are only known in VidiCore and not fetched when a chunk is requested.
start	string (DateTime using the universal sortable date/time pattern)	2023-01-04T16:40:27.67Z	Start of the actual recording.	Read and write.
end	string (DateTime using the universal sortable date/time pattern)	2023-01-04T17:40:27.67Z	End of the actual recording.	Read and write.
executionState	string, (“Pending”, “InProgress”, “Done” or “Error”)	Pending	Status of the recording.	Read only.
title	string	RecordingTitle	Title of the recording. Currently, this is only used for VidiControl. No synchronisation with VidiCore is done, so it should be set to the same value as the title in the metadata property.	Read and write. Currently not synchronized with VidiCore (See description).
clipId	string	qa444r	External clip ID on the recorder.	Read only.
commandList	Array of command items	see Command	List of the commands that should be executed during and for the recording of this chunk.	Read and write.

Sample JSON Snippet

JSON

{
  "id": "V4",
  "commandList": [],
  "vcItemId": "ITEM-VX-123",
  "metadata": "{\"timespan\": [{\"field\": [{\"name\": \"V3_Metadata1\",\"id\": null,\"value\": [{\"value\": \"my metadata 1 value\"}]}, {\"name\": \"title\",\"id\": null,\"value\": [{\"value\": \"my bookingdef title\"}]}],\"start\": \"-INF\",\"end\": \"+INF\"}]}",
  "start": "2023-02-14T08:19:56.251734Z",
  "end": "2023-02-14T09:19:58.251734Z",
  "executionState": "Error",
  "title": "Nice Title",
  "clipId": null
}