Collaboration diagram for LibVLC media:

Files
file	libvlc_media.h

Data Structures
struct	libvlc_media_stats_t

struct	libvlc_media_track_info_t

struct	libvlc_audio_track_t

struct	libvlc_video_viewpoint_t
	Viewpoint. More...

struct	libvlc_video_track_t

struct	libvlc_subtitle_track_t

struct	libvlc_media_track_t

struct	libvlc_media_slave_t
	A slave of a libvlc_media_t. More...

Macros
#define	VLC_FORWARD_DECLARE_OBJECT(a) struct a

Typedefs
typedef struct libvlc_media_t	libvlc_media_t

typedef enum libvlc_meta_t	libvlc_meta_t
	Meta data types. More...

typedef enum libvlc_state_t	libvlc_state_t
	Note the order of libvlc_state_t enum must match exactly the order of. More...

typedef enum libvlc_track_type_t	libvlc_track_type_t

typedef struct libvlc_media_stats_t	libvlc_media_stats_t

typedef struct libvlc_media_track_info_t	libvlc_media_track_info_t

typedef struct libvlc_audio_track_t	libvlc_audio_track_t

typedef enum libvlc_video_orient_t	libvlc_video_orient_t

typedef enum libvlc_video_projection_t	libvlc_video_projection_t

typedef struct libvlc_video_viewpoint_t	libvlc_video_viewpoint_t
	Viewpoint. More...

typedef struct libvlc_video_track_t	libvlc_video_track_t

typedef struct libvlc_subtitle_track_t	libvlc_subtitle_track_t

typedef struct libvlc_media_track_t	libvlc_media_track_t

typedef enum libvlc_media_type_t	libvlc_media_type_t
	Media type. More...

typedef enum libvlc_media_parse_flag_t	libvlc_media_parse_flag_t
	Parse flags used by libvlc_media_parse_with_options() More...

typedef enum libvlc_media_parsed_status_t	libvlc_media_parsed_status_t
	Parse status used sent by libvlc_media_parse_with_options() or returned by libvlc_media_get_parsed_status() More...

typedef enum libvlc_media_slave_type_t	libvlc_media_slave_type_t
	Type of a media slave: subtitle or audio. More...

typedef struct libvlc_media_slave_t	libvlc_media_slave_t
	A slave of a libvlc_media_t. More...

typedef int(*	libvlc_media_open_cb) (void opaque, void datap, uint64_t sizep)
	Callback prototype to open a custom bitstream input media. More...

typedef ssize_t(*	libvlc_media_read_cb) (void opaque, unsigned char buf, size_t len)
	Callback prototype to read data from a custom bitstream input media. More...

typedef int(*	libvlc_media_seek_cb) (void *opaque, uint64_t offset)
	Callback prototype to seek a custom bitstream input media. More...

typedef void(*	libvlc_media_close_cb) (void *opaque)
	Callback prototype to close a custom bitstream input media. More...

Enumerations
enum	libvlc_meta_t { libvlc_meta_Title, libvlc_meta_Artist, libvlc_meta_Genre, libvlc_meta_Copyright, libvlc_meta_Album, libvlc_meta_TrackNumber, libvlc_meta_Description, libvlc_meta_Rating, libvlc_meta_Date, libvlc_meta_Setting, libvlc_meta_URL, libvlc_meta_Language, libvlc_meta_NowPlaying, libvlc_meta_Publisher, libvlc_meta_EncodedBy, libvlc_meta_ArtworkURL, libvlc_meta_TrackID, libvlc_meta_TrackTotal, libvlc_meta_Director, libvlc_meta_Season, libvlc_meta_Episode, libvlc_meta_ShowName, libvlc_meta_Actors, libvlc_meta_AlbumArtist, libvlc_meta_DiscNumber, libvlc_meta_DiscTotal }
	Meta data types. More...

enum	libvlc_state_t { libvlc_NothingSpecial =0, libvlc_Opening, libvlc_Buffering, libvlc_Playing, libvlc_Paused, libvlc_Stopped, libvlc_Ended, libvlc_Error }
	Note the order of libvlc_state_t enum must match exactly the order of. More...

enum	{ libvlc_media_option_trusted = 0x2, libvlc_media_option_unique = 0x100 }

enum	libvlc_track_type_t { libvlc_track_unknown = -1, libvlc_track_audio = 0, libvlc_track_video = 1, libvlc_track_text = 2 }

enum	libvlc_video_orient_t { libvlc_video_orient_top_left, libvlc_video_orient_top_right, libvlc_video_orient_bottom_left, libvlc_video_orient_bottom_right, libvlc_video_orient_left_top, libvlc_video_orient_left_bottom, libvlc_video_orient_right_top, libvlc_video_orient_right_bottom }

enum	libvlc_video_projection_t { libvlc_video_projection_rectangular, libvlc_video_projection_equirectangular, libvlc_video_projection_cubemap_layout_standard = 0x100 }

enum	libvlc_media_type_t { libvlc_media_type_unknown, libvlc_media_type_file, libvlc_media_type_directory, libvlc_media_type_disc, libvlc_media_type_stream, libvlc_media_type_playlist }
	Media type. More...

