`convertMedia`

Convert Media

Convert a video or audio file in The Cloud into another format (mp4, mov, webm, mkv, m4a, mp3, wav) on the media worker, landing the result as a NEW PRIVATE file beside the original: the source is…

writeexternal

Arguments

fileIdstringrequiredThe Cloud file id of the video or audio to re-encode.
formatstringrequiredThe format to convert into. Video: mp4, mov, webm, mkv. Audio-only: m4a, mp3, wav (the video stream is dropped).

Returns

ALREADY DONE: if an equivalent conversion already landed for this file+format, it returns that existing file instead of re-encoding: so don't re-run a conversion the user says is already done.

Ask for it

The Cloud routes these requests to this verb.

convert this to mp4
turn this video into a webm
make an mp3 of this audio
I need this clip in a format my phone can play

Pair it with

The verbs that finish the job.

compressMedia