1 /* 2 * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package com.sun.media.jfxmediaimpl.platform; 27 28 import com.sun.media.jfxmedia.Media; 29 import com.sun.media.jfxmedia.MediaPlayer; 30 import com.sun.media.jfxmedia.MetadataParser; 31 import com.sun.media.jfxmedia.locator.Locator; 32 33 /** 34 * JFXMedia platform interface. 35 */ 36 public abstract class Platform { 37 /* 38 * Get an instance of the platform. 39 */ 40 public static Platform getPlatformInstance() { 41 throw new UnsupportedOperationException("Invalid platform class."); 42 } 43 44 /* 45 * Loading stages 46 * preloadPlatform gives the platform a chance to load or check dependencies 47 * before the main jfxmedia library is loaded. Then loadPlatform is called 48 * after jfxmedia library is loaded in case the platform has further 49 * dependencies. 50 */ 51 public void preloadPlatform() {} 52 53 /** 54 * @return false if the platform cannot be loaded 55 */ 56 public boolean loadPlatform() { 57 return false; 58 } 59 60 public boolean canPlayContentType(String contentType) { 61 String[] contentTypes = getSupportedContentTypes(); 62 if (contentTypes != null) { 63 for (String type : contentTypes) { 64 if (type.equalsIgnoreCase(contentType)) { 65 return true; 66 } 67 } 68 } 69 return false; 70 } 71 72 // NB: This method returns only content which can actually be PLAYED. It 73 // does not account for metadata being able to be parsed without the media 74 // being able to be played. 75 public String[] getSupportedContentTypes() { 76 return null; 77 } 78 79 // XXX javadoc 80 public MetadataParser createMetadataParser(Locator source) { 81 return null; 82 } 83 84 public abstract Media createMedia(Locator source); 85 86 /** 87 * Prepare for playing the specified media. If the media stream is unsupported 88 * return null so other platforms may be used, otherwise return an Object 89 * that gets passed to createMediaPlayer to create the actual player. 90 */ 91 public abstract Object prerollMediaPlayer(Locator source); 92 public abstract MediaPlayer createMediaPlayer(Locator source, Object cookie); 93 }