enum	libvlc_media_parse_flag_t { libvlc_media_parse_local = 0x00, libvlc_media_parse_network = 0x01, libvlc_media_fetch_local = 0x02, libvlc_media_fetch_network = 0x04, libvlc_media_do_interact = 0x08 }
	Parse flags used by libvlc_media_parse_with_options() More...

enum	libvlc_media_parsed_status_t { libvlc_media_parsed_status_skipped = 1, libvlc_media_parsed_status_failed, libvlc_media_parsed_status_timeout, libvlc_media_parsed_status_done }
	Parse status used sent by libvlc_media_parse_with_options() or returned by libvlc_media_get_parsed_status() More...

enum	libvlc_media_slave_type_t { libvlc_media_slave_type_subtitle, libvlc_media_slave_type_audio }
	Type of a media slave: subtitle or audio. More...

Functions
LIBVLC_API libvlc_media_t *	libvlc_media_new_location (libvlc_instance_t p_instance, const char psz_mrl)
	Create a media with a certain given media resource location, for instance a valid URL. More...

LIBVLC_API libvlc_media_t *	libvlc_media_new_path (libvlc_instance_t p_instance, const char path)
	Create a media for a certain file path. More...

LIBVLC_API libvlc_media_t *	libvlc_media_new_fd (libvlc_instance_t *p_instance, int fd)
	Create a media for an already open file descriptor. More...

LIBVLC_API libvlc_media_t *	libvlc_media_new_callbacks (libvlc_instance_t instance, libvlc_media_open_cb open_cb, libvlc_media_read_cb read_cb, libvlc_media_seek_cb seek_cb, libvlc_media_close_cb close_cb, void opaque)
	Create a media with custom callbacks to read the data from. More...

LIBVLC_API libvlc_media_t *	libvlc_media_new_as_node (libvlc_instance_t p_instance, const char psz_name)
	Create a media as an empty node with a given name. More...

LIBVLC_API void	libvlc_media_add_option (libvlc_media_t p_md, const char psz_options)
	Add an option to the media. More...

LIBVLC_API void	libvlc_media_add_option_flag (libvlc_media_t p_md, const char psz_options, unsigned i_flags)
	Add an option to the media with configurable flags. More...

LIBVLC_API void	libvlc_media_retain (libvlc_media_t *p_md)
	Retain a reference to a media descriptor object (libvlc_media_t). More...

LIBVLC_API void	libvlc_media_release (libvlc_media_t *p_md)
	Decrement the reference count of a media descriptor object. More...

LIBVLC_API char *	libvlc_media_get_mrl (libvlc_media_t *p_md)
	Get the media resource locator (mrl) from a media descriptor object. More...

LIBVLC_API libvlc_media_t *	libvlc_media_duplicate (libvlc_media_t *p_md)
	Duplicate a media descriptor object. More...

LIBVLC_API char *	libvlc_media_get_meta (libvlc_media_t *p_md, libvlc_meta_t e_meta)
	Read the meta of the media. More...

LIBVLC_API void	libvlc_media_set_meta (libvlc_media_t p_md, libvlc_meta_t e_meta, const char psz_value)
	Set the meta of the media (this function will not save the meta, call libvlc_media_save_meta in order to save the meta) More...

LIBVLC_API int	libvlc_media_save_meta (libvlc_media_t *p_md)
	Save the meta previously set. More...

LIBVLC_API libvlc_state_t	libvlc_media_get_state (libvlc_media_t *p_md)
	Get current state of media descriptor object. More...

LIBVLC_API int	libvlc_media_get_stats (libvlc_media_t p_md, libvlc_media_stats_t p_stats)
	Get the current statistics about the media. More...

LIBVLC_API struct libvlc_media_list_t *	libvlc_media_subitems (libvlc_media_t *p_md)
	Get subitems of media descriptor object. More...

LIBVLC_API libvlc_event_manager_t *	libvlc_media_event_manager (libvlc_media_t *p_md)
	Get event manager from media descriptor object. More...

LIBVLC_API libvlc_time_t	libvlc_media_get_duration (libvlc_media_t *p_md)
	Get duration (in ms) of media descriptor object item. More...

LIBVLC_API int	libvlc_media_parse_with_options (libvlc_media_t *p_md, libvlc_media_parse_flag_t parse_flag, int timeout)
	Parse the media asynchronously with options. More...

LIBVLC_API void	libvlc_media_parse_stop (libvlc_media_t *p_md)
	Stop the parsing of the media. More...

LIBVLC_API libvlc_media_parsed_status_t	libvlc_media_get_parsed_status (libvlc_media_t *p_md)
	Get Parsed status for media descriptor object. More...

LIBVLC_API void	libvlc_media_set_user_data (libvlc_media_t p_md, void p_new_user_data)
	Sets media descriptor's user_data. More...

LIBVLC_API void *	libvlc_media_get_user_data (libvlc_media_t *p_md)
	Get media descriptor's user_data. More...

LIBVLC_API unsigned	libvlc_media_tracks_get (libvlc_media_t p_md, libvlc_media_track_t **tracks)
	Get media descriptor's elementary streams description. More...

const LIBVLC_API char *	libvlc_media_get_codec_description (libvlc_track_type_t i_type, uint32_t i_codec)
	Get codec description from media elementary stream. More...

LIBVLC_API void	libvlc_media_tracks_release (libvlc_media_track_t **p_tracks, unsigned i_count)
	Release media descriptor's elementary streams description array. More...

