MediaMuxer.AddTrack(MediaFormat) Method

Reference

Definition

Namespace:: Android.Media

Assembly:: Mono.Android.dll

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.

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, +: MediaFormat#KEY_CHANNEL_COUNT, +: codec-specific dataAAC</td> <td rowspan=5>+: MediaFormat#KEY_WIDTH, +: MediaFormat#KEY_HEIGHT, no KEY_ROTATION, use #setOrientationHint setOrientationHint().mp4, +: codec-specific dataAVC, MPEG4</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 +: codec-specific dataVorbis & .webm</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 MediaFormat#KEY_BIT_RATEAAC</td> </tr><tr> <td>android.os.Build.VERSION_CODES#N</td> <td>as above, plus  MediaFormat#KEY_BIT_RATEMPEG4, MediaFormat#KEY_HDR_STATIC_INFO#, .webm, MediaFormat#KEY_COLOR_STANDARD#, MediaFormat#KEY_COLOR_TRANSFER#, MediaFormat#KEY_COLOR_RANGE#, +: codec-specific dataHEVC, codec-specific dataVP9</td> </tr> <tr> <td colspan=4> Notes: #: storing into container metadata. .mp4, .webm…: for listed containers MPEG4, AAC…: for listed codecs </td> </tr><tr> <td colspan=4> 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, MediaFormat#MIMETYPE_AUDIO_AMR_NB NB-AMR, MediaFormat#MIMETYPE_AUDIO_AMR_WB WB-AMR, MediaFormat#MIMETYPE_VIDEO_H263 H.263, MediaFormat#MIMETYPE_VIDEO_MPEG4 MPEG-4, 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, 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 MediaFormat#MIMETYPE_VIDEO_HEVC HEVC (H.265)</td> <td>as above, plus 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.

Applies to