MediaFile.java revision 45b43622e329c25c6070a3f2f2fc2ba5a14533bb
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.provider.MediaStore.Audio; 21import android.provider.MediaStore.Images; 22import android.provider.MediaStore.Video; 23import android.media.DecoderCapabilities; 24import android.media.DecoderCapabilities.VideoDecoder; 25import android.media.DecoderCapabilities.AudioDecoder; 26 27import java.util.HashMap; 28import java.util.Iterator; 29import java.util.List; 30 31/** 32 * MediaScanner helper class. 33 * 34 * {@hide} 35 */ 36public class MediaFile { 37 38 // Audio file types 39 public static final int FILE_TYPE_MP3 = 1; 40 public static final int FILE_TYPE_M4A = 2; 41 public static final int FILE_TYPE_WAV = 3; 42 public static final int FILE_TYPE_AMR = 4; 43 public static final int FILE_TYPE_AWB = 5; 44 public static final int FILE_TYPE_WMA = 6; 45 public static final int FILE_TYPE_OGG = 7; 46 public static final int FILE_TYPE_AAC = 8; 47 public static final int FILE_TYPE_MKA = 9; 48 private static final int FIRST_AUDIO_FILE_TYPE = FILE_TYPE_MP3; 49 private static final int LAST_AUDIO_FILE_TYPE = FILE_TYPE_MKA; 50 51 // MIDI file types 52 public static final int FILE_TYPE_MID = 11; 53 public static final int FILE_TYPE_SMF = 12; 54 public static final int FILE_TYPE_IMY = 13; 55 private static final int FIRST_MIDI_FILE_TYPE = FILE_TYPE_MID; 56 private static final int LAST_MIDI_FILE_TYPE = FILE_TYPE_IMY; 57 58 // Video file types 59 public static final int FILE_TYPE_MP4 = 21; 60 public static final int FILE_TYPE_M4V = 22; 61 public static final int FILE_TYPE_3GPP = 23; 62 public static final int FILE_TYPE_3GPP2 = 24; 63 public static final int FILE_TYPE_WMV = 25; 64 public static final int FILE_TYPE_ASF = 26; 65 public static final int FILE_TYPE_MKV = 27; 66 public static final int FILE_TYPE_MP2TS = 28; 67 private static final int FIRST_VIDEO_FILE_TYPE = FILE_TYPE_MP4; 68 private static final int LAST_VIDEO_FILE_TYPE = FILE_TYPE_MP2TS; 69 70 // Image file types 71 public static final int FILE_TYPE_JPEG = 31; 72 public static final int FILE_TYPE_GIF = 32; 73 public static final int FILE_TYPE_PNG = 33; 74 public static final int FILE_TYPE_BMP = 34; 75 public static final int FILE_TYPE_WBMP = 35; 76 private static final int FIRST_IMAGE_FILE_TYPE = FILE_TYPE_JPEG; 77 private static final int LAST_IMAGE_FILE_TYPE = FILE_TYPE_WBMP; 78 79 // Playlist file types 80 public static final int FILE_TYPE_M3U = 41; 81 public static final int FILE_TYPE_PLS = 42; 82 public static final int FILE_TYPE_WPL = 43; 83 private static final int FIRST_PLAYLIST_FILE_TYPE = FILE_TYPE_M3U; 84 private static final int LAST_PLAYLIST_FILE_TYPE = FILE_TYPE_WPL; 85 86 // Other popular file types 87 public static final int FILE_TYPE_TEXT = 100; 88 public static final int FILE_TYPE_HTML = 101; 89 public static final int FILE_TYPE_PDF = 102; 90 public static final int FILE_TYPE_XML = 103; 91 public static final int FILE_TYPE_MS_WORD = 104; 92 public static final int FILE_TYPE_MS_EXCEL = 105; 93 public static final int FILE_TYPE_MS_POWERPOINT = 106; 94 public static final int FILE_TYPE_FLAC = 107; 95 public static final int FILE_TYPE_ZIP = 108; 96 97 static class MediaFileType { 98 99 int fileType; 100 String mimeType; 101 102 MediaFileType(int fileType, String mimeType) { 103 this.fileType = fileType; 104 this.mimeType = mimeType; 105 } 106 } 107 108 private static HashMap<String, MediaFileType> sFileTypeMap 109 = new HashMap<String, MediaFileType>(); 110 private static HashMap<String, Integer> sMimeTypeMap 111 = new HashMap<String, Integer>(); 112 // maps file extension to MTP format code 113 private static HashMap<String, Integer> sFileTypeToFormatMap 114 = new HashMap<String, Integer>(); 115 // maps mime type to MTP format code 116 private static HashMap<String, Integer> sMimeTypeToFormatMap 117 = new HashMap<String, Integer>(); 118 // maps MTP format code to mime type 119 private static HashMap<Integer, String> sFormatToMimeTypeMap 120 = new HashMap<Integer, String>(); 121 122 static void addFileType(String extension, int fileType, String mimeType) { 123 sFileTypeMap.put(extension, new MediaFileType(fileType, mimeType)); 124 sMimeTypeMap.put(mimeType, Integer.valueOf(fileType)); 125 } 126 127 static void addFileType(String extension, int fileType, String mimeType, int mtpFormatCode) { 128 addFileType(extension, fileType, mimeType); 129 sFileTypeToFormatMap.put(extension, Integer.valueOf(mtpFormatCode)); 130 sMimeTypeToFormatMap.put(mimeType, Integer.valueOf(mtpFormatCode)); 131 sFormatToMimeTypeMap.put(mtpFormatCode, mimeType); 132 } 133 134 private static boolean isWMAEnabled() { 135 List<AudioDecoder> decoders = DecoderCapabilities.getAudioDecoders(); 136 for (AudioDecoder decoder: decoders) { 137 if (decoder == AudioDecoder.AUDIO_DECODER_WMA) { 138 return true; 139 } 140 } 141 return false; 142 } 143 144 static { 145 addFileType("MP3", FILE_TYPE_MP3, "audio/mpeg", MtpConstants.FORMAT_MP3); 146 addFileType("M4A", FILE_TYPE_M4A, "audio/mp4", MtpConstants.FORMAT_MPEG); 147 addFileType("WAV", FILE_TYPE_WAV, "audio/x-wav", MtpConstants.FORMAT_WAV); 148 addFileType("AMR", FILE_TYPE_AMR, "audio/amr"); 149 addFileType("AWB", FILE_TYPE_AWB, "audio/amr-wb"); 150 if (isWMAEnabled()) { 151 addFileType("WMA", FILE_TYPE_WMA, "audio/x-ms-wma", MtpConstants.FORMAT_WMA); 152 } 153 addFileType("OGG", FILE_TYPE_OGG, "application/ogg", MtpConstants.FORMAT_OGG); 154 addFileType("OGA", FILE_TYPE_OGG, "application/ogg", MtpConstants.FORMAT_OGG); 155 addFileType("AAC", FILE_TYPE_AAC, "audio/aac", MtpConstants.FORMAT_AAC); 156 addFileType("MKA", FILE_TYPE_MKA, "audio/x-matroska"); 157 158 addFileType("MID", FILE_TYPE_MID, "audio/midi"); 159 addFileType("MIDI", FILE_TYPE_MID, "audio/midi"); 160 addFileType("XMF", FILE_TYPE_MID, "audio/midi"); 161 addFileType("RTTTL", FILE_TYPE_MID, "audio/midi"); 162 addFileType("SMF", FILE_TYPE_SMF, "audio/sp-midi"); 163 addFileType("IMY", FILE_TYPE_IMY, "audio/imelody"); 164 addFileType("RTX", FILE_TYPE_MID, "audio/midi"); 165 addFileType("OTA", FILE_TYPE_MID, "audio/midi"); 166 167 addFileType("MPEG", FILE_TYPE_MP4, "video/mpeg", MtpConstants.FORMAT_MPEG); 168 addFileType("MP4", FILE_TYPE_MP4, "video/mp4", MtpConstants.FORMAT_MPEG); 169 addFileType("M4V", FILE_TYPE_M4V, "video/mp4", MtpConstants.FORMAT_MPEG); 170 addFileType("3GP", FILE_TYPE_3GPP, "video/3gpp", MtpConstants.FORMAT_3GP_CONTAINER); 171 addFileType("3GPP", FILE_TYPE_3GPP, "video/3gpp", MtpConstants.FORMAT_3GP_CONTAINER); 172 addFileType("3G2", FILE_TYPE_3GPP2, "video/3gpp2", MtpConstants.FORMAT_3GP_CONTAINER); 173 addFileType("3GPP2", FILE_TYPE_3GPP2, "video/3gpp2", MtpConstants.FORMAT_3GP_CONTAINER); 174 addFileType("MKV", FILE_TYPE_MKV, "video/x-matroska"); 175 addFileType("WEBM", FILE_TYPE_MKV, "video/x-matroska"); 176 addFileType("TS", FILE_TYPE_MP2TS, "video/mp2ts"); 177 178 addFileType("WMV", FILE_TYPE_WMV, "video/x-ms-wmv", MtpConstants.FORMAT_WMV); 179 addFileType("ASF", FILE_TYPE_ASF, "video/x-ms-asf"); 180 181 addFileType("JPG", FILE_TYPE_JPEG, "image/jpeg", MtpConstants.FORMAT_EXIF_JPEG); 182 addFileType("JPEG", FILE_TYPE_JPEG, "image/jpeg", MtpConstants.FORMAT_EXIF_JPEG); 183 addFileType("GIF", FILE_TYPE_GIF, "image/gif", MtpConstants.FORMAT_GIF); 184 addFileType("PNG", FILE_TYPE_PNG, "image/png", MtpConstants.FORMAT_PNG); 185 addFileType("BMP", FILE_TYPE_BMP, "image/x-ms-bmp", MtpConstants.FORMAT_BMP); 186 addFileType("WBMP", FILE_TYPE_WBMP, "image/vnd.wap.wbmp"); 187 188 addFileType("M3U", FILE_TYPE_M3U, "audio/x-mpegurl", MtpConstants.FORMAT_M3U_PLAYLIST); 189 addFileType("PLS", FILE_TYPE_PLS, "audio/x-scpls", MtpConstants.FORMAT_PLS_PLAYLIST); 190 addFileType("WPL", FILE_TYPE_WPL, "application/vnd.ms-wpl", MtpConstants.FORMAT_WPL_PLAYLIST); 191 192 addFileType("TXT", FILE_TYPE_TEXT, "text/plain", MtpConstants.FORMAT_TEXT); 193 addFileType("HTM", FILE_TYPE_HTML, "text/html", MtpConstants.FORMAT_HTML); 194 addFileType("HTML", FILE_TYPE_HTML, "text/html", MtpConstants.FORMAT_HTML); 195 addFileType("PDF", FILE_TYPE_PDF, "application/pdf"); 196 addFileType("DOC", FILE_TYPE_MS_WORD, "application/msword", MtpConstants.FORMAT_MS_WORD_DOCUMENT); 197 addFileType("XLS", FILE_TYPE_MS_EXCEL, "application/vnd.ms-excel", MtpConstants.FORMAT_MS_EXCEL_SPREADSHEET); 198 addFileType("PPT", FILE_TYPE_MS_POWERPOINT, "application/mspowerpoint", MtpConstants.FORMAT_MS_POWERPOINT_PRESENTATION); 199 addFileType("FLAC", FILE_TYPE_FLAC, "audio/flac", MtpConstants.FORMAT_FLAC); 200 addFileType("ZIP", FILE_TYPE_ZIP, "application/zip"); 201 } 202 203 public static boolean isAudioFileType(int fileType) { 204 return ((fileType >= FIRST_AUDIO_FILE_TYPE && 205 fileType <= LAST_AUDIO_FILE_TYPE) || 206 (fileType >= FIRST_MIDI_FILE_TYPE && 207 fileType <= LAST_MIDI_FILE_TYPE)); 208 } 209 210 public static boolean isVideoFileType(int fileType) { 211 return (fileType >= FIRST_VIDEO_FILE_TYPE && 212 fileType <= LAST_VIDEO_FILE_TYPE); 213 } 214 215 public static boolean isImageFileType(int fileType) { 216 return (fileType >= FIRST_IMAGE_FILE_TYPE && 217 fileType <= LAST_IMAGE_FILE_TYPE); 218 } 219 220 public static boolean isPlayListFileType(int fileType) { 221 return (fileType >= FIRST_PLAYLIST_FILE_TYPE && 222 fileType <= LAST_PLAYLIST_FILE_TYPE); 223 } 224 225 public static MediaFileType getFileType(String path) { 226 int lastDot = path.lastIndexOf("."); 227 if (lastDot < 0) 228 return null; 229 return sFileTypeMap.get(path.substring(lastDot + 1).toUpperCase()); 230 } 231 232 public static boolean isMimeTypeMedia(String mimeType) { 233 int fileType = getFileTypeForMimeType(mimeType); 234 return isAudioFileType(fileType) || isVideoFileType(fileType) 235 || isImageFileType(fileType) || isPlayListFileType(fileType); 236 } 237 238 // generates a title based on file name 239 public static String getFileTitle(String path) { 240 // extract file name after last slash 241 int lastSlash = path.lastIndexOf('/'); 242 if (lastSlash >= 0) { 243 lastSlash++; 244 if (lastSlash < path.length()) { 245 path = path.substring(lastSlash); 246 } 247 } 248 // truncate the file extension (if any) 249 int lastDot = path.lastIndexOf('.'); 250 if (lastDot > 0) { 251 path = path.substring(0, lastDot); 252 } 253 return path; 254 } 255 256 public static int getFileTypeForMimeType(String mimeType) { 257 Integer value = sMimeTypeMap.get(mimeType); 258 return (value == null ? 0 : value.intValue()); 259 } 260 261 public static String getMimeTypeForFile(String path) { 262 MediaFileType mediaFileType = getFileType(path); 263 return (mediaFileType == null ? null : mediaFileType.mimeType); 264 } 265 266 public static int getFormatCode(String fileName, String mimeType) { 267 if (mimeType != null) { 268 Integer value = sMimeTypeToFormatMap.get(mimeType); 269 if (value != null) { 270 return value.intValue(); 271 } 272 } 273 int lastDot = fileName.lastIndexOf('.'); 274 if (lastDot > 0) { 275 String extension = fileName.substring(lastDot + 1); 276 Integer value = sFileTypeToFormatMap.get(extension); 277 if (value != null) { 278 return value.intValue(); 279 } 280 } 281 return MtpConstants.FORMAT_UNDEFINED; 282 } 283 284 public static String getMimeTypeForFormatCode(int formatCode) { 285 return sFormatToMimeTypeMap.get(formatCode); 286 } 287} 288