org.videolan.libvlc

Class MediaDiscoverer

java.lang.Object

org.videolan.libvlc.MediaDiscoverer

public class MediaDiscoverer
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MediaDiscoverer.Description
static class	MediaDiscoverer.Event
static interface	MediaDiscoverer.EventListener

Constructor Summary

Constructors

Constructor and Description
MediaDiscoverer(LibVLC libVLC, java.lang.String name) Create a MediaDiscover.

Method Summary

Modifier and Type	Method and Description
protected void	finalize()
MediaList	getMediaList() Get the MediaList associated with the MediaDiscoverer.
boolean	isReleased() Returns true if native object is released
static MediaDiscoverer.Description[]	list(LibVLC libVLC, int category) Get media discoverers by category
protected MediaDiscoverer.Event	onEventNative(int eventType, long arg1, long arg2, float argf1) Called when libvlc send events.
protected 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.
void	setEventListener(MediaDiscoverer.EventListener listener)
protected void	setEventListener(VLCEvent.Listener<T> listener) Set an event listener.
protected void	setEventListener(VLCEvent.Listener<T> listener, android.os.Handler handler) Set an event listener and an executor Handler
boolean	start() Starts the discovery.
void	stop() Stops the discovery.

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaDiscoverer

public MediaDiscoverer(LibVLC libVLC,
                       java.lang.String name)

Create a MediaDiscover.

Parameters:

libVLC - a valid LibVLC

name - Name of the vlc service discovery ("dsm", "upnp", "bonjour"...).

Method Detail

start

public boolean start()

Starts the discovery. This MediaDiscoverer should be alive (not released).

Returns:

true the service is started

stop

public void stop()

Stops the discovery. This MediaDiscoverer should be alive (not released). (You can also call to stop the discovery directly.

setEventListener

public void setEventListener(MediaDiscoverer.EventListener listener)

onEventNative

protected MediaDiscoverer.Event onEventNative(int eventType,
                                              long arg1,
                                              long arg2,
                                              float argf1)

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

getMediaList

public MediaList getMediaList()

Get the MediaList associated with the MediaDiscoverer. This MediaDiscoverer should be alive (not released).

Returns:

MediaList. This MediaList should be released with release().

onReleaseNative

protected void onReleaseNative()

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

list

public static MediaDiscoverer.Description[] list(LibVLC libVLC,
                                                 int category)

Get media discoverers by category

Parameters:

category - see MediaDiscoverer.Description.Category

isReleased

public boolean isReleased()

Returns true if native object is released

retain

public final boolean retain()

Increment internal ref count of the native object.

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.

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object

setEventListener

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

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

Parameters:

listener - see VLCEvent.Listener

setEventListener

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

Set an event listener and an executor Handler

Parameters:

listener - see VLCEvent.Listener

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