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