FTP Manifest

This document illustrates some of the capabilities of the FTP manifest workflow.  For more detailed information on these capabilities, please contact support@3playmedia.com.

In the examples below we assume that the project_id is 99887766.  The project_id is a required attribute of the top-level XML element, which must a "threeplaymedia_file_manifest".

Media files should be uploaded to an FTP folder named “hold_for_manifest”. This will park the media assets, and they will not enter the 3Play system until a manifest is uploaded to describe what services you would like to order.

Manifests contain XML markup, and the names of the manifests themselves should be unique. The manifest file must use a “.manifest” extension. For example, “my_upload_92015979219160803.manifest”.  Manifests may be uploaded to any FTP folder, as long as all pathnames are relative to the manifest location.

Example 1: Order English transcription with rush turnaround level:

<?xml version="1.0"?>

<threeplaymedia_file_manifest project_id=“99887766">

<notify email=“yourname@gmail.com"/>

<media_file>

<source_location>batch_254/hold_for_manifest/dogs_playing_in_the_park.mp4</source_location>

<name>Dogs Playing in the Park</name>

<video_id>Zyx4329ds_ffds393686</video_id>

<linked-account-id>25689</linked-account-id>

<folder-name>Pet Videos</folder-name>

<description>This is a video about puppies.</description>

<callback_url>https://my_callback_url/Zyx4329ds_ffds393686</callback_url>

<attribute1>pets</attribute1>

<attribute2>dogs</attribute2>

<attribute3>playing</attribute3>

<order>

<service>Transcription</service>
<turnaround_level>rush</turnaround_level>

</order>

</media_file>

</threeplaymedia_file_manifest>

 

Example 2: Import a caption file with a video to prepare for video clip captioning service:

 

In this example, we are importing a parent video asset and caption file in anticipation of sending child clips for the Video Clip Captioning service. We import the video and caption assets, and instruct 3Play to prepare the parent video as a Video Clip Captioning Parent. Note that the video_id field should correspond to the appropriate asset in the video platform as you will need to reference that when uploading child clips (video_id should be unique in your project at 3Play).

 

<?xml version="1.0"?>

<threeplaymedia_file_manifest project_id=“99887766">

<media_file> <source_location>batch_254/hold_for_manifest/dogs_playing_in_the_park.mp4</source_location

<source_captions>caption_files/hold_for_manifest/dogs_frolicking.srt</source_captions>

<name>Dogs Playing in the Park</name>

<video_id>Zyx4329ds_ffds393686</video_id>

<description>This is a video about puppies.</description>

<order>

<service>Caption Import</service>

<language>English</language>

</order>

<order>

<service>Video Clip Captioning Parent</service>

</order>

</media_file>

</threeplaymedia_file_manifest>

 

Example 3: Order video clip captions with a child clip

In this example, we upload a child clip for ViCC processing, referencing the parent video described in Example 2.

<?xml version="1.0"?>
<threeplaymedia_file_manifest project_id=“99887766">
<media_file>
<source_location>clips/hold_for_manifest/dogs_playing_in_the_park_clip1.mp4</source_ location>
<name>Dogs Playing in the Park - Clip 1</name>
<video_id>ABc_4328432</video_id>
<description>This is a clip from a video about puppies.</description>
<order>
<service>Video Clip Captioning</service>
<parent_media_file>
<video_id>Zyx4329ds_ffds393686</video_id>
</parent_media_file>
</order> 
</media_file> 
</threeplaymedia_file_manifest>

 

 
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk