Download media object

[elv-preethi]

The script OfferingDownloadMedia performs the following:

• Retrieves streams metadata from either transcodes or offerings for each provided streamKey.
• Then downloads the parts, concatenates them, and trims the media file for each streamKey.

Steps:

• export PRIVATE_KEY="xxx"

• set demov3 network in TestConfiguration.json or using --config-url

• Run the command:

  node ./testScripts/OfferingDownloadMedia.js 
  --startTime 10 
  --endTime 50 
  --objectId=iq__bSS84FakdSgxHSiW3kJcA1obH6P 
  --out ./out_dir 
  --config-url "https://demov3.net955210.contentfabric.io/config"
  --streamKey "video,polish_5_1,english_stereo"

• For each content with a startTime and endTime, a new folder will be created under the output directory, as shown below:

  
  ./out_dir
  └── iq__bSS84FakdSgxHSiW3kJcA1obH6P_00-00-40.500_00-01-10.000
  ├── english_stereo
  │   ├── 0001.hqpeBJhFb8U8gedQRc1gPT4uKd6fxawWmQBUjRcQuiRT2TKp1hVZ.mp4
  │   └── 0002.hqpe4oNGvobdiDeX9r9RnTAqtESNjKqtxryUAx51JhMxuhh4fUFq.mp4
  ├── english_stereo.mp4
  ├── parts_english_stereo.txt
  ├── parts_polish_5_1.txt
  ├── parts_video.txt
  ├── polish_5_1
  │   ├── 0001.hqpeNjNmLQvLQxfx3hWvXZzJ4nv2hF41DdrzSefRxxBDVRLyCsZ7.mp4
  │   └── 0002.hqpe6iHZFyZ7qroTSfz6xiVrhtDRyYktLveofuE27NB8EaXGtfCh.mp4
  ├── polish_5_1.mp4
  ├── trimmed
  │   ├── english_stereo_trimmed.mp4
  │   ├── polish_5_1_trimmed.mp4
  │   └── video_trimmed.mp4
  ├── video
  │   ├── 0001.hqpedi3ftDawHChtviNtzCbcVsnVukpjbqm6bmM1TaPJRutgz8x3Q.mp4
  │   └── 0002.hqpe2tXuAapeuTdPFNcwqnJFKyV1RxbVqz4Jc3ejJtn5iYURQDjeWS.mp4
  └── video.mp4

5 directories, 15 files

For instance, for `english_stereo` streamKey:
`english_stereo` folder => contains all the parts that fall within the start and end times.
`english_stereo.mp4` => the concatenated file
`english_stereo_trimeed.mp4` => this file has been both concatenated and trimmed to the specified time range.

### Command usage:

node ./testScripts/OfferingDownloadMedia --help Options: --help Show help [boolean] --debug Print debug logging for API calls [boolean] --configUrl, --config-url URL pointing to the Fabric configuration, enclosed in quotes. e.g. for Eluvio demo network: --configUrl "https://demov3.net955210.contentfabric.io/config" [string] --elvGeo, --elv-geo Geographic region for the fabric nodes. [string] [choices: "as-east", "au-east", "eu-east", "eu-west", "na-east", "na-west-north", "na-west-south"] --objectId, --object-id Object ID (should start with 'iq') [string] --versionHash, --version-hash Object Version Hash (should start with 'hq') [string] --offeringKey offering key [string] [default: "default"] --streamKey comma separated list of offerings stream key [string] [default: "video"] --startTime start time to retrieve parts in seconds [number] [required] --endTime end time to retrieve parts in seconds [number] [required] --out output directory

[eponymous301]

For consistency with other scripts I recommend renaming objectHash to versionHash and offeringType to offeringKey

Note also that rather than using TestConfiguration.json to set demov3 network you should be able to use --configUrl https://demov3.net955210.contentfabric.io/config in command line, or alternate option is to set env var FABRIC_CONFIG_URL=https://demov3.net955210.contentfabric.io/config

[elv-preethi]

Looks good overall, I made some suggestions, the only ones that I feel strongly about are:

• add a --streamKey argument (optionally defaulting to "video")
• change --objectVersion to --versionHash and --offeringType to --offeringKey for consistency with other scripts
• use default: ... in option() declarations instead of setting the value via || (this will make the default values show up automatically in help output when user is missing an option or specifies --help)

