From 7641db4b3e673bb10fa07b5bedbadafbb6a9398f Mon Sep 17 00:00:00 2001 From: Roman Nurik Date: Fri, 21 Jan 2011 15:52:38 -0800 Subject: [PATCH] Update Supported Media Formats document to include information about network protocols and provide video encoding recommendations. Change-Id: I905213a47c9da0476e8495ffa20344a8811d56bc --- docs/html/guide/appendix/media-formats.jd | 177 ++++++++++++++++++---- docs/html/guide/guide_toc.cs | 2 +- 2 files changed, 149 insertions(+), 30 deletions(-) diff --git a/docs/html/guide/appendix/media-formats.jd b/docs/html/guide/appendix/media-formats.jd index 87099943c6e68..bac6bf43be987 100644 --- a/docs/html/guide/appendix/media-formats.jd +++ b/docs/html/guide/appendix/media-formats.jd @@ -1,29 +1,72 @@ page.title=Android Supported Media Formats @jd:body -

The Core Media Formats 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.

+
+
+ +

In this document

+ +
    +
  1. Network Protocols
    2. +
  2. Core Media Formats
    3. +
  3. Video Encoding Recommendations
    4. +
+ +

See also

+
    +
  1. Audio and Video
    2. +
+ +

Key classes

+
    +
  1. {@link android.media.MediaPlayer MediaPlayer}
    2. +
  2. {@link android.media.MediaRecorder MediaRecorder}
    3. +
+ +
+
+ +

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.

+ + +

Network Protocols

+ +

The following network protocols are supported for audio and video playback:

+ + + +

Note: HTTPS is not supported at this time.

-

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.

Core Media Formats

+

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+)".

+ - + - + - - + + @@ -31,19 +74,19 @@ page.title=Android Supported Media Formats - + - + - - + + @@ -51,8 +94,8 @@ page.title=Android Supported Media Formats - - + + @@ -60,7 +103,7 @@ page.title=Android Supported Media Formats - + @@ -69,7 +112,7 @@ page.title=Android Supported Media Formats - + @@ -77,7 +120,7 @@ page.title=Android Supported Media Formats - + @@ -85,7 +128,7 @@ page.title=Android Supported Media Formats - + @@ -93,8 +136,8 @@ page.title=Android Supported Media Formats - - + + @@ -102,15 +145,15 @@ page.title=Android Supported Media Formats - + - - + + @@ -118,33 +161,33 @@ page.title=Android Supported Media Formats - + - + - - + + - - - + + + - + @@ -152,7 +195,83 @@ page.title=Android Supported Media Formats
TypeFormatFormat / Codec Encoder Decoder DetailsFile Type(s) SupportedSupported File Type(s) / Container Formats
Audio AAC LC/LTPXX•• 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). No support for raw AAC (.aac)
HE-AACv1 (AAC+)  X•
HE-AACv2 (enhanced AAC+)  X•
AMR-NBXX•• 4.75 to 12.2 kbps sampled @ 8kHz 3GPP (.3gp)
AMR-WBXX•• 9 rates from 6.60 kbit/s to 23.85 kbit/s sampled @ 16kHz 3GPP (.3gp)
MP3  X• Mono/Stereo 8-320Kbps constant (CBR) or variable bit-rate (VBR) MP3 (.mp3)
MIDI  X• 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  X•   Ogg (.ogg)
PCM/WAVE  X• 8- and 16-bit linear PCM (rates up to limit of hardware) WAVE (.wav)
Image JPEGXX•• Base+progressive JPEG (.jpg)
GIF  X•   GIF (.gif)
PNGXX••   PNG (.png)
BMP  X•   BMP (.bmp)
Video H.263XX••   3GPP (.3gp) and MPEG-4 (.mp4)
H.264 AVCX •
(Android 3.0+)		•Baseline Profile (BP) 3GPP (.3gp) and MPEG-4 (.mp4)
MPEG-4 SP  X•   3GPP (.3gp)
+

Video Encoding Recommendations

+

Below are examples of video encoding profiles and parameters that the Android media framework supports for playback.

+ + +

In addition to the encoding parameters above, a device's available video recording profiles can be used as a proxy for media playback capabilities. These profiles can be inspected using the {@link android.media.CamcorderProfile CamcorderProfile} class, which is available since API level 8.

diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index a375b115c3972..09ec1198f2ac9 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -725,7 +725,7 @@
  • Supported Media Formats -
    • + updated
  • Intents List: Google Apps