LIBVLC_API libvlc_media_type_t	libvlc_media_get_type (libvlc_media_t *p_md)
	Get the media type of the media descriptor object. More...

LIBVLC_API int	libvlc_media_slaves_add (libvlc_media_t p_md, libvlc_media_slave_type_t i_type, unsigned int i_priority, const char psz_uri)
	Add a slave to the current media. More...

LIBVLC_API void	libvlc_media_slaves_clear (libvlc_media_t *p_md)
	Clear all slaves previously added by libvlc_media_slaves_add() or internally. More...

LIBVLC_API unsigned int	libvlc_media_slaves_get (libvlc_media_t p_md, libvlc_media_slave_t **ppp_slaves)
	Get a media descriptor's slave list. More...

LIBVLC_API void	libvlc_media_slaves_release (libvlc_media_slave_t **pp_slaves, unsigned int i_count)
	Release a media descriptor's slave list. More...

LIBVLC_DEPRECATED LIBVLC_API void	libvlc_media_parse (libvlc_media_t *p_md)
	Parse a media. More...

LIBVLC_DEPRECATED LIBVLC_API void	libvlc_media_parse_async (libvlc_media_t *p_md)
	Parse a media. More...

LIBVLC_DEPRECATED LIBVLC_API int	libvlc_media_is_parsed (libvlc_media_t *p_md)
	Return true is the media descriptor object is parsed. More...

LIBVLC_DEPRECATED LIBVLC_API int	libvlc_media_get_tracks_info (libvlc_media_t p_md, libvlc_media_track_info_t *tracks)
	Get media descriptor's elementary streams description. More...

Detailed Description

libvlc_media_t is an abstract representation of a playable media. It consists of a media location and various optional meta data.

Macro Definition Documentation

◆ VLC_FORWARD_DECLARE_OBJECT

#define VLC_FORWARD_DECLARE_OBJECT ( a ) struct a

Typedef Documentation

◆ libvlc_audio_track_t

typedef struct libvlc_audio_track_t libvlc_audio_track_t

◆ libvlc_media_close_cb

typedef void(* libvlc_media_close_cb) (void *opaque)

Callback prototype to close a custom bitstream input media.

Parameters

opaque private pointer as set by the libvlc_media_open_cb callback

◆ libvlc_media_open_cb

typedef int(* libvlc_media_open_cb) (void *opaque, void **datap, uint64_t *sizep)

Callback prototype to open a custom bitstream input media.

The same media item can be opened multiple times. Each time, this callback is invoked. It should allocate and initialize any instance-specific resources, then store them in *datap. The instance resources can be freed in the libvlc_media_close_cb callback.

Parameters

opaque	private pointer as passed to libvlc_media_new_callbacks()
datap	storage space for a private data pointer [OUT]
sizep	byte length of the bitstream or UINT64_MAX if unknown [OUT]

Note: For convenience, *datap is initially NULL and *sizep is initially 0.

Returns: 0 on success, non-zero on error. In case of failure, the other callbacks will not be invoked and any value stored in *datap and *sizep is discarded.

◆ libvlc_media_parse_flag_t

typedef enum libvlc_media_parse_flag_t libvlc_media_parse_flag_t

Parse flags used by libvlc_media_parse_with_options()

See also: libvlc_media_parse_with_options

◆ libvlc_media_parsed_status_t

typedef enum libvlc_media_parsed_status_t libvlc_media_parsed_status_t

Parse status used sent by libvlc_media_parse_with_options() or returned by libvlc_media_get_parsed_status()

See also: libvlc_media_parse_with_options; libvlc_media_get_parsed_status

◆ libvlc_media_read_cb

typedef ssize_t(* libvlc_media_read_cb) (void *opaque, unsigned char *buf, size_t len)

Callback prototype to read data from a custom bitstream input media.

Parameters

opaque	private pointer as set by the libvlc_media_open_cb callback
buf	start address of the buffer to read data into
len	bytes length of the buffer

Returns: strictly positive number of bytes read, 0 on end-of-stream, or -1 on non-recoverable error

Note: If no data is immediately available, then the callback should sleep.

Warning: The application is responsible for avoiding deadlock situations. In particular, the callback should return an error if playback is stopped; if it does not return, then libvlc_media_player_stop() will never return.

◆ libvlc_media_seek_cb

typedef int(* libvlc_media_seek_cb) (void *opaque, uint64_t offset)

Callback prototype to seek a custom bitstream input media.

Parameters

opaque	private pointer as set by the libvlc_media_open_cb callback
offset	absolute byte offset to seek to

Returns: 0 on success, -1 on error.

◆ libvlc_media_slave_t

typedef struct libvlc_media_slave_t libvlc_media_slave_t

A slave of a libvlc_media_t.

See also: libvlc_media_slaves_get

◆ libvlc_media_slave_type_t

typedef enum libvlc_media_slave_type_t libvlc_media_slave_type_t

Type of a media slave: subtitle or audio.

◆ libvlc_media_stats_t

typedef struct libvlc_media_stats_t libvlc_media_stats_t

◆ libvlc_media_t

typedef struct libvlc_media_t libvlc_media_t

◆ libvlc_media_track_info_t

typedef struct libvlc_media_track_info_t libvlc_media_track_info_t

◆ libvlc_media_track_t

typedef struct libvlc_media_track_t libvlc_media_track_t

◆ libvlc_media_type_t

typedef enum libvlc_media_type_t libvlc_media_type_t

Media type.

See also: libvlc_media_get_type

◆ libvlc_meta_t

typedef enum libvlc_meta_t libvlc_meta_t

Meta data types.

◆ libvlc_state_t

typedef enum libvlc_state_t libvlc_state_t

Note the order of libvlc_state_t enum must match exactly the order of.

See also: mediacontrol_PlayerStatus,; input_state_e enums, and VideoLAN.LibVLC.State (at bindings/cil/src/media.cs).

Expected states by web plugins are: IDLE/CLOSE=0, OPENING=1, PLAYING=3, PAUSED=4, STOPPING=5, ENDED=6, ERROR=7

◆ libvlc_subtitle_track_t

typedef struct libvlc_subtitle_track_t libvlc_subtitle_track_t

◆ libvlc_track_type_t

typedef enum libvlc_track_type_t libvlc_track_type_t

◆ libvlc_video_orient_t

typedef enum libvlc_video_orient_t libvlc_video_orient_t

◆ libvlc_video_projection_t

typedef enum libvlc_video_projection_t libvlc_video_projection_t

◆ libvlc_video_track_t

typedef struct libvlc_video_track_t libvlc_video_track_t

◆ libvlc_video_viewpoint_t

typedef struct libvlc_video_viewpoint_t libvlc_video_viewpoint_t

Viewpoint.

Warning: allocate using libvlc_video_new_viewpoint()

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
libvlc_media_option_trusted
libvlc_media_option_unique

◆ libvlc_media_parse_flag_t

enum libvlc_media_parse_flag_t

Parse flags used by libvlc_media_parse_with_options()

See also: libvlc_media_parse_with_options

Enumerator
libvlc_media_parse_local	Parse media if it's a local file.
libvlc_media_parse_network	Parse media even if it's a network file.
libvlc_media_fetch_local	Fetch meta and covert art using local resources.
libvlc_media_fetch_network	Fetch meta and covert art using network resources.
libvlc_media_do_interact	Interact with the user (via libvlc_dialog_cbs) when preparsing this item (and not its sub items). Set this flag in order to receive a callback when the input is asking for credentials.

◆ libvlc_media_parsed_status_t

enum libvlc_media_parsed_status_t

Parse status used sent by libvlc_media_parse_with_options() or returned by libvlc_media_get_parsed_status()

See also: libvlc_media_parse_with_options; libvlc_media_get_parsed_status

Enumerator
libvlc_media_parsed_status_skipped
libvlc_media_parsed_status_failed
libvlc_media_parsed_status_timeout
libvlc_media_parsed_status_done

◆ libvlc_media_slave_type_t

enum libvlc_media_slave_type_t

Type of a media slave: subtitle or audio.

Enumerator
libvlc_media_slave_type_subtitle
libvlc_media_slave_type_audio

◆ libvlc_media_type_t

enum libvlc_media_type_t

Media type.

See also: libvlc_media_get_type

Enumerator
libvlc_media_type_unknown
libvlc_media_type_file
libvlc_media_type_directory
libvlc_media_type_disc
libvlc_media_type_stream
libvlc_media_type_playlist

◆ libvlc_meta_t

enum libvlc_meta_t

Meta data types.

Enumerator
libvlc_meta_Title
libvlc_meta_Artist
libvlc_meta_Genre
libvlc_meta_Copyright
libvlc_meta_Album
libvlc_meta_TrackNumber
libvlc_meta_Description
libvlc_meta_Rating
libvlc_meta_Date
libvlc_meta_Setting
libvlc_meta_URL
libvlc_meta_Language
libvlc_meta_NowPlaying
libvlc_meta_Publisher
libvlc_meta_EncodedBy
libvlc_meta_ArtworkURL
libvlc_meta_TrackID
libvlc_meta_TrackTotal
libvlc_meta_Director
libvlc_meta_Season
libvlc_meta_Episode
libvlc_meta_ShowName
libvlc_meta_Actors
libvlc_meta_AlbumArtist
libvlc_meta_DiscNumber
libvlc_meta_DiscTotal

◆ libvlc_state_t

enum libvlc_state_t

Note the order of libvlc_state_t enum must match exactly the order of.

See also: mediacontrol_PlayerStatus,; input_state_e enums, and VideoLAN.LibVLC.State (at bindings/cil/src/media.cs).

Expected states by web plugins are: IDLE/CLOSE=0, OPENING=1, PLAYING=3, PAUSED=4, STOPPING=5, ENDED=6, ERROR=7

Enumerator
libvlc_NothingSpecial
libvlc_Opening
libvlc_Buffering
libvlc_Playing
libvlc_Paused
libvlc_Stopped
libvlc_Ended
libvlc_Error

◆ libvlc_track_type_t

enum libvlc_track_type_t

Enumerator
libvlc_track_unknown
libvlc_track_audio
libvlc_track_video
libvlc_track_text

◆ libvlc_video_orient_t

enum libvlc_video_orient_t

