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:

  • a path to a file residing on a file system that Media Server can access.
  • the URL of a stream.
Set either Source or SourceData
SourceData

The media source to describe. You can use the following methods to send data:

  • send the file using an HTTP POST request with the multipart/form-data content type.
  • send the file using an HTTP POST request with the application/x-www-form-urlencoded content type. In this case the binary data must be base-64 encoded.

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>libav</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>

_HP_HTML5_bannerTitle.htm