I also suggest renaming ObjectDownloadMedia.js to OfferingDownloadMedia.js to reflect the fact that it targets a single mez offering.

Thanks for reviewing. Made the changes as per comment. Also, changed the code to append all parts to single file and runs the ffmpeg at the end to concat all the parts and generate single mp4 file.

out_dir
├── parts_video.txt
├── video
│   ├── hqpe2NC2ojcbkPLrEbEKfFFSqroeST8Y2wgrJWRWtP61Lg7TfZ7nRT.mp4
│   └── hqpeKzJ5bBqKr38dEdNsX16epCwnqmwm5acnRcL13PvQkZhCnR9si.mp4
└── video.mp4

[elv-preethi]

@elv-serban When attempting to trim a video, I have observed that if the duration is 19.7s, it is rounded down to 19s on my system, instead of rounding to 20s. However, the ffmpeg @eponymous301 is using rounds the duration up to 20s. I am not sure how to fix this. @elv-haoyu, could you please try the script when you have a moment?

The ./out/video.mp4 has the untrimmed version comprising of all parts within duration and ./out/video_hh-mm-ss.ms_hh-mm-ss.ms.mp4 has the trimmed version.

[elv-preethi]

As per @elv-haoyu requests, Made following changes:

• For each content with a startTime and endTime, a new folder will be created under the output directory, as shown below:
  1. streamKey == "both" :

     
     ├── iq__2BbhsB7V3DBVoSYmhszCeUBBVzpY_00-00-10.000_00-00-43.000
     │   ├── audio
     │   │   ├── 0001.hqpeDgq3121TLyBFf2NHiuv4kSvPbGiANyG1vGeN2cBxoo1J7oAu.mp4
     │   │   └── 0002.hqpe4Yt7TBcceK1dau35nVWkbwDXBm8WNxXPwczKtXkRJ2xSP6Fx.mp4
     │   ├── audio.mp4
     │   ├── out.mp4
     │   ├── out_00-00-10.000_00-00-43.000.mp4
     │   ├── parts_audio.txt
     │   ├── parts_video.txt
     │   ├── video
     │   │   ├── 0001.hqpeKzJ5bBqKr38dEdNsX16epCwnqmwm5acnRcL13PvQkZhCnR9si.mp4
     │   │   └── 0002.hqpe2NC2ojcbkPLrEbEKfFFSqroeST8Y2wgrJWRWtP61Lg7TfZ7nRT.mp4
     │   └── video.mp4

2. streamKey == "audio":

└── iq__2BbhsB7V3DBVoSYmhszCeUBBVzpY_00-00-10.500_00-00-43.500 ├── audio │   ├── 0001.hqpeDgq3121TLyBFf2NHiuv4kSvPbGiANyG1vGeN2cBxoo1J7oAu.mp4 │   └── 0002.hqpe4Yt7TBcceK1dau35nVWkbwDXBm8WNxXPwczKtXkRJ2xSP6Fx.mp4 ├── audio.mp4 ├── out_00-00-10.500_00-00-43.500.mp4 └── parts_audio.txt

3. streamKey == "video":

└── iq__2BbhsB7V3DBVoSYmhszCeUBBVzpY_00-00-10.500_00-00-43.500 ├── out_00-00-10.500_00-00-43.500.mp4 ├── parts_video.txt ├── video │   ├── 0001.hqpeKzJ5bBqKr38dEdNsX16epCwnqmwm5acnRcL13PvQkZhCnR9si.mp4 │   └── 0002.hqpe2NC2ojcbkPLrEbEKfFFSqroeST8Y2wgrJWRWtP61Lg7TfZ7nRT.mp4 └── video.mp4

* By default, if `steamKey` is not provided. Both audio and video files will be downloaded, concatenated and trimmed. 
* Final trimmed output is at `out_start-time_end-time.mp4`.

[elv-preethi]

@elv-haoyu @eponymous301 @elv-serban made the changes as discussed. The details are here. Also, @elv-haoyu all of the trimmed files will be under iq_XXX_start-time_end-time/trimmed folder.