Skip to main content
Skip table of contents

UC Ingest File and Read Technical Metadata

Motivation

When ingesting files to VidiCore we perform an analysis of the imported material to extract technical metadata for the item, known as media check. This is then stored as system metadata on the item.

Example

Doing a regular import of an item:

CODE
POST /import?uri=http://example.com/video.avi

With a body containing some arbitrary metadata

CODE
<MetadataDocument xmlns="http://xml.vidispine.com/schema/vidispine">
      <timespan end="+INF" start="-INF">
         <field>
            <name>title</name>
            <value>This is an imported item!</value>
         </field>
      </timespan>
</MetadataDocument>

Looking at the import job we can see that a MediaCheck step is performed:

CODE
...
<task id="367">
  <step>700</step>
  <attempts>0</attempts>
  <status>FINISHED</status>
  <timestamp>2022-03-02T21:05:20.468Z</timestamp>
  <description>Performing media check.</description>
  <subStep>
    <timestamp>2022-03-02T21:00:07.135Z</timestamp>
    <description>Media checking file: VX-4</description>
  </subStep>
...

And if we now take a look at the imported item we can see that the item has been enriched with the technical metadata

CODE
<timespan start="-INF" end="+INF">
  <field uuid="24e8435b-d4b4-4819-b4ee-3010603ae6ce" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>startSeconds</name>
    <value uuid="13fe0674-9725-42ea-9b4b-7034f7db8a53" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">42255.0</value>
  </field>
  <field uuid="fa4e7bd9-66f0-400d-b517-78f36bc926f0" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>durationSeconds</name>
    <value uuid="12542a15-8092-4c91-a292-7cbaa1ad554e" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">80.84</value>
  </field>
  <field uuid="cabdd9c0-bb9e-4835-b0af-f3d1c5894a9a" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>durationTimeCode</name>
    <value uuid="2bf3a2ae-c745-4293-8121-b91fe3598207" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">2021@PAL</value>
  </field>
  <field uuid="0cea137f-8fbc-43f0-a81f-4e7eb48969bb" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>originalWidth</name>
    <value uuid="86557704-152d-401f-89ac-1da67ed1b543" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">1920</value>
  </field>
  <field uuid="cb08762b-5298-4947-8347-1e0e5fb9e5ef" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>originalHeight</name>
    <value uuid="66896c0f-333e-4cf1-8fa8-a9210094aebb" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">1080</value>
  </field>
  <field uuid="62e5b73f-3b91-491f-8510-5452c71ba234" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>mimeType</name>
    <value uuid="aa5b4180-a196-46e2-985d-88902c2c1a0c" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">video/x-mxf-dnxhd-pcm_s24le</value>
  </field>
  <field uuid="0f817821-f943-4147-88e2-dd0cb950e1b5" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>mediaType</name>
    <value uuid="d5f953ec-284a-4ab4-894b-c39168b1b658" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">video</value>
  </field>
  <field uuid="25d2346c-76dc-4816-be5f-fa7151510d3d" user="admin" timestamp="2022-03-29T10:13:30.983+02:00" change="VX-157">
    <name>title</name>
    <value uuid="264d5a39-6517-41fd-8812-106ce8f5a067" user="admin" timestamp="2022-03-29T10:13:30.983+02:00" change="VX-157">Joined A and B</value>
  </field>
  <field uuid="38c7c9d6-4ebb-4591-831b-172268d6d68a" user="system" timestamp="2022-03-29T10:13:31.077+02:00" change="VX-158">
    <name>created</name>
    <value uuid="1e98ec3b-1ce6-433b-9d13-13a1db347097" user="system" timestamp="2022-03-29T10:13:31.077+02:00" change="VX-158">2022-03-29T08:13:30.950Z</value>
  </field>
  <field uuid="f2b8b475-fc63-4f6f-ac25-ff7a111fc1db" user="system" timestamp="2022-03-29T10:13:31.077+02:00" change="VX-158">
    <name>itemId</name>
    <value uuid="ba3bca87-5753-45ca-8bb6-2f97c0943a7e" user="system" timestamp="2022-03-29T10:13:31.077+02:00" change="VX-158">VX-28</value>
  </field>
  <field uuid="c3b4df80-2650-44a4-81cb-d4fc18a8d124" user="system" timestamp="2022-03-29T10:13:31.164+02:00" change="VX-159">
    <name>shapeTag</name>
    <value uuid="1a268a3e-8f4d-45b9-b9b0-d244028acdf5" user="system" timestamp="2022-03-29T10:13:31.164+02:00" change="VX-159">original-interlaced</value>
    <value uuid="5c342c33-d63b-4308-92c9-44ef89419fef" user="system" timestamp="2022-03-29T10:13:31.164+02:00" change="VX-159">original</value>
  </field>
  <field uuid="ff9950ba-7018-4ad0-839d-3d09e312607e" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>originalFormat</name>
    <value uuid="ef694787-2e92-4cab-a18e-08621be5c928" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">mxf</value>
  </field>
  <field uuid="9ee0543e-dbe1-4e5f-b5d8-ad8ba2d397eb" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>originalVideoCodec</name>
    <value uuid="0471624d-b412-482e-adc9-dbe3ba634cec" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">dnxhd</value>
  </field>
  <field uuid="f7f8845b-8d96-46ee-ac8c-6ea028e93e34" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>originalAudioCodec</name>
    <value uuid="0916beaf-4dd4-4193-bd22-ddbbc6418498" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">pcm_s24le</value>
  </field>
  <field uuid="e7eff386-b00a-4e4a-bfb1-673810eaac30" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">
    <name>startTimeCode</name>
    <value uuid="8f1aa0a5-e93d-473f-a99b-ff5bd82a67f9" user="system" timestamp="2022-03-29T10:26:30.263+02:00" change="VX-162">1056375@PAL</value>
  </field>

Resources

https://apidoc.vidispine.com/latest/item/metadata/metadata.html?#metadata-defined-by-the-systems

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.