MediaFile.java revision 0ddbc35dc4974fbe18a4191e579b1eda5a7ef2b1 
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("MP4", FILE_TYPE_MP4, "video/mp4");
124        addFileType("M4V", FILE_TYPE_M4V, "video/mp4");
125        addFileType("3GP", FILE_TYPE_3GPP, "video/3gpp");
126        addFileType("3GPP", FILE_TYPE_3GPP, "video/3gpp");
127        addFileType("3G2", FILE_TYPE_3GPP2, "video/3gpp2");
128        addFileType("3GPP2", FILE_TYPE_3GPP2, "video/3gpp2");
129        if (SystemProperties.getInt("ro.media.dec.vid.wmv.enabled", 0) != 0) {
130            addFileType("WMV", FILE_TYPE_WMV, "video/x-ms-wmv");
131            addFileType("ASF", FILE_TYPE_ASF, "video/x-ms-asf");
132        }
133
134        addFileType("JPG", FILE_TYPE_JPEG, "image/jpeg");
135        addFileType("JPEG", FILE_TYPE_JPEG, "image/jpeg");
136        addFileType("GIF", FILE_TYPE_GIF, "image/gif");
137        addFileType("PNG", FILE_TYPE_PNG, "image/png");
138        addFileType("BMP", FILE_TYPE_BMP, "image/x-ms-bmp");
139        addFileType("WBMP", FILE_TYPE_WBMP, "image/vnd.wap.wbmp");
140
141        addFileType("M3U", FILE_TYPE_M3U, "audio/x-mpegurl");
142        addFileType("PLS", FILE_TYPE_PLS, "audio/x-scpls");
143        addFileType("WPL", FILE_TYPE_WPL, "application/vnd.ms-wpl");
144
145        // compute file extensions list for native Media Scanner
146        StringBuilder builder = new StringBuilder();
147        Iterator<String> iterator = sFileTypeMap.keySet().iterator();
148
149        while (iterator.hasNext()) {
150            if (builder.length() > 0) {
151                builder.append(',');
152            }
153            builder.append(iterator.next());
154        }
155        sFileExtensions = builder.toString();
156    }
157
158    public static final String UNKNOWN_STRING = "<unknown>";
159
160    public static boolean isAudioFileType(int fileType) {
161        return ((fileType >= FIRST_AUDIO_FILE_TYPE &&
162                fileType <= LAST_AUDIO_FILE_TYPE) ||
163                (fileType >= FIRST_MIDI_FILE_TYPE &&
164                fileType <= LAST_MIDI_FILE_TYPE));
165    }
166
167    public static boolean isVideoFileType(int fileType) {
168        return (fileType >= FIRST_VIDEO_FILE_TYPE &&
169                fileType <= LAST_VIDEO_FILE_TYPE);
170    }
171
172    public static boolean isImageFileType(int fileType) {
173        return (fileType >= FIRST_IMAGE_FILE_TYPE &&
174                fileType <= LAST_IMAGE_FILE_TYPE);
175    }
176
177    public static boolean isPlayListFileType(int fileType) {
178        return (fileType >= FIRST_PLAYLIST_FILE_TYPE &&
179                fileType <= LAST_PLAYLIST_FILE_TYPE);
180    }
181
182    public static MediaFileType getFileType(String path) {
183        int lastDot = path.lastIndexOf(".");
184        if (lastDot < 0)
185            return null;
186        return sFileTypeMap.get(path.substring(lastDot + 1).toUpperCase());
187    }
188
189    public static int getFileTypeForMimeType(String mimeType) {
190        Integer value = sMimeTypeMap.get(mimeType);
191        return (value == null ? 0 : value.intValue());
192    }
193
194}
195