This document describes the media codec, container, and network protocol support provided by the Android platform.
As an application developer, you are free to make use of any media codec that is available on any Android-powered device, including those provided by the Android platform and those that are device-specific. However, it is a best practice to use media encoding profiles that are device-agnostic.
The following network protocols are supported for audio and video playback:
Note: HTTPS is not supported at this time.
The table below describes the media format support built into the Android platform. Note that any given mobile device may provide support for additional formats or file types not listed in the table.
Note: Media codecs that are not guaranteed to be available on all Android platform versions are accordingly noted in parentheses—for example "(Android 3.0+)".
|Type||Format / Codec||Encoder||Decoder||Details||Supported File Type(s) / Container Formats|
|Audio||AAC LC/LTP||•||•||Mono/Stereo content in any combination of standard bit rates up to 160 kbps and sampling rates from 8 to 48kHz||3GPP (.3gp), and MPEG-4 (.mp4, .m4a). ADTS raw AAC (.aac, decode only, ADIF not supported, Android 3.1+).|
|HE-AACv2 (enhanced AAC+)||•|
|AMR-NB||•||•||4.75 to 12.2 kbps sampled @ 8kHz||3GPP (.3gp)|
|AMR-WB||•||•||9 rates from 6.60 kbit/s to 23.85 kbit/s sampled @ 16kHz||3GPP (.3gp)|
|Mono/Stereo (no multichannel). Sample rates up to 48 kHz (but up to 44.1 kHz is recommended on devices with 44.1 kHz output, as the 48 to 44.1 kHz downsampler does not include a low-pass filter). 16-bit recommended; no dither applied for 24-bit.||FLAC (.flac) only|
|MP3||•||Mono/Stereo 8-320Kbps constant (CBR) or variable bit-rate (VBR)||MP3 (.mp3)|
|MIDI||•||MIDI Type 0 and 1. DLS Version 1 and 2. XMF and Mobile XMF. Support for ringtone formats RTTTL/RTX, OTA, and iMelody||Type 0 and 1 (.mid, .xmf, .mxmf). Also RTTTL/RTX (.rtttl, .rtx), OTA (.ota), and iMelody (.imy)|
|Ogg Vorbis||•||Ogg (.ogg)|
|PCM/WAVE||•||8- and 16-bit linear PCM (rates up to limit of hardware)||WAVE (.wav)|
|Video||H.263||•||•||3GPP (.3gp) and MPEG-4 (.mp4)|
|•||Baseline Profile (BP)||3GPP (.3gp) and MPEG-4 (.mp4). MPEG-TS (.ts, AAC audio only, not seekable, Android 3.0+)|
|MPEG-4 SP||•||3GPP (.3gp)|
Table 2, below, lists examples of video encoding profiles and parameters that the Android media framework supports for playback. In addition to these encoding parameter recommendations, a device's available video recording profiles can be used as a proxy for media playback capabilities. These profiles can be inspected using the
CamcorderProfile class, which is available since API level 8.
|Lower quality||Higher quality|
|Video codec||H.264 Baseline Profile||H.264 Baseline Profile|
|Video resolution||176 x 144 px||480 x 360 px|
|Video frame rate||12 fps||30 fps|
|Video bitrate||56 Kbps||500 Kbps|
|Audio channels||1 (mono)||2 (stereo)|
|Audio bitrate||24 Kbps||128 Kbps|
For video content that is streamed over HTTP or RTSP, there are additional requirements:
moovatom must precede any