UC Ingest File and Read Technical Metadata [C IG]

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