MediaExtractor.GetTrackFormat(Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Get the track format at the specified index.
[Android.Runtime.Register("getTrackFormat", "(I)Landroid/media/MediaFormat;", "")]
public Android.Media.MediaFormat GetTrackFormat (int index);[<Android.Runtime.Register("getTrackFormat", "(I)Landroid/media/MediaFormat;", "")>]
member this.GetTrackFormat : int -> Android.Media.MediaFormatParameters
- index
- Int32
Returns
- Attributes
Remarks
Get the track format at the specified index.
More detail on the representation can be found at android.media.MediaCodec
The following table summarizes support for format keys across android releases:
<table style="width: 0%"> <thead> <tr> <th rowspan=2>OS Version(s)</th> <td colspan=3>MediaFormat keys used for</th> </tr><tr> <th>All Tracks</th> <th>Audio Tracks</th> <th>Video Tracks</th> </tr> </thead> <tbody> <tr> <td>android.os.Build.VERSION_CODES#JELLY_BEAN</td> <td rowspan=8>MediaFormat#KEY_MIME,<br> MediaFormat#KEY_DURATION,<br> MediaFormat#KEY_MAX_INPUT_SIZE</td> <td rowspan=5>MediaFormat#KEY_SAMPLE_RATE,<br> MediaFormat#KEY_CHANNEL_COUNT,<br> MediaFormat#KEY_CHANNEL_MASK,<br> gapless playback information<sup>.mp3, .mp4</sup>,<br> MediaFormat#KEY_IS_ADTS<sup>AAC if streaming</sup>,<br> codec-specific data<sup>AAC, Vorbis</sup></td> <td rowspan=2>MediaFormat#KEY_WIDTH,<br> MediaFormat#KEY_HEIGHT,<br> codec-specific data<sup>AVC, MPEG4</sup></td> </tr><tr> <td>android.os.Build.VERSION_CODES#JELLY_BEAN_MR1</td> </tr><tr> <td>android.os.Build.VERSION_CODES#JELLY_BEAN_MR2</td> <td rowspan=3>as above, plus<br> Pixel aspect ratio information<sup>AVC, *</sup></td> </tr><tr> <td>android.os.Build.VERSION_CODES#KITKAT</td> </tr><tr> <td>android.os.Build.VERSION_CODES#KITKAT_WATCH</td> </tr><tr> <td>android.os.Build.VERSION_CODES#LOLLIPOP</td> <td rowspan=2>as above, plus<br> MediaFormat#KEY_BIT_RATE<sup>AAC</sup>,<br> codec-specific data<sup>Opus</sup></td> <td rowspan=2>as above, plus<br> MediaFormat#KEY_ROTATION<sup>.mp4</sup>,<br> MediaFormat#KEY_BIT_RATE<sup>MPEG4</sup>,<br> codec-specific data<sup>HEVC</sup></td> </tr><tr> <td>android.os.Build.VERSION_CODES#LOLLIPOP_MR1</td> </tr><tr> <td>android.os.Build.VERSION_CODES#M</td> <td>as above, plus<br> gapless playback information<sup>Opus</sup></td> <td>as above, plus<br> MediaFormat#KEY_FRAME_RATE (integer)</td> </tr><tr> <td>android.os.Build.VERSION_CODES#N</td> <td>as above, plus<br> MediaFormat#KEY_TRACK_ID,<br> <!-- {link MediaFormat#KEY_MAX_BIT_RATE}<sup>#, .mp4</sup>,<br> --> MediaFormat#KEY_BIT_RATE<sup>#, .mp4</sup></td> <td>as above, plus<br> MediaFormat#KEY_PCM_ENCODING,<br> MediaFormat#KEY_PROFILE<sup>AAC</sup></td> <td>as above, plus<br> MediaFormat#KEY_HDR_STATIC_INFO<sup>#, .webm</sup>,<br> MediaFormat#KEY_COLOR_STANDARD<sup>#</sup>,<br> MediaFormat#KEY_COLOR_TRANSFER<sup>#</sup>,<br> MediaFormat#KEY_COLOR_RANGE<sup>#</sup>,<br> MediaFormat#KEY_PROFILE<sup>MPEG2, H.263, MPEG4, AVC, HEVC, VP9</sup>,<br> MediaFormat#KEY_LEVEL<sup>H.263, MPEG4, AVC, HEVC, VP9</sup>,<br> codec-specific data<sup>VP9</sup></td> </tr> <tr> <td colspan=4> <p class=note><strong>Notes:</strong><br> #: container-specified value only.<br> .mp4, .webm…: for listed containers<br> MPEG4, AAC…: for listed codecs </td> </tr><tr> <td colspan=4> <p class=note>Note that that level information contained in the container many times does not match the level of the actual bitstream. You may want to clear the level using MediaFormat.setString(KEY_LEVEL, null) before using the track format to find a decoder that can play back a particular track. </td> </tr><tr> <td colspan=4> <p class=note><strong>*Pixel (sample) aspect ratio</strong> is returned in the following keys. The display width can be calculated for example as: <p align=center> display-width = display-height * crop-width / crop-height * sar-width / sar-height </td> </tr><tr> <th>Format Key</th><th>Value Type</th><th colspan=2>Description</th> </tr><tr> <td>"sar-width"</td><td>Integer</td><td colspan=2>Pixel aspect ratio width</td> </tr><tr> <td>"sar-height"</td><td>Integer</td><td colspan=2>Pixel aspect ratio height</td> </tr> </tbody> </table>
Java documentation for android.media.MediaExtractor.getTrackFormat(int).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.