Home | History | Annotate | Download | only in media
      1 /*
      2  * Copyright (C) 2007 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package android.media;
     18 
     19 import android.media.DecoderCapabilities;
     20 import android.media.DecoderCapabilities.VideoDecoder;
     21 import android.media.DecoderCapabilities.AudioDecoder;
     22 import android.mtp.MtpConstants;
     23 
     24 import java.util.HashMap;
     25 import java.util.List;
     26 import java.util.Locale;
     27 
     28 /**
     29  * MediaScanner helper class.
     30  *
     31  * {@hide}
     32  */
     33 public class MediaFile {
     34 
     35     // Audio file types
     36     public static final int FILE_TYPE_MP3     = 1;
     37     public static final int FILE_TYPE_M4A     = 2;
     38     public static final int FILE_TYPE_WAV     = 3;
     39     public static final int FILE_TYPE_AMR     = 4;
     40     public static final int FILE_TYPE_AWB     = 5;
     41     public static final int FILE_TYPE_WMA     = 6;
     42     public static final int FILE_TYPE_OGG     = 7;
     43     public static final int FILE_TYPE_AAC     = 8;
     44     public static final int FILE_TYPE_MKA     = 9;
     45     public static final int FILE_TYPE_FLAC    = 10;
     46     private static final int FIRST_AUDIO_FILE_TYPE = FILE_TYPE_MP3;
     47     private static final int LAST_AUDIO_FILE_TYPE = FILE_TYPE_FLAC;
     48 
     49     // MIDI file types
     50     public static final int FILE_TYPE_MID     = 11;
     51     public static final int FILE_TYPE_SMF     = 12;
     52     public static final int FILE_TYPE_IMY     = 13;
     53     private static final int FIRST_MIDI_FILE_TYPE = FILE_TYPE_MID;
     54     private static final int LAST_MIDI_FILE_TYPE = FILE_TYPE_IMY;
     55 
     56     // Video file types
     57     public static final int FILE_TYPE_MP4     = 21;
     58     public static final int FILE_TYPE_M4V     = 22;
     59     public static final int FILE_TYPE_3GPP    = 23;
     60     public static final int FILE_TYPE_3GPP2   = 24;
     61     public static final int FILE_TYPE_WMV     = 25;
     62     public static final int FILE_TYPE_ASF     = 26;
     63     public static final int FILE_TYPE_MKV     = 27;
     64     public static final int FILE_TYPE_MP2TS   = 28;
     65     public static final int FILE_TYPE_AVI     = 29;
     66     public static final int FILE_TYPE_WEBM    = 30;
     67     private static final int FIRST_VIDEO_FILE_TYPE = FILE_TYPE_MP4;
     68     private static final int LAST_VIDEO_FILE_TYPE = FILE_TYPE_WEBM;
     69 
     70     // More video file types
     71     public static final int FILE_TYPE_MP2PS   = 200;
     72     public static final int FILE_TYPE_QT      = 201;
     73     private static final int FIRST_VIDEO_FILE_TYPE2 = FILE_TYPE_MP2PS;
     74     private static final int LAST_VIDEO_FILE_TYPE2 = FILE_TYPE_QT;
     75 
     76     // Image file types
     77     public static final int FILE_TYPE_JPEG    = 31;
     78     public static final int FILE_TYPE_GIF     = 32;
     79     public static final int FILE_TYPE_PNG     = 33;
     80     public static final int FILE_TYPE_BMP     = 34;
     81     public static final int FILE_TYPE_WBMP    = 35;
     82     public static final int FILE_TYPE_WEBP    = 36;
     83     private static final int FIRST_IMAGE_FILE_TYPE = FILE_TYPE_JPEG;
     84     private static final int LAST_IMAGE_FILE_TYPE = FILE_TYPE_WEBP;
     85 
     86     // Raw image file types
     87     public static final int FILE_TYPE_DNG     = 300;
     88     public static final int FILE_TYPE_CR2     = 301;
     89     public static final int FILE_TYPE_NEF     = 302;
     90     public static final int FILE_TYPE_NRW     = 303;
     91     public static final int FILE_TYPE_ARW     = 304;
     92     public static final int FILE_TYPE_RW2     = 305;
     93     public static final int FILE_TYPE_ORF     = 306;
     94     public static final int FILE_TYPE_RAF     = 307;
     95     public static final int FILE_TYPE_PEF     = 308;
     96     public static final int FILE_TYPE_SRW     = 309;
     97     private static final int FIRST_RAW_IMAGE_FILE_TYPE = FILE_TYPE_DNG;
     98     private static final int LAST_RAW_IMAGE_FILE_TYPE = FILE_TYPE_SRW;
     99 
    100     // Playlist file types
    101     public static final int FILE_TYPE_M3U      = 41;
    102     public static final int FILE_TYPE_PLS      = 42;
    103     public static final int FILE_TYPE_WPL      = 43;
    104     public static final int FILE_TYPE_HTTPLIVE = 44;
    105 
    106     private static final int FIRST_PLAYLIST_FILE_TYPE = FILE_TYPE_M3U;
    107     private static final int LAST_PLAYLIST_FILE_TYPE = FILE_TYPE_HTTPLIVE;
    108 
    109     // Drm file types
    110     public static final int FILE_TYPE_FL      = 51;
    111     private static final int FIRST_DRM_FILE_TYPE = FILE_TYPE_FL;
    112     private static final int LAST_DRM_FILE_TYPE = FILE_TYPE_FL;
    113 
    114     // Other popular file types
    115     public static final int FILE_TYPE_TEXT          = 100;
    116     public static final int FILE_TYPE_HTML          = 101;
    117     public static final int FILE_TYPE_PDF           = 102;
    118     public static final int FILE_TYPE_XML           = 103;
    119     public static final int FILE_TYPE_MS_WORD       = 104;
    120     public static final int FILE_TYPE_MS_EXCEL      = 105;
    121     public static final int FILE_TYPE_MS_POWERPOINT = 106;
    122     public static final int FILE_TYPE_ZIP           = 107;
    123 
    124     public static class MediaFileType {
    125         public final int fileType;
    126         public final String mimeType;
    127 
    128         MediaFileType(int fileType, String mimeType) {
    129             this.fileType = fileType;
    130             this.mimeType = mimeType;
    131         }
    132     }
    133 
    134     private static final HashMap<String, MediaFileType> sFileTypeMap
    135             = new HashMap<String, MediaFileType>();
    136     private static final HashMap<String, Integer> sMimeTypeMap
    137             = new HashMap<String, Integer>();
    138     // maps file extension to MTP format code
    139     private static final HashMap<String, Integer> sFileTypeToFormatMap
    140             = new HashMap<String, Integer>();
    141     // maps mime type to MTP format code
    142     private static final HashMap<String, Integer> sMimeTypeToFormatMap
    143             = new HashMap<String, Integer>();
    144     // maps MTP format code to mime type
    145     private static final HashMap<Integer, String> sFormatToMimeTypeMap
    146             = new HashMap<Integer, String>();
    147 
    148     static void addFileType(String extension, int fileType, String mimeType) {
    149         sFileTypeMap.put(extension, new MediaFileType(fileType, mimeType));
    150         sMimeTypeMap.put(mimeType, Integer.valueOf(fileType));
    151     }
    152 
    153     static void addFileType(String extension, int fileType, String mimeType, int mtpFormatCode) {
    154         addFileType(extension, fileType, mimeType);
    155         sFileTypeToFormatMap.put(extension, Integer.valueOf(mtpFormatCode));
    156         sMimeTypeToFormatMap.put(mimeType, Integer.valueOf(mtpFormatCode));
    157         sFormatToMimeTypeMap.put(mtpFormatCode, mimeType);
    158     }
    159 
    160     private static boolean isWMAEnabled() {
    161         List<AudioDecoder> decoders = DecoderCapabilities.getAudioDecoders();
    162         int count = decoders.size();
    163         for (int i = 0; i < count; i++) {
    164             AudioDecoder decoder = decoders.get(i);
    165             if (decoder == AudioDecoder.AUDIO_DECODER_WMA) {
    166                 return true;
    167             }
    168         }
    169         return false;
    170     }
    171 
    172     private static boolean isWMVEnabled() {
    173         List<VideoDecoder> decoders = DecoderCapabilities.getVideoDecoders();
    174         int count = decoders.size();
    175         for (int i = 0; i < count; i++) {
    176             VideoDecoder decoder = decoders.get(i);
    177             if (decoder == VideoDecoder.VIDEO_DECODER_WMV) {
    178                 return true;
    179             }
    180         }
    181         return false;
    182     }
    183 
    184     static {
    185         addFileType("MP3", FILE_TYPE_MP3, "audio/mpeg", MtpConstants.FORMAT_MP3);
    186         addFileType("MPGA", FILE_TYPE_MP3, "audio/mpeg", MtpConstants.FORMAT_MP3);
    187         addFileType("M4A", FILE_TYPE_M4A, "audio/mp4", MtpConstants.FORMAT_MPEG);
    188         addFileType("WAV", FILE_TYPE_WAV, "audio/x-wav", MtpConstants.FORMAT_WAV);
    189         addFileType("AMR", FILE_TYPE_AMR, "audio/amr");
    190         addFileType("AWB", FILE_TYPE_AWB, "audio/amr-wb");
    191         if (isWMAEnabled()) {
    192             addFileType("WMA", FILE_TYPE_WMA, "audio/x-ms-wma", MtpConstants.FORMAT_WMA);
    193         }
    194         addFileType("OGG", FILE_TYPE_OGG, "audio/ogg", MtpConstants.FORMAT_OGG);
    195         addFileType("OGG", FILE_TYPE_OGG, "application/ogg", MtpConstants.FORMAT_OGG);
    196         addFileType("OGA", FILE_TYPE_OGG, "application/ogg", MtpConstants.FORMAT_OGG);
    197         addFileType("AAC", FILE_TYPE_AAC, "audio/aac", MtpConstants.FORMAT_AAC);
    198         addFileType("AAC", FILE_TYPE_AAC, "audio/aac-adts", MtpConstants.FORMAT_AAC);
    199         addFileType("MKA", FILE_TYPE_MKA, "audio/x-matroska");
    200 
    201         addFileType("MID", FILE_TYPE_MID, "audio/midi");
    202         addFileType("MIDI", FILE_TYPE_MID, "audio/midi");
    203         addFileType("XMF", FILE_TYPE_MID, "audio/midi");
    204         addFileType("RTTTL", FILE_TYPE_MID, "audio/midi");
    205         addFileType("SMF", FILE_TYPE_SMF, "audio/sp-midi");
    206         addFileType("IMY", FILE_TYPE_IMY, "audio/imelody");
    207         addFileType("RTX", FILE_TYPE_MID, "audio/midi");
    208         addFileType("OTA", FILE_TYPE_MID, "audio/midi");
    209         addFileType("MXMF", FILE_TYPE_MID, "audio/midi");
    210 
    211         addFileType("MPEG", FILE_TYPE_MP4, "video/mpeg", MtpConstants.FORMAT_MPEG);
    212         addFileType("MPG", FILE_TYPE_MP4, "video/mpeg", MtpConstants.FORMAT_MPEG);
    213         addFileType("MP4", FILE_TYPE_MP4, "video/mp4", MtpConstants.FORMAT_MPEG);
    214         addFileType("M4V", FILE_TYPE_M4V, "video/mp4", MtpConstants.FORMAT_MPEG);
    215         addFileType("MOV", FILE_TYPE_QT, "video/quicktime", MtpConstants.FORMAT_MPEG);
    216 
    217         addFileType("3GP", FILE_TYPE_3GPP, "video/3gpp",  MtpConstants.FORMAT_3GP_CONTAINER);
    218         addFileType("3GPP", FILE_TYPE_3GPP, "video/3gpp", MtpConstants.FORMAT_3GP_CONTAINER);
    219         addFileType("3G2", FILE_TYPE_3GPP2, "video/3gpp2", MtpConstants.FORMAT_3GP_CONTAINER);
    220         addFileType("3GPP2", FILE_TYPE_3GPP2, "video/3gpp2", MtpConstants.FORMAT_3GP_CONTAINER);
    221         addFileType("MKV", FILE_TYPE_MKV, "video/x-matroska");
    222         addFileType("WEBM", FILE_TYPE_WEBM, "video/webm");
    223         addFileType("TS", FILE_TYPE_MP2TS, "video/mp2ts");
    224         addFileType("AVI", FILE_TYPE_AVI, "video/avi");
    225 
    226         if (isWMVEnabled()) {
    227             addFileType("WMV", FILE_TYPE_WMV, "video/x-ms-wmv", MtpConstants.FORMAT_WMV);
    228             addFileType("ASF", FILE_TYPE_ASF, "video/x-ms-asf");
    229         }
    230 
    231         addFileType("JPG", FILE_TYPE_JPEG, "image/jpeg", MtpConstants.FORMAT_EXIF_JPEG);
    232         addFileType("JPEG", FILE_TYPE_JPEG, "image/jpeg", MtpConstants.FORMAT_EXIF_JPEG);
    233         addFileType("GIF", FILE_TYPE_GIF, "image/gif", MtpConstants.FORMAT_GIF);
    234         addFileType("PNG", FILE_TYPE_PNG, "image/png", MtpConstants.FORMAT_PNG);
    235         addFileType("BMP", FILE_TYPE_BMP, "image/x-ms-bmp", MtpConstants.FORMAT_BMP);
    236         addFileType("WBMP", FILE_TYPE_WBMP, "image/vnd.wap.wbmp", MtpConstants.FORMAT_DEFINED);
    237         addFileType("WEBP", FILE_TYPE_WEBP, "image/webp", MtpConstants.FORMAT_DEFINED);
    238 
    239         addFileType("DNG", FILE_TYPE_DNG, "image/x-adobe-dng", MtpConstants.FORMAT_DNG);
    240         addFileType("CR2", FILE_TYPE_CR2, "image/x-canon-cr2", MtpConstants.FORMAT_TIFF);
    241         addFileType("NEF", FILE_TYPE_NEF, "image/x-nikon-nef", MtpConstants.FORMAT_TIFF_EP);
    242         addFileType("NRW", FILE_TYPE_NRW, "image/x-nikon-nrw", MtpConstants.FORMAT_TIFF);
    243         addFileType("ARW", FILE_TYPE_ARW, "image/x-sony-arw", MtpConstants.FORMAT_TIFF);
    244         addFileType("RW2", FILE_TYPE_RW2, "image/x-panasonic-rw2", MtpConstants.FORMAT_TIFF);
    245         addFileType("ORF", FILE_TYPE_ORF, "image/x-olympus-orf", MtpConstants.FORMAT_TIFF);
    246         addFileType("RAF", FILE_TYPE_RAF, "image/x-fuji-raf", MtpConstants.FORMAT_DEFINED);
    247         addFileType("PEF", FILE_TYPE_PEF, "image/x-pentax-pef", MtpConstants.FORMAT_TIFF);
    248         addFileType("SRW", FILE_TYPE_SRW, "image/x-samsung-srw", MtpConstants.FORMAT_TIFF);
    249 
    250         addFileType("M3U", FILE_TYPE_M3U, "audio/x-mpegurl", MtpConstants.FORMAT_M3U_PLAYLIST);
    251         addFileType("M3U", FILE_TYPE_M3U, "application/x-mpegurl", MtpConstants.FORMAT_M3U_PLAYLIST);
    252         addFileType("PLS", FILE_TYPE_PLS, "audio/x-scpls", MtpConstants.FORMAT_PLS_PLAYLIST);
    253         addFileType("WPL", FILE_TYPE_WPL, "application/vnd.ms-wpl", MtpConstants.FORMAT_WPL_PLAYLIST);
    254         addFileType("M3U8", FILE_TYPE_HTTPLIVE, "application/vnd.apple.mpegurl");
    255         addFileType("M3U8", FILE_TYPE_HTTPLIVE, "audio/mpegurl");
    256         addFileType("M3U8", FILE_TYPE_HTTPLIVE, "audio/x-mpegurl");
    257 
    258         addFileType("FL", FILE_TYPE_FL, "application/x-android-drm-fl");
    259 
    260         addFileType("TXT", FILE_TYPE_TEXT, "text/plain", MtpConstants.FORMAT_TEXT);
    261         addFileType("HTM", FILE_TYPE_HTML, "text/html", MtpConstants.FORMAT_HTML);
    262         addFileType("HTML", FILE_TYPE_HTML, "text/html", MtpConstants.FORMAT_HTML);
    263         addFileType("PDF", FILE_TYPE_PDF, "application/pdf");
    264         addFileType("DOC", FILE_TYPE_MS_WORD, "application/msword", MtpConstants.FORMAT_MS_WORD_DOCUMENT);
    265         addFileType("XLS", FILE_TYPE_MS_EXCEL, "application/vnd.ms-excel", MtpConstants.FORMAT_MS_EXCEL_SPREADSHEET);
    266         addFileType("PPT", FILE_TYPE_MS_POWERPOINT, "application/mspowerpoint", MtpConstants.FORMAT_MS_POWERPOINT_PRESENTATION);
    267         addFileType("FLAC", FILE_TYPE_FLAC, "audio/flac", MtpConstants.FORMAT_FLAC);
    268         addFileType("ZIP", FILE_TYPE_ZIP, "application/zip");
    269         addFileType("MPG", FILE_TYPE_MP2PS, "video/mp2p");
    270         addFileType("MPEG", FILE_TYPE_MP2PS, "video/mp2p");
    271     }
    272 
    273     public static boolean isAudioFileType(int fileType) {
    274         return ((fileType >= FIRST_AUDIO_FILE_TYPE &&
    275                 fileType <= LAST_AUDIO_FILE_TYPE) ||
    276                 (fileType >= FIRST_MIDI_FILE_TYPE &&
    277                 fileType <= LAST_MIDI_FILE_TYPE));
    278     }
    279 
    280     public static boolean isVideoFileType(int fileType) {
    281         return (fileType >= FIRST_VIDEO_FILE_TYPE &&
    282                 fileType <= LAST_VIDEO_FILE_TYPE)
    283             || (fileType >= FIRST_VIDEO_FILE_TYPE2 &&
    284                 fileType <= LAST_VIDEO_FILE_TYPE2);
    285     }
    286 
    287     public static boolean isImageFileType(int fileType) {
    288         return (fileType >= FIRST_IMAGE_FILE_TYPE &&
    289                 fileType <= LAST_IMAGE_FILE_TYPE)
    290             || (fileType >= FIRST_RAW_IMAGE_FILE_TYPE &&
    291                 fileType <= LAST_RAW_IMAGE_FILE_TYPE);
    292     }
    293 
    294     public static boolean isRawImageFileType(int fileType) {
    295         return (fileType >= FIRST_RAW_IMAGE_FILE_TYPE &&
    296                 fileType <= LAST_RAW_IMAGE_FILE_TYPE);
    297     }
    298 
    299     public static boolean isPlayListFileType(int fileType) {
    300         return (fileType >= FIRST_PLAYLIST_FILE_TYPE &&
    301                 fileType <= LAST_PLAYLIST_FILE_TYPE);
    302     }
    303 
    304     public static boolean isDrmFileType(int fileType) {
    305         return (fileType >= FIRST_DRM_FILE_TYPE &&
    306                 fileType <= LAST_DRM_FILE_TYPE);
    307     }
    308 
    309     public static MediaFileType getFileType(String path) {
    310         int lastDot = path.lastIndexOf('.');
    311         if (lastDot < 0)
    312             return null;
    313         return sFileTypeMap.get(path.substring(lastDot + 1).toUpperCase(Locale.ROOT));
    314     }
    315 
    316     public static boolean isMimeTypeMedia(String mimeType) {
    317         int fileType = getFileTypeForMimeType(mimeType);
    318         return isAudioFileType(fileType) || isVideoFileType(fileType)
    319                 || isImageFileType(fileType) || isPlayListFileType(fileType);
    320     }
    321 
    322     // generates a title based on file name
    323     public static String getFileTitle(String path) {
    324         // extract file name after last slash
    325         int lastSlash = path.lastIndexOf('/');
    326         if (lastSlash >= 0) {
    327             lastSlash++;
    328             if (lastSlash < path.length()) {
    329                 path = path.substring(lastSlash);
    330             }
    331         }
    332         // truncate the file extension (if any)
    333         int lastDot = path.lastIndexOf('.');
    334         if (lastDot > 0) {
    335             path = path.substring(0, lastDot);
    336         }
    337         return path;
    338     }
    339 
    340     public static int getFileTypeForMimeType(String mimeType) {
    341         Integer value = sMimeTypeMap.get(mimeType);
    342         return (value == null ? 0 : value.intValue());
    343     }
    344 
    345     public static String getMimeTypeForFile(String path) {
    346         MediaFileType mediaFileType = getFileType(path);
    347         return (mediaFileType == null ? null : mediaFileType.mimeType);
    348     }
    349 
    350     public static int getFormatCode(String fileName, String mimeType) {
    351         if (mimeType != null) {
    352             Integer value = sMimeTypeToFormatMap.get(mimeType);
    353             if (value != null) {
    354                 return value.intValue();
    355             }
    356         }
    357         int lastDot = fileName.lastIndexOf('.');
    358         if (lastDot > 0) {
    359             String extension = fileName.substring(lastDot + 1).toUpperCase(Locale.ROOT);
    360             Integer value = sFileTypeToFormatMap.get(extension);
    361             if (value != null) {
    362                 return value.intValue();
    363             }
    364         }
    365         return MtpConstants.FORMAT_UNDEFINED;
    366     }
    367 
    368     public static String getMimeTypeForFormatCode(int formatCode) {
    369         return sFormatToMimeTypeMap.get(formatCode);
    370     }
    371 }
    372