it.tidalwave.mobile.media.MediaPlayer Maven / Gradle / Ivy
/***********************************************************************************************************************
*
* blueBill Mobile - open source birdwatching
* ==========================================
*
* Copyright (C) 2009, 2010 by Tidalwave s.a.s. (http://www.tidalwave.it)
* http://bluebill.tidalwave.it/mobile/
*
***********************************************************************************************************************
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
* an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
* specific language governing permissions and limitations under the License.
*
***********************************************************************************************************************
*
* $Id: MediaPlayer.java,v f770a50fc8aa 2010/07/02 00:40:06 fabrizio $
*
**********************************************************************************************************************/
package it.tidalwave.mobile.media;
import java.beans.PropertyChangeListener;
import java.beans.PropertyChangeSupport;
import javax.annotation.Nonnegative;
import javax.annotation.Nonnull;
import java.io.IOException;
/***********************************************************************************************************************
*
* @author Fabrizio Giudici
* @version $Id: $
*
**********************************************************************************************************************/
public interface MediaPlayer
{
/*******************************************************************************************************************
*
*
******************************************************************************************************************/
public static abstract class Controller
{
public static final String PROP_PLAYING = "playing";
protected boolean playing;
private final PropertyChangeSupport propertyChangeSupport = new PropertyChangeSupport(this);
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public abstract void start();
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public abstract void stop();
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public abstract void pause();
/***************************************************************************************************************
*
*
**************************************************************************************************************/
@Nonnegative
public abstract int getDuration();
/***************************************************************************************************************
*
*
**************************************************************************************************************/
@Nonnegative
public abstract int getPosition();
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public abstract void setPosition (@Nonnegative int position);
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public abstract boolean isPlaying();
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public abstract void dispose();
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public void addPropertyChangeListener (final @Nonnull PropertyChangeListener listener)
{
propertyChangeSupport.addPropertyChangeListener(listener);
}
/***************************************************************************************************************
*
*
**************************************************************************************************************/
public void removePropertyChangeListener (final @Nonnull PropertyChangeListener listener)
{
propertyChangeSupport.removePropertyChangeListener(listener);
}
/***************************************************************************************************************
*
*
**************************************************************************************************************/
protected void setPlaying (final boolean playing)
{
final boolean oldPlaying = this.playing;
this.playing = playing;
propertyChangeSupport.firePropertyChange(PROP_PLAYING, oldPlaying, playing);
}
}
/*******************************************************************************************************************
*
* {@inheritDoc}
*
*
******************************************************************************************************************/
@Nonnull
public Controller play (@Nonnull Media media)
throws IOException;
/*******************************************************************************************************************
*
*
*
******************************************************************************************************************/
public void stop(); // rename to stopAll()
}