Mediafiles have all sorts of technical metadata such as filesize, mimetype, video container. This is determined by the analyse process in MediaMosa, which is automatically started on a file after upload or after it is generated by a transcode. With this rest call it is possible to reanalyse an existing mediafile. This may be usefull in cases where the underlying analyse tools (for example ffmpeg, file) are updated.
The response returns a job_id. The job_id can be used to obtain information about the status of the job, or its detailed results. When the job is finished, the mediafile metadata is updated. If the file is the original file of an asset, the duration of the video (in case of a video or audio) and mimetype is updated in the asset information.
The analyse process also determines if the file needs to be hinted. If the ega setting (see admin interface), defines that unhinted videofiles must be hinted, this proces is added after the analyse. Hinting is currently implemented for mp4, and flv (metadata).
This call needs EGA authentication.
|Parameter (Type)||Description||Required||Default value||Max. length|
|mediafile_id (ALPHA_NUM)||The mediafile ID.||Required||-|
|user_id (ALPHA_NUM)||The user id, must be the owner of the mediafile.||Required||-|
|no_hint (BOOL)||when true then, regardless of the ega setting, do not add hinting to the mediafile.||Optional||FALSE||-|
/mediafile/6c704fbd4ef58f2447fd1a3e7/analyse [POST] user_id=foo&no_hint=TRUE
<item id="1"> <job_id>7599</job_id> </item>