Enumerator
libvlc_video_orient_top_left	Normal. Top line represents top, left column left.
libvlc_video_orient_top_right	Flipped horizontally.
libvlc_video_orient_bottom_left	Flipped vertically.
libvlc_video_orient_bottom_right	Rotated 180 degrees.
libvlc_video_orient_left_top	Transposed.
libvlc_video_orient_left_bottom	Rotated 90 degrees clockwise (or 270 anti-clockwise)
libvlc_video_orient_right_top	Rotated 90 degrees anti-clockwise.
libvlc_video_orient_right_bottom	Anti-transposed.

◆ libvlc_video_projection_t

enum libvlc_video_projection_t

Enumerator
libvlc_video_projection_rectangular
libvlc_video_projection_equirectangular	360 spherical
libvlc_video_projection_cubemap_layout_standard

Function Documentation

◆ libvlc_media_add_option()

LIBVLC_API void libvlc_media_add_option	(	libvlc_media_t *	p_md,
		const char *	psz_options
	)

Add an option to the media.

This option will be used to determine how the media_player will read the media. This allows to use VLC's advanced reading/streaming options on a per-media basis.

Note: The options are listed in 'vlc –long-help' from the command line, e.g. "-sout-all". Keep in mind that available options and their semantics vary across LibVLC versions and builds.

Warning: Not all options affects libvlc_media_t objects: Specifically, due to architectural issues most audio and video options, such as text renderer options, have no effects on an individual media. These options must be set through libvlc_new() instead.

Parameters

p_md	the media descriptor
psz_options	the options (as a string)

◆ libvlc_media_add_option_flag()

LIBVLC_API void libvlc_media_add_option_flag	(	libvlc_media_t *	p_md,
		const char *	psz_options,
		unsigned	i_flags
	)

Add an option to the media with configurable flags.

This option will be used to determine how the media_player will read the media. This allows to use VLC's advanced reading/streaming options on a per-media basis.

The options are detailed in vlc –long-help, for instance "--sout-all". Note that all options are not usable on medias: specifically, due to architectural issues, video-related options such as text renderer options cannot be set on a single media. They must be set on the whole libvlc instance instead.

Parameters

p_md	the media descriptor
psz_options	the options (as a string)
i_flags	the flags for this option

◆ libvlc_media_duplicate()

LIBVLC_API libvlc_media_t* libvlc_media_duplicate ( libvlc_media_t * p_md )

Duplicate a media descriptor object.

Parameters

p_md	a media descriptor object.

◆ libvlc_media_event_manager()

LIBVLC_API libvlc_event_manager_t* libvlc_media_event_manager ( libvlc_media_t * p_md )

Get event manager from media descriptor object.

NOTE: this function doesn't increment reference counting.

Parameters

p_md	a media descriptor object

Returns: event manager object

◆ libvlc_media_get_codec_description()

const LIBVLC_API char* libvlc_media_get_codec_description	(	libvlc_track_type_t	i_type,
		uint32_t	i_codec
	)

Get codec description from media elementary stream.

Version: LibVLC 3.0.0 and later.

See also: libvlc_media_track_t

Parameters

i_type	i_type from libvlc_media_track_t
i_codec	i_codec or i_original_fourcc from libvlc_media_track_t

Returns: codec description

◆ libvlc_media_get_duration()

LIBVLC_API libvlc_time_t libvlc_media_get_duration ( libvlc_media_t * p_md )

Get duration (in ms) of media descriptor object item.

Parameters

p_md	media descriptor object

Returns: duration of media item or -1 on error

◆ libvlc_media_get_meta()

LIBVLC_API char* libvlc_media_get_meta	(	libvlc_media_t *	p_md,
		libvlc_meta_t	e_meta
	)

Read the meta of the media.

If the media has not yet been parsed this will return NULL.

See also: libvlc_media_parse; libvlc_media_parse_with_options; libvlc_MediaMetaChanged

Parameters

p_md	the media descriptor
e_meta	the meta to read

Returns: the media's meta

◆ libvlc_media_get_mrl()

LIBVLC_API char* libvlc_media_get_mrl ( libvlc_media_t * p_md )

Get the media resource locator (mrl) from a media descriptor object.

Parameters

p_md	a media descriptor object

Returns: string with mrl of media descriptor object

◆ libvlc_media_get_parsed_status()

LIBVLC_API libvlc_media_parsed_status_t libvlc_media_get_parsed_status ( libvlc_media_t * p_md )

Get Parsed status for media descriptor object.

See also: libvlc_MediaParsedChanged; libvlc_media_parsed_status_t

Parameters

p_md	media descriptor object

Returns: a value of the libvlc_media_parsed_status_t enum

Version: LibVLC 3.0.0 or later

◆ libvlc_media_get_state()

LIBVLC_API libvlc_state_t libvlc_media_get_state ( libvlc_media_t * p_md )

Get current state of media descriptor object.

Possible media states are libvlc_NothingSpecial=0, libvlc_Opening, libvlc_Playing, libvlc_Paused, libvlc_Stopped, libvlc_Ended, libvlc_Error.

See also: libvlc_state_t

Parameters

p_md	a media descriptor object

Returns: state of media descriptor object

◆ libvlc_media_get_stats()

LIBVLC_API int libvlc_media_get_stats	(	libvlc_media_t *	p_md,
		libvlc_media_stats_t *	p_stats
	)

Get the current statistics about the media.

Parameters

