MediaMuxer.AddTrack(MediaFormat) Method

Definition

Namespace:

Android.Media

Assembly:

Mono.Android.dll

Adds a track with the specified format.

[Android.Runtime.Register("addTrack", "(Landroid/media/MediaFormat;)I", "")]
public int AddTrack (Android.Media.MediaFormat format);

[<Android.Runtime.Register("addTrack", "(Landroid/media/MediaFormat;)I", "")>]
member this.AddTrack : Android.Media.MediaFormat -> int

Parameters

format

MediaFormat

The media format for the track. This must not be an empty MediaFormat.

Returns

Int32

The track index for this newly added track, and it should be used in the #writeSampleData.

Attributes

RegisterAttribute

Remarks

Adds a track with the specified format.

The following table summarizes support for specific format keys across android releases. Keys marked with '+:' are required.

<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_MR2</td> <td rowspan=7>+: MediaFormat#KEY_MIME</td> <td rowspan=3>+: MediaFormat#KEY_SAMPLE_RATE,<br> +: MediaFormat#KEY_CHANNEL_COUNT,<br> +: <strong>codec-specific data^AAC</strong></td> <td rowspan=5>+: MediaFormat#KEY_WIDTH,<br> +: MediaFormat#KEY_HEIGHT,<br> no KEY_ROTATION, use #setOrientationHint setOrientationHint()^.mp4,<br> +: <strong>codec-specific data^{AVC, MPEG4}</strong></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=4>as above, plus<br> +: <strong>codec-specific data^{Vorbis & .webm}</strong></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> MediaFormat#KEY_BIT_RATE^AAC</td> </tr><tr> <td>android.os.Build.VERSION_CODES#N</td> <td>as above, plus<br> <!-- {link MediaFormat#KEY_MAX_BIT_RATE}^{AAC, MPEG4},<br> --> MediaFormat#KEY_BIT_RATE^MPEG4,<br> MediaFormat#KEY_HDR_STATIC_INFO^{#, .webm},<br> MediaFormat#KEY_COLOR_STANDARD^#,<br> MediaFormat#KEY_COLOR_TRANSFER^#,<br> MediaFormat#KEY_COLOR_RANGE^#,<br> +: <strong>codec-specific data^HEVC</strong>,<br> codec-specific data^VP9</td> </tr> <tr> <td colspan=4> <p class=note><strong>Notes:</strong><br> #: storing into container metadata.<br> .mp4, .webm&hellip;: for listed containers<br> MPEG4, AAC&hellip;: for listed codecs </td> </tr><tr> <td colspan=4> <p class=note>Note that the codec-specific data for the track must be specified using this method. Furthermore, codec-specific data must not be passed/specified via the #writeSampleData writeSampleData() call. </td> </tr> </tbody> </table>

The following table summarizes codec support for containers across android releases:

<table style="width: 0%"> <thead> <tr> <th rowspan=2>OS Version(s)</th> <td colspan=3>Codec support</th> </tr><tr> <th>OutputFormat#MUXER_OUTPUT_MPEG_4 MP4</th> <th>OutputFormat#MUXER_OUTPUT_WEBM WEBM</th> </tr> </thead> <tbody> <tr> <td>android.os.Build.VERSION_CODES#JELLY_BEAN_MR2</td> <td rowspan=6>MediaFormat#MIMETYPE_AUDIO_AAC AAC,<br> MediaFormat#MIMETYPE_AUDIO_AMR_NB NB-AMR,<br> MediaFormat#MIMETYPE_AUDIO_AMR_WB WB-AMR,<br> MediaFormat#MIMETYPE_VIDEO_H263 H.263,<br> MediaFormat#MIMETYPE_VIDEO_MPEG4 MPEG-4,<br> MediaFormat#MIMETYPE_VIDEO_AVC AVC (H.264)</td> <td rowspan=3>Not supported</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=3>MediaFormat#MIMETYPE_AUDIO_VORBIS Vorbis,<br> MediaFormat#MIMETYPE_VIDEO_VP8 VP8</td> </tr><tr> <td>android.os.Build.VERSION_CODES#LOLLIPOP_MR1</td> </tr><tr> <td>android.os.Build.VERSION_CODES#M</td> </tr><tr> <td>android.os.Build.VERSION_CODES#N</td> <td>as above, plus<br> MediaFormat#MIMETYPE_VIDEO_HEVC HEVC (H.265)</td> <td>as above, plus<br> MediaFormat#MIMETYPE_VIDEO_VP9 VP9</td> </tr> </tbody> </table>

Java documentation for android.media.MediaMuxer.addTrack(android.media.MediaFormat).

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.