From 68b1a6eed8479e16456f018663b1bcfaecc2a3f4 Mon Sep 17 00:00:00 2001
From: Andreas Huber <andih@google.com>
Date: Mon, 25 Jun 2012 13:53:43 -0700
Subject: [PATCH] Document some of the more common mimetypes to be used when
 instantiating

MediaCodec components.

Change-Id: I810507d1d76a28666eb6fb63e3b597d38e5f1389
---
 media/java/android/media/MediaCodec.java | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/media/java/android/media/MediaCodec.java b/media/java/android/media/MediaCodec.java
index 2debd57df82dc..fcb676d2d449d 100644
--- a/media/java/android/media/MediaCodec.java
+++ b/media/java/android/media/MediaCodec.java
@@ -159,6 +159,22 @@ final public class MediaCodec {
 
     /**
      * Instantiate a decoder supporting input data of the given mime type.
+     *
+     * The following is a partial list of defined mime types and their semantics:
+     * <ul>
+     * <li>"video/x-vnd.on2.vp8" - VPX video (i.e. video in .webm)
+     * <li>"video/avc" - H.264/AVC video
+     * <li>"video/mp4v-es" - MPEG4 video
+     * <li>"video/3gpp" - H.263 video
+     * <li>"audio/3gpp" - AMR narrowband audio
+     * <li>"audio/amr-wb" - AMR wideband audio
+     * <li>"audio/mpeg" - MPEG1/2 audio layer III
+     * <li>"audio/mp4a-latm" - AAC audio
+     * <li>"audio/vorbis" - vorbis audio
+     * <li>"audio/g711-alaw" - G.711 alaw audio
+     * <li>"audio/g711-mlaw" - G.711 ulaw audio
+     * </ul>
+     *
      * @param type The mime type of the input data.
      */
     public static MediaCodec createDecoderByType(String type) {