p_md	media descriptor object
p_stats	structure that contain the statistics about the media (this structure must be allocated by the caller)

Returns: true if the statistics are available, false otherwise

◆ libvlc_media_get_tracks_info()

LIBVLC_DEPRECATED LIBVLC_API int libvlc_media_get_tracks_info	(	libvlc_media_t *	p_md,
		libvlc_media_track_info_t **	tracks
	)

Get media descriptor's elementary streams description.

Note, you need to call libvlc_media_parse() or play the media at least once before calling this function. Not doing this will result in an empty array.

Deprecated:: Use libvlc_media_tracks_get() instead

Parameters

p_md	media descriptor object
tracks	address to store an allocated array of Elementary Streams descriptions (must be freed by the caller) [OUT]

Returns: the number of Elementary Streams

◆ libvlc_media_get_type()

LIBVLC_API libvlc_media_type_t libvlc_media_get_type ( libvlc_media_t * p_md )

Get the media type of the media descriptor object.

Version: LibVLC 3.0.0 and later.

See also: libvlc_media_type_t

Parameters

p_md	media descriptor object

Returns: media type

◆ libvlc_media_get_user_data()

LIBVLC_API void* libvlc_media_get_user_data ( libvlc_media_t * p_md )

Get media descriptor's user_data.

user_data is specialized data accessed by the host application, VLC.framework uses it as a pointer to an native object that references a libvlc_media_t pointer

Parameters

p_md	media descriptor object

◆ libvlc_media_is_parsed()

LIBVLC_DEPRECATED LIBVLC_API int libvlc_media_is_parsed ( libvlc_media_t * p_md )

Return true is the media descriptor object is parsed.

Deprecated:: This can return true in case of failure. Use libvlc_media_get_parsed_status() instead

See also: libvlc_MediaParsedChanged

Parameters

p_md	media descriptor object

Returns: true if media object has been parsed otherwise it returns false

◆ libvlc_media_new_as_node()

LIBVLC_API libvlc_media_t* libvlc_media_new_as_node	(	libvlc_instance_t *	p_instance,
		const char *	psz_name
	)

Create a media as an empty node with a given name.

See also: libvlc_media_release

Parameters

p_instance	the instance
psz_name	the name of the node

Returns: the new empty media or NULL on error

◆ libvlc_media_new_callbacks()

LIBVLC_API libvlc_media_t* libvlc_media_new_callbacks	(	libvlc_instance_t *	instance,
		libvlc_media_open_cb	open_cb,
		libvlc_media_read_cb	read_cb,
		libvlc_media_seek_cb	seek_cb,
		libvlc_media_close_cb	close_cb,
		void *	opaque
	)

Create a media with custom callbacks to read the data from.

Parameters

instance	LibVLC instance
open_cb	callback to open the custom bitstream input media
read_cb	callback to read data (must not be NULL)
seek_cb	callback to seek, or NULL if seeking is not supported
close_cb	callback to close the media, or NULL if unnecessary
opaque	data pointer for the open callback

Returns: the newly created media or NULL on error

Note: If open_cb is NULL, the opaque pointer will be passed to read_cb, seek_cb and close_cb, and the stream size will be treated as unknown.; The callbacks may be called asynchronously (from another thread). A single stream instance need not be reentrant. However the open_cb needs to be reentrant if the media is used by multiple player instances.

Warning: The callbacks may be used until all or any player instances that were supplied the media item are stopped.

See also: libvlc_media_release

Version: LibVLC 3.0.0 and later.

◆ libvlc_media_new_fd()

LIBVLC_API libvlc_media_t* libvlc_media_new_fd	(	libvlc_instance_t *	p_instance,
		int	fd
	)

Create a media for an already open file descriptor.

The file descriptor shall be open for reading (or reading and writing).

Regular file descriptors, pipe read descriptors and character device descriptors (including TTYs) are supported on all platforms. Block device descriptors are supported where available. Directory descriptors are supported on systems that provide fdopendir(). Sockets are supported on all platforms where they are file descriptors, i.e. all except Windows.

Note: This library will not automatically close the file descriptor under any circumstance. Nevertheless, a file descriptor can usually only be rendered once in a media player. To render it a second time, the file descriptor should probably be rewound to the beginning with lseek().

See also: libvlc_media_release

Version: LibVLC 1.1.5 and later.

Parameters

p_instance	the instance
fd	open file descriptor

Returns: the newly created media or NULL on error

◆ libvlc_media_new_location()

LIBVLC_API libvlc_media_t* libvlc_media_new_location	(	libvlc_instance_t *	p_instance,
		const char *	psz_mrl
	)

Create a media with a certain given media resource location, for instance a valid URL.

Note: To refer to a local file with this function, the file://... URI syntax must be used (see IETF RFC3986). We recommend using libvlc_media_new_path() instead when dealing with local files.

See also: libvlc_media_release

Parameters

p_instance	the instance
psz_mrl	the media location

Returns: the newly created media or NULL on error

◆ libvlc_media_new_path()

LIBVLC_API libvlc_media_t* libvlc_media_new_path	(	libvlc_instance_t *	p_instance,
		const char *	path
	)

Create a media for a certain file path.

See also: libvlc_media_release

Parameters

p_instance	the instance
path	local filesystem path

Returns: the newly created media or NULL on error

