MediaFile.java revision 1b50044a271208bdb0893ed941bd21168faf90c4 
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
17package android.media;
18
19import android.content.ContentValues;
20import android.os.SystemProperties;
21import android.provider.MediaStore.Audio;
22import android.provider.MediaStore.Images;
23import android.provider.MediaStore.Video;
24
25import java.util.HashMap;
26import java.util.Iterator;
27
28/**
29 * MediaScanner helper class.
30 *
31 * {@hide}
32 */
33public class MediaFile {
34    // comma separated list of all file extensions supported by the media scanner
35    public final static String sFileExtensions;
36
37    // Audio file types
38    public static final int FILE_TYPE_MP3     = 1;
39    public static final int FILE_TYPE_M4A     = 2;
40    public static final int FILE_TYPE_WAV     = 3;
41    public static final int FILE_TYPE_AMR     = 4;
42    public static final int FILE_TYPE_AWB     = 5;
43    public static final int FILE_TYPE_WMA     = 6;
44    public static final int FILE_TYPE_OGG     = 7;
45    public static final int FILE_TYPE_AAC     = 8;
46    private static final int FIRST_AUDIO_FILE_TYPE = FILE_TYPE_MP3;
47    private static final int LAST_AUDIO_FILE_TYPE = FILE_TYPE_AAC;
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    private static final int FIRST_VIDEO_FILE_TYPE = FILE_TYPE_MP4;
64    private static final int LAST_VIDEO_FILE_TYPE = FILE_TYPE_ASF;
65
66    // Image file types
67    public static final int FILE_TYPE_JPEG    = 31;
68    public static final int FILE_TYPE_GIF     = 32;
69    public static final int FILE_TYPE_PNG     = 33;
70    public static final int FILE_TYPE_BMP     = 34;
71    public static final int FILE_TYPE_WBMP    = 35;
72    private static final int FIRST_IMAGE_FILE_TYPE = FILE_TYPE_JPEG;
73    private static final int LAST_IMAGE_FILE_TYPE = FILE_TYPE_WBMP;
74
75    // Playlist file types
76    public static final int FILE_TYPE_M3U     = 41;
77    public static final int FILE_TYPE_PLS     = 42;
78    public static final int FILE_TYPE_WPL     = 43;
79    private static final int FIRST_PLAYLIST_FILE_TYPE = FILE_TYPE_M3U;
80    private static final int LAST_PLAYLIST_FILE_TYPE = FILE_TYPE_WPL;
81
82    static class MediaFileType {
83
84        int fileType;
85        String mimeType;
86
87        MediaFileType(int fileType, String mimeType) {
88            this.fileType = fileType;
89            this.mimeType = mimeType;
90        }
91    }
92
93    private static HashMap<String, MediaFileType> sFileTypeMap
94            = new HashMap<String, MediaFileType>();
95    private static HashMap<String, Integer> sMimeTypeMap
96            = new HashMap<String, Integer>();
97    static void addFileType(String extension, int fileType, String mimeType) {
98        sFileTypeMap.put(extension, new MediaFileType(fileType, mimeType));
99        sMimeTypeMap.put(mimeType, Integer.valueOf(fileType));
100    }
101    static {
102        addFileType("MP3", FILE_TYPE_MP3, "audio/mpeg");
103        addFileType("M4A", FILE_TYPE_M4A, "audio/mp4");
104        addFileType("WAV", FILE_TYPE_WAV, "audio/x-wav");
105        addFileType("AMR", FILE_TYPE_AMR, "audio/amr");
106        addFileType("AWB", FILE_TYPE_AWB, "audio/amr-wb");
107        if (SystemProperties.getInt("ro.media.dec.aud.wma.enabled", 0) != 0) {
108            addFileType("WMA", FILE_TYPE_WMA, "audio/x-ms-wma");
109        }
110        addFileType("OGG", FILE_TYPE_OGG, "application/ogg");
111        addFileType("OGA", FILE_TYPE_OGG, "application/ogg");
112        addFileType("AAC", FILE_TYPE_AAC, "audio/aac");
113
114        addFileType("MID", FILE_TYPE_MID, "audio/midi");
115        addFileType("MIDI", FILE_TYPE_MID, "audio/midi");
116        addFileType("XMF", FILE_TYPE_MID, "audio/midi");
117        addFileType("RTTTL", FILE_TYPE_MID, "audio/midi");
118        addFileType("SMF", FILE_TYPE_SMF, "audio/sp-midi");
119        addFileType("IMY", FILE_TYPE_IMY, "audio/imelody");
120        addFileType("RTX", FILE_TYPE_MID, "audio/midi");
121        addFileType("OTA", FILE_TYPE_MID, "audio/midi");
122
123        addFileType("MPEG", FILE_TYPE_MP4, "video/mpeg");
124        addFileType("MP4", FILE_TYPE_MP4, "video/mp4");
125        addFileType("M4V", FILE_TYPE_M4V, "video/mp4");
126        addFileType("3GP", FILE_TYPE_3GPP, "video/3gpp");
127        addFileType("3GPP", FILE_TYPE_3GPP, "video/3gpp");
128        addFileType("3G2", FILE_TYPE_3GPP2, "video/3gpp2");
129        addFileType("3GPP2", FILE_TYPE_3GPP2, "video/3gpp2");
130        if (SystemProperties.getInt("ro.media.dec.vid.wmv.enabled", 0) != 0) {
131            addFileType("WMV", FILE_TYPE_WMV, "video/x-ms-wmv");
132            addFileType("ASF", FILE_TYPE_ASF, "video/x-ms-asf");
133        }
134
135        addFileType("JPG", FILE_TYPE_JPEG, "image/jpeg");
136        addFileType("JPEG", FILE_TYPE_JPEG, "image/jpeg");
137        addFileType("GIF", FILE_TYPE_GIF, "image/gif");
138        addFileType("PNG", FILE_TYPE_PNG, "image/png");
139        addFileType("BMP", FILE_TYPE_BMP, "image/x-ms-bmp");
140        addFileType("WBMP", FILE_TYPE_WBMP, "image/vnd.wap.wbmp");
141
142        addFileType("M3U", FILE_TYPE_M3U, "audio/x-mpegurl");
143        addFileType("PLS", FILE_TYPE_PLS, "audio/x-scpls");
144        addFileType("WPL", FILE_TYPE_WPL, "application/vnd.ms-wpl");
145
146        // compute file extensions list for native Media Scanner
147        StringBuilder builder = new StringBuilder();
148        Iterator<String> iterator = sFileTypeMap.keySet().iterator();
149
150        while (iterator.hasNext()) {
151            if (builder.length() > 0) {
152                builder.append(',');
153            }
154            builder.append(iterator.next());
155        }
156        sFileExtensions = builder.toString();
157    }
158
159    public static boolean isAudioFileType(int fileType) {
160        return ((fileType >= FIRST_AUDIO_FILE_TYPE &&
161                fileType <= LAST_AUDIO_FILE_TYPE) ||
162                (fileType >= FIRST_MIDI_FILE_TYPE &&
163                fileType <= LAST_MIDI_FILE_TYPE));
164    }
165
166    public static boolean isVideoFileType(int fileType) {
167        return (fileType >= FIRST_VIDEO_FILE_TYPE &&
168                fileType <= LAST_VIDEO_FILE_TYPE);
169    }
170
171    public static boolean isImageFileType(int fileType) {
172        return (fileType >= FIRST_IMAGE_FILE_TYPE &&
173                fileType <= LAST_IMAGE_FILE_TYPE);
174    }
175
176    public static boolean isPlayListFileType(int fileType) {
177        return (fileType >= FIRST_PLAYLIST_FILE_TYPE &&
178                fileType <= LAST_PLAYLIST_FILE_TYPE);
179    }
180
181    public static MediaFileType getFileType(String path) {
182        int lastDot = path.lastIndexOf(".");
183        if (lastDot < 0)
184            return null;
185        return sFileTypeMap.get(path.substring(lastDot + 1).toUpperCase());
186    }
187
188    public static int getFileTypeForMimeType(String mimeType) {
189        Integer value = sMimeTypeMap.get(mimeType);
190        return (value == null ? 0 : value.intValue());
191    }
192
193}
194