org.videolan.libvlc

Class MediaList

java.lang.Object

org.videolan.libvlc.MediaList

All Implemented Interfaces:

IMediaList, IVLCObject<IMediaList.Event>

public class MediaList
extends java.lang.Object
implements IMediaList

Nested Class Summary

Nested classes/interfaces inherited from interface org.videolan.libvlc.interfaces.IMediaList

IMediaList.Event, IMediaList.EventListener

Constructor Summary

Constructors

Modifier	Constructor and Description
	MediaList(ILibVLC ILibVLC) Create a MediaList from libVLC
protected	MediaList(IMedia m)
protected	MediaList(MediaDiscoverer md)

Method Summary

Modifier and Type	Method and Description
protected void	finalize()
int	getCount() Get the number of Media.
ILibVLC	getLibVLC()
IMedia	getMediaAt(int index) Get a Media at specified index.
boolean	isLocked()
boolean	isReleased() Returns true if native object is released
protected IMediaList.Event	onEventNative(int eventType, long arg1, long arg2, float argf1, java.lang.String args1) Called when libvlc send events.
void	onReleaseNative() Called when native object is released (refcount is 0).
void	release() Release the native object if ref count is 1.
boolean	retain() Increment internal ref count of the native object.
protected void	setEventListener(AbstractVLCEvent.Listener<T> listener) Set an event listener.
protected void	setEventListener(AbstractVLCEvent.Listener<T> listener, android.os.Handler handler) Set an event listener and an executor Handler
void	setEventListener(IMediaList.EventListener listener, android.os.Handler handler)

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.videolan.libvlc.interfaces.IVLCObject

getLibVLC, isReleased, release, retain

Constructor Detail

MediaList

public MediaList(ILibVLC ILibVLC)

Create a MediaList from libVLC

Parameters:

ILibVLC - a valid libVLC

MediaList

protected MediaList(MediaDiscoverer md)

Parameters:

md - Should not be released

MediaList

protected MediaList(IMedia m)

Parameters:

m - Should not be released

Method Detail

setEventListener

public void setEventListener(IMediaList.EventListener listener,
                             android.os.Handler handler)

Specified by:

setEventListener in interface IMediaList

onEventNative

protected IMediaList.Event onEventNative(int eventType,
                                         long arg1,
                                         long arg2,
                                         float argf1,
                                         java.lang.String args1)

Called when libvlc send events.

Parameters:

eventType - event type

arg1 - first argument

arg2 - second argument

argf1 - first float argument

Returns:

Event that will be dispatched to listeners

getCount

public int getCount()

Get the number of Media.

Specified by:

getCount in interface IMediaList

getMediaAt

public IMedia getMediaAt(int index)

Get a Media at specified index.

Specified by:

getMediaAt in interface IMediaList

Parameters:

index - index of the media

Returns:

Media hold by MediaList. This Media should be released with release().

onReleaseNative

public void onReleaseNative()

Called when native object is released (refcount is 0). This is where you must release native resources.

isLocked

public boolean isLocked()

Specified by:

isLocked in interface IMediaList

isReleased

public boolean isReleased()

Returns true if native object is released

Specified by:

isReleased in interface IVLCObject<T extends AbstractVLCEvent>

retain

public final boolean retain()

Increment internal ref count of the native object.

Specified by:

retain in interface IVLCObject<T extends AbstractVLCEvent>

Returns:

true if media is retained

release

public final void release()

Release the native object if ref count is 1. After this call, native calls are not possible anymore. You can still call others methods to retrieve cached values. For example: if you parse, then release a media, you'll still be able to retrieve all Metas or Tracks infos.

Specified by:

release in interface IVLCObject<T extends AbstractVLCEvent>

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object

getLibVLC

public ILibVLC getLibVLC()

Specified by:

getLibVLC in interface IVLCObject<T extends AbstractVLCEvent>

setEventListener

protected void setEventListener(AbstractVLCEvent.Listener<T> listener)

Set an event listener. Events are sent via the android main thread.

Parameters:

listener - see AbstractVLCEvent.Listener

setEventListener

protected void setEventListener(AbstractVLCEvent.Listener<T> listener,
                                android.os.Handler handler)

Set an event listener and an executor Handler

Parameters:

listener - see AbstractVLCEvent.Listener

handler - Handler in which events are sent. If null, a handler will be created running on the main thread