◆ libvlc_media_parse()

LIBVLC_DEPRECATED LIBVLC_API void libvlc_media_parse ( libvlc_media_t * p_md )

Parse a media.

This fetches (local) art, meta data and tracks information. The method is synchronous.

Deprecated:: This function could block indefinitely. Use libvlc_media_parse_with_options() instead

See also: libvlc_media_parse_with_options; libvlc_media_get_meta; libvlc_media_get_tracks_info

Parameters

p_md	media descriptor object

◆ libvlc_media_parse_async()

LIBVLC_DEPRECATED LIBVLC_API void libvlc_media_parse_async ( libvlc_media_t * p_md )

Parse a media.

This fetches (local) art, meta data and tracks information. The method is the asynchronous of libvlc_media_parse().

To track when this is over you can listen to libvlc_MediaParsedChanged event. However if the media was already parsed you will not receive this event.

Deprecated:: You can't be sure to receive the libvlc_MediaParsedChanged event (you can wait indefinitely for this event). Use libvlc_media_parse_with_options() instead

See also: libvlc_media_parse; libvlc_MediaParsedChanged; libvlc_media_get_meta; libvlc_media_get_tracks_info

Parameters

p_md	media descriptor object

◆ libvlc_media_parse_stop()

LIBVLC_API void libvlc_media_parse_stop ( libvlc_media_t * p_md )

Stop the parsing of the media.

When the media parsing is stopped, the libvlc_MediaParsedChanged event will be sent with the libvlc_media_parsed_status_timeout status.

See also: libvlc_media_parse_with_options

Parameters

p_md	media descriptor object

Version: LibVLC 3.0.0 or later

◆ libvlc_media_parse_with_options()

LIBVLC_API int libvlc_media_parse_with_options	(	libvlc_media_t *	p_md,
		libvlc_media_parse_flag_t	parse_flag,
		int	timeout
	)

Parse the media asynchronously with options.

This fetches (local or network) art, meta data and/or tracks information. This method is the extended version of libvlc_media_parse_with_options().

To track when this is over you can listen to libvlc_MediaParsedChanged event. However if this functions returns an error, you will not receive any events.

It uses a flag to specify parse options (see libvlc_media_parse_flag_t). All these flags can be combined. By default, media is parsed if it's a local file.

Note: Parsing can be aborted with libvlc_media_parse_stop().

See also: libvlc_MediaParsedChanged; libvlc_media_get_meta; libvlc_media_tracks_get; libvlc_media_get_parsed_status; libvlc_media_parse_flag_t

Parameters

p_md	media descriptor object
parse_flag	parse options:
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: -1 in case of error, 0 otherwise

Version: LibVLC 3.0.0 or later

◆ libvlc_media_release()

LIBVLC_API void libvlc_media_release ( libvlc_media_t * p_md )

Decrement the reference count of a media descriptor object.

If the reference count is 0, then libvlc_media_release() will release the media descriptor object. It will send out an libvlc_MediaFreed event to all listeners. If the media descriptor object has been released it should not be used again.

Parameters

p_md	the media descriptor

◆ libvlc_media_retain()

LIBVLC_API void libvlc_media_retain ( libvlc_media_t * p_md )

Retain a reference to a media descriptor object (libvlc_media_t).

Use libvlc_media_release() to decrement the reference count of a media descriptor object.

Parameters

p_md	the media descriptor

◆ libvlc_media_save_meta()

LIBVLC_API int libvlc_media_save_meta ( libvlc_media_t * p_md )

Save the meta previously set.

Parameters

p_md	the media desriptor

Returns: true if the write operation was successful

◆ libvlc_media_set_meta()

LIBVLC_API void libvlc_media_set_meta	(	libvlc_media_t *	p_md,
		libvlc_meta_t	e_meta,
		const char *	psz_value
	)

Set the meta of the media (this function will not save the meta, call libvlc_media_save_meta in order to save the meta)

Parameters

p_md	the media descriptor
e_meta	the meta to write
psz_value	the media's meta

◆ libvlc_media_set_user_data()

LIBVLC_API void libvlc_media_set_user_data	(	libvlc_media_t *	p_md,
		void *	p_new_user_data
	)

Sets media descriptor's user_data.

user_data is specialized data accessed by the host application, VLC.framework uses it as a pointer to an native object that references a libvlc_media_t pointer

Parameters

p_md	media descriptor object
p_new_user_data	pointer to user data

◆ libvlc_media_slaves_add()

LIBVLC_API int libvlc_media_slaves_add	(	libvlc_media_t *	p_md,
		libvlc_media_slave_type_t	i_type,
		unsigned int	i_priority,
		const char *	psz_uri
	)

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).

Note: This function must be called before the media is parsed (via libvlc_media_parse_with_options()) or before the media is played (via libvlc_media_player_play())

Version: LibVLC 3.0.0 and later.

Parameters

p_md	media descriptor object
i_type	subtitle or audio
i_priority	from 0 (low priority) to 4 (high priority)
psz_uri	Uri of the slave (should contain a valid scheme).

Returns: 0 on success, -1 on error.

◆ libvlc_media_slaves_clear()

LIBVLC_API void libvlc_media_slaves_clear ( libvlc_media_t * p_md )

Clear all slaves previously added by libvlc_media_slaves_add() or internally.

Version: LibVLC 3.0.0 and later.

Parameters

p_md	media descriptor object

◆ libvlc_media_slaves_get()

LIBVLC_API unsigned int libvlc_media_slaves_get	(	libvlc_media_t *	p_md,
		libvlc_media_slave_t ***	ppp_slaves
	)

Get a media descriptor's slave list.

The list will contain slaves parsed by VLC or previously added by libvlc_media_slaves_add(). The typical use case of this function is to save a list of slave in a database for a later use.

Version: LibVLC 3.0.0 and later.

See also: libvlc_media_slaves_add

Parameters

p_md	media descriptor object
ppp_slaves	address to store an allocated array of slaves (must be freed with libvlc_media_slaves_release()) [OUT]

Returns: the number of slaves (zero on error)

◆ libvlc_media_slaves_release()

LIBVLC_API void libvlc_media_slaves_release	(	libvlc_media_slave_t **	pp_slaves,
		unsigned int	i_count
	)

Release a media descriptor's slave list.

Version: LibVLC 3.0.0 and later.

Parameters

pp_slaves	slave array to release
i_count	number of elements in the array

◆ libvlc_media_subitems()

LIBVLC_API struct libvlc_media_list_t* libvlc_media_subitems ( libvlc_media_t * p_md )

Get subitems of media descriptor object.

This will increment the reference count of supplied media descriptor object. Use libvlc_media_list_release() to decrement the reference counting.

Parameters

p_md	media descriptor object

Returns: list of media descriptor subitems or NULL

◆ libvlc_media_tracks_get()

LIBVLC_API unsigned libvlc_media_tracks_get	(	libvlc_media_t *	p_md,
		libvlc_media_track_t ***	tracks
	)

Get media descriptor's elementary streams description.

Note, you need to call libvlc_media_parse() or play the media at least once before calling this function. Not doing this will result in an empty array.

Version: LibVLC 2.1.0 and later.

Parameters

p_md	media descriptor object
tracks	address to store an allocated array of Elementary Streams descriptions (must be freed with libvlc_media_tracks_release by the caller) [OUT]

Returns: the number of Elementary Streams (zero on error)

◆ libvlc_media_tracks_release()

LIBVLC_API void libvlc_media_tracks_release	(	libvlc_media_track_t **	p_tracks,
		unsigned	i_count
	)

Release media descriptor's elementary streams description array.

Version: LibVLC 2.1.0 and later.

Parameters

p_tracks	tracks info array to release
i_count	number of elements in the array

Files

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ VLC_FORWARD_DECLARE_OBJECT

Typedef Documentation

◆ libvlc_audio_track_t

◆ libvlc_media_close_cb

◆ libvlc_media_open_cb

◆ libvlc_media_parse_flag_t

◆ libvlc_media_parsed_status_t

◆ libvlc_media_read_cb

◆ libvlc_media_seek_cb

◆ libvlc_media_slave_t

◆ libvlc_media_slave_type_t

◆ libvlc_media_stats_t

◆ libvlc_media_t

◆ libvlc_media_track_info_t

◆ libvlc_media_track_t

◆ libvlc_media_type_t

◆ libvlc_meta_t

◆ libvlc_state_t

◆ libvlc_subtitle_track_t

◆ libvlc_track_type_t

◆ libvlc_video_orient_t

◆ libvlc_video_projection_t

◆ libvlc_video_track_t

◆ libvlc_video_viewpoint_t

Enumeration Type Documentation

◆ anonymous enum

◆ libvlc_media_parse_flag_t

◆ libvlc_media_parsed_status_t

◆ libvlc_media_slave_type_t

◆ libvlc_media_type_t

◆ libvlc_meta_t

◆ libvlc_state_t

◆ libvlc_track_type_t

◆ libvlc_video_orient_t

◆ libvlc_video_projection_t

Function Documentation

◆ libvlc_media_add_option()

◆ libvlc_media_add_option_flag()

◆ libvlc_media_duplicate()

◆ libvlc_media_event_manager()

◆ libvlc_media_get_codec_description()

◆ libvlc_media_get_duration()

◆ libvlc_media_get_meta()

◆ libvlc_media_get_mrl()

◆ libvlc_media_get_parsed_status()

◆ libvlc_media_get_state()

◆ libvlc_media_get_stats()

◆ libvlc_media_get_tracks_info()

◆ libvlc_media_get_type()

◆ libvlc_media_get_user_data()

◆ libvlc_media_is_parsed()

◆ libvlc_media_new_as_node()

◆ libvlc_media_new_callbacks()

◆ libvlc_media_new_fd()

◆ libvlc_media_new_location()

◆ libvlc_media_new_path()

◆ libvlc_media_parse()

◆ libvlc_media_parse_async()

◆ libvlc_media_parse_stop()

◆ libvlc_media_parse_with_options()

◆ libvlc_media_release()

◆ libvlc_media_retain()

◆ libvlc_media_save_meta()

◆ libvlc_media_set_meta()

◆ libvlc_media_set_user_data()

◆ libvlc_media_slaves_add()

◆ libvlc_media_slaves_clear()

◆ libvlc_media_slaves_get()

◆ libvlc_media_slaves_release()

◆ libvlc_media_subitems()

◆ libvlc_media_tracks_get()

◆ libvlc_media_tracks_release()