DescribeMedia
Returns information about a media file or stream, estimates the ability of Media Server to ingest it, and recommends an ingest engine to use.
Type: synchronous
Parameter | Description | Required |
---|---|---|
Source
|
The media source to describe. For example:
|
Set either Source or SourceData |
SourceData
|
The media source to describe. You can use the following methods to send data:
|
Example
/action=DescribeMedia&source=./media/my_video.ts
Response
The following XML is an example response:
<autnresponse> <action>DESCRIBEMEDIA</action> <response>SUCCESS</response> <responsedata> <description> <ingestEngine>video</ingestEngine> <media path="./media/my_video.ts" url="./media/my_video.ts" mimeType="video/unknown"> <streams> <videoStream id="0" width="720" height="576" sar="64:45" codec="MPEG-2 video"/> <audioStream id="1" channels="1" sampleRate="48000" format="planar 16bit signed" codec="MP2 (MPEG audio layer 2)" language="fra"/> <audioStream id="2" channels="1" sampleRate="48000" format="planar 16bit signed" codec="MP2 (MPEG audio layer 2)" language="eng"/> <audioStream id="3" channels="1" sampleRate="48000" format="planar 16bit signed" codec="MP2 (MPEG audio layer 2)" language="deu"/> <audioStream id="4" channels="1" sampleRate="48000" format="planar 16bit signed" codec="MP2 (MPEG audio layer 2)" language="ita"/> <audioStream id="5" channels="1" sampleRate="48000" format="planar 16bit signed" codec="MP2 (MPEG audio layer 2)" language="spa"/> </streams> <metadata> <tag name="creation_time">2011-01-31 08:23:35</tag> </metadata> </media> <supported>yes</supported> </description> </responsedata> </autnresponse>
-
The
supported
element indicates the likelihood that Media Server can ingest the media. The value can be:yes
- the format and codecs are supported, so in most cases Media Server should be able to ingest the media. Ingestion can still fail in some cases, for example if Media Server encounters corrupt data.maybe
- Media Server can open the media but the format or codecs have not been tested.no
- the media cannot be ingested.
- The
ingestEngine
element suggests which ingest engine to use to ingest the media. - The
media
element provides the path or URL of the media, and its MIME type. - The
streams
element contains information about the video and audio streams that are contained within the media. - The
metadata
element provides metadata that is extracted from the media.