org.videolan.libvlc

Class Media

java.lang.Object

org.videolan.libvlc.Media

All Implemented Interfaces:

IMedia, IVLCObject<IMedia.Event>

public class Media
extends java.lang.Object
implements IMedia

Nested Class Summary

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

IMedia.AudioTrack, IMedia.Event, IMedia.EventListener, IMedia.Meta, IMedia.Parse, IMedia.ParsedStatus, IMedia.Slave, IMedia.State, IMedia.Stats, IMedia.SubtitleTrack, IMedia.Track, IMedia.Type, IMedia.UnknownTrack, IMedia.VideoTrack

Constructor Summary

Constructors

Modifier	Constructor and Description
	Media(ILibVLC ILibVLC, android.content.res.AssetFileDescriptor afd) Create a Media from libVLC and an AssetFileDescriptor
	Media(ILibVLC ILibVLC, java.io.FileDescriptor fd) Create a Media from libVLC and a FileDescriptor
	Media(ILibVLC ILibVLC, java.lang.String path) Create a Media from libVLC and a local path starting with '/'.
	Media(ILibVLC ILibVLC, android.net.Uri uri) Create a Media from libVLC and a Uri
protected	Media(IMediaList ml, int index)

Method Summary

Modifier and Type	Method and Description
void	addOption(java.lang.String option) Add an option to this Media.
void	addSlave(IMedia.Slave slave) Add a slave to the current media.
void	clearSlaves() Clear all slaves previously added by IMedia.addSlave(Slave) or internally.
protected void	finalize()
long	getDuration() Get the duration of the media.
ILibVLC	getLibVLC()
java.lang.String	getMeta(int id) Get a Meta.
IMedia.Slave[]	getSlaves() Get a media's slave list The list will contain slaves parsed by VLC or previously added by IMedia.addSlave(Slave).
int	getState() Get the state of the media.
IMedia.Stats	getStats() Get the stats related to the playing media
IMedia.Track	getTrack(int idx) Get a Track The Track can be casted to AudioTrack, VideoTrack or SubtitleTrack in function of the Track.Type.
int	getTrackCount() Get the Track count.
int	getType() Get the type of the media
android.net.Uri	getUri() Get the MRL associated with the Media.
boolean	isParsed() Returns true if the media is parsed This Media should be alive (not released).
boolean	isReleased() Returns true if native object is released
protected IMedia.Event	onEventNative(int eventType, long arg1, long arg2, float argf1, java.lang.String args1) Called when libvlc send events.
protected void	onReleaseNative() Called when native object is released (refcount is 0).
boolean	parse() Parse the media and local art synchronously.
boolean	parse(int flags) Parse the media synchronously with a flag.
boolean	parseAsync() Parse the media and local art asynchronously.
boolean	parseAsync(int flags)
boolean	parseAsync(int flags, int timeout) Parse the media asynchronously with a flag.
void	release() Release the native object if ref count is 1.
boolean	retain() Increment internal ref count of the native object.
void	setDefaultMediaPlayerOptions() Enable HWDecoder options if not already set
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(IMedia.EventListener listener)
void	setHWDecoderEnabled(boolean enabled, boolean force) Add or remove hw acceleration media options
MediaList	subItems() Get the subItems MediaList associated with the Media.

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

Media

public Media(ILibVLC ILibVLC,
             java.lang.String path)

Create a Media from libVLC and a local path starting with '/'.

Parameters:

ILibVLC - a valid libVLC

path - an absolute local path

Media

public Media(ILibVLC ILibVLC,
             android.net.Uri uri)

Create a Media from libVLC and a Uri

Parameters:

ILibVLC - a valid libVLC

uri - a valid RFC 2396 Uri

Media

public Media(ILibVLC ILibVLC,
             java.io.FileDescriptor fd)

Create a Media from libVLC and a FileDescriptor

Parameters:

ILibVLC - a valid LibVLC

fd - file descriptor object

Media

public Media(ILibVLC ILibVLC,
             android.content.res.AssetFileDescriptor afd)

Create a Media from libVLC and an AssetFileDescriptor

Parameters:

ILibVLC - a valid LibVLC

afd - asset file descriptor object

Media

protected Media(IMediaList ml,
                int index)

Parameters:

ml - Should not be released and locked

index - index of the Media from the MediaList

Method Detail

setEventListener

public void setEventListener(IMedia.EventListener listener)

Specified by:

setEventListener in interface IMedia

onEventNative

protected IMedia.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

getUri

public android.net.Uri getUri()

Get the MRL associated with the Media.

Specified by:

getUri in interface IMedia

getDuration

public long getDuration()

Get the duration of the media.

Specified by:

getDuration in interface IMedia

getState

public int getState()

Get the state of the media.

Specified by:

getState in interface IMedia

See Also:

State

subItems

public MediaList subItems()

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

Specified by:

subItems in interface IMedia

Returns:

subItems as a MediaList. This MediaList should be released with release().

parse

public boolean parse(int flags)

Parse the media synchronously with a flag. This Media should be alive (not released).

Specified by:

parse in interface IMedia

Parameters:

flags - see Parse

Returns:

true in case of success, false otherwise.

parse

public boolean parse()

Parse the media and local art synchronously. This Media should be alive (not released).

Specified by:

parse in interface IMedia

Returns:

true in case of success, false otherwise.

parseAsync

public boolean parseAsync(int flags,
                          int timeout)

Parse the media asynchronously with a flag. This Media should be alive (not released). To track when this is over you can listen to Event#ParsedChanged event (only if this methods returned true).

Specified by:

parseAsync in interface IMedia

Parameters:

flags - see Parse

timeout - maximum time allowed to preparse the media. If -1, the default "preparse-timeout" option will be used as a timeout. If 0, it will wait indefinitely. If > 0, the timeout will be used (in milliseconds).

Returns:

true in case of success, false otherwise.

parseAsync

public boolean parseAsync(int flags)

Specified by:

parseAsync in interface IMedia

parseAsync

public boolean parseAsync()

Parse the media and local art asynchronously. This Media should be alive (not released).

Specified by:

parseAsync in interface IMedia

See Also:

parseAsync(int)

isParsed

public boolean isParsed()

Returns true if the media is parsed This Media should be alive (not released).

Specified by:

isParsed in interface IMedia

getType

public int getType()

Get the type of the media

Specified by:

getType in interface IMedia

See Also:

Type}

getTrackCount

public int getTrackCount()

Get the Track count.

Specified by:

getTrackCount in interface IMedia

getTrack

public IMedia.Track getTrack(int idx)

Get a Track The Track can be casted to AudioTrack, VideoTrack or SubtitleTrack in function of the Track.Type.

Specified by:

getTrack in interface IMedia

Parameters:

idx - index of the track

Returns:

Track or null if not idx is not valid

See Also:

getTrackCount()

getMeta

public java.lang.String getMeta(int id)

Get a Meta.

Specified by:

getMeta in interface IMedia

Parameters:

id - see Meta

Returns:

meta or null if not found

setHWDecoderEnabled

public void setHWDecoderEnabled(boolean enabled,
                                boolean force)

Add or remove hw acceleration media options

Specified by:

setHWDecoderEnabled in interface IMedia

Parameters:

enabled - if true, hw decoder will be used

force - force hw acceleration even for unknown devices

setDefaultMediaPlayerOptions

public void setDefaultMediaPlayerOptions()

Enable HWDecoder options if not already set

Specified by:

setDefaultMediaPlayerOptions in interface IMedia

addOption

public void addOption(java.lang.String option)

Add an option to this Media. This Media should be alive (not released).

Specified by:

addOption in interface IMedia

Parameters:

option - ":option" or ":option=value"

addSlave

public void addSlave(IMedia.Slave slave)

Add a slave to the current media. A slave is an external input source that may contains an additional subtitle track (like a .srt) or an additional audio track (like a .ac3). This function must be called before the media is parsed (via parseAsync(int)} or before the media is played (via MediaPlayer.play())

Specified by:

addSlave in interface IMedia

clearSlaves

public void clearSlaves()

Clear all slaves previously added by IMedia.addSlave(Slave) or internally.

Specified by:

clearSlaves in interface IMedia

getSlaves

public IMedia.Slave[] getSlaves()

Get a media's slave list The list will contain slaves parsed by VLC or previously added by IMedia.addSlave(Slave). The typical use case of this function is to save a list of slave in a database for a later use.

Specified by:

getSlaves in interface IMedia

getStats

public IMedia.Stats getStats()

Get the stats related to the playing media

Specified by:

getStats in interface IMedia

onReleaseNative

protected void onReleaseNative()

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

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