/* * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package sun.audio; import java.io.InputStream; import java.security.AccessController; import java.security.PrivilegedAction; /** * This class provides an interface to play audio streams. * * To play an audio stream use: *
* AudioPlayer.player.start(audiostream); ** To stop playing an audio stream use: *
* AudioPlayer.player.stop(audiostream); ** To play an audio stream from a URL use: *
* AudioStream audiostream = new AudioStream(url.openStream()); * AudioPlayer.player.start(audiostream); ** To play a continuous sound you first have to * create an AudioData instance and use it to construct a * ContinuousAudioDataStream. * For example: *
* AudioData data = new AudioStream(url.openStream()).getData(); * ContinuousAudioDataStream audiostream = new ContinuousAudioDataStream(data); * AudioPlayer.player.start(audiostream); ** * @see AudioData * @see AudioDataStream * @see AudioDevice * @see AudioStream * @author Arthur van Hoff, Thomas Ball */ public final class AudioPlayer extends Thread { private final AudioDevice devAudio; private final static boolean DEBUG = false /*true*/; /** * The default audio player. This audio player is initialized * automatically. */ public static final AudioPlayer player = getAudioPlayer(); private static ThreadGroup getAudioThreadGroup() { if(DEBUG) { System.out.println("AudioPlayer.getAudioThreadGroup()"); } ThreadGroup g = currentThread().getThreadGroup(); while ((g.getParent() != null) && (g.getParent().getParent() != null)) { g = g.getParent(); } return g; } /** * Create an AudioPlayer thread in a privileged block. */ private static AudioPlayer getAudioPlayer() { if(DEBUG) { System.out.println("> AudioPlayer.getAudioPlayer()"); } PrivilegedAction