LibVLC media discovery

LibVLC media discovery finds available media via various means. More...

Collaboration diagram for LibVLC media discovery:

Files
file	libvlc_media_discoverer.h
	LibVLC media discovery external API.

Typedefs
typedef struct libvlc_media_discoverer_t	libvlc_media_discoverer_t

Functions
LIBVLC_API libvlc_media_discoverer_t *	libvlc_media_discoverer_new (libvlc_instance_t *p_inst, const char *psz_name)
	Create a media discoverer object by name.
LIBVLC_API int	libvlc_media_discoverer_start (libvlc_media_discoverer_t *p_mdis)
	Start media discovery.
LIBVLC_API void	libvlc_media_discoverer_stop (libvlc_media_discoverer_t *p_mdis)
	Stop media discovery.
LIBVLC_API void	libvlc_media_discoverer_release (libvlc_media_discoverer_t *p_mdis)
	Release media discover object.
LIBVLC_API libvlc_media_list_t *	libvlc_media_discoverer_media_list (libvlc_media_discoverer_t *p_mdis)
	Get media service discover media list.
LIBVLC_API bool	libvlc_media_discoverer_is_running (libvlc_media_discoverer_t *p_mdis)
	Query if media service discover object is running.
LIBVLC_API size_t	libvlc_media_discoverer_list_get (libvlc_instance_t *p_inst, libvlc_media_discoverer_category_t i_cat, libvlc_media_discoverer_description_t ***ppp_services)
	Get media discoverer services by category.
LIBVLC_API void	libvlc_media_discoverer_list_release (libvlc_media_discoverer_description_t **pp_services, size_t i_count)
	Release an array of media discoverer services.

Detailed Description

LibVLC media discovery finds available media via various means.

This corresponds to the service discovery functionality in VLC media player. Different plugins find potential medias locally (e.g. user media directory), from peripherals (e.g. video capture device), on the local network (e.g. SAP) or on the Internet (e.g. Internet radios).

Typedef Documentation

libvlc_media_discoverer_t

typedef struct libvlc_media_discoverer_t libvlc_media_discoverer_t

Function Documentation

libvlc_media_discoverer_is_running()

LIBVLC_API bool libvlc_media_discoverer_is_running

(

libvlc_media_discoverer_t *

p_mdis

)

Query if media service discover object is running.

Parameters

p_mdis

media service discover object

Return values

true	running
false	not running

References LIBVLC_API.

libvlc_media_discoverer_list_get()

LIBVLC_API size_t libvlc_media_discoverer_list_get	(	libvlc_instance_t *	p_inst,
		libvlc_media_discoverer_category_t	i_cat,
		libvlc_media_discoverer_description_t ***	ppp_services )

Get media discoverer services by category.

Version

LibVLC 3.0.0 and later.

Parameters

p_inst	libvlc instance
i_cat	category of services to fetch
ppp_services	address to store an allocated array of media discoverer services (must be freed with libvlc_media_discoverer_list_release() by the caller) [OUT]

Returns

the number of media discoverer services (0 on error)

References LIBVLC_API.

libvlc_media_discoverer_list_release()

LIBVLC_API void libvlc_media_discoverer_list_release	(	libvlc_media_discoverer_description_t **	pp_services,
		size_t	i_count )

Release an array of media discoverer services.

Version

LibVLC 3.0.0 and later.

See also

libvlc_media_discoverer_list_get()

Parameters

pp_services	array to release
i_count	number of elements in the array

libvlc_media_discoverer_media_list()

LIBVLC_API libvlc_media_list_t * libvlc_media_discoverer_media_list

(

libvlc_media_discoverer_t *

p_mdis

)

Get media service discover media list.

Parameters

p_mdis

media service discover object

Returns

list of media items

References LIBVLC_API.

libvlc_media_discoverer_new()

LIBVLC_API libvlc_media_discoverer_t * libvlc_media_discoverer_new	(	libvlc_instance_t *	p_inst,
		const char *	psz_name )

Create a media discoverer object by name.

After this object is created, you should attach to media_list events in order to be notified of new items discovered.

You need to call libvlc_media_discoverer_start() in order to start the discovery.

See also

libvlc_media_discoverer_media_list

libvlc_media_discoverer_start

Parameters

p_inst	libvlc instance
psz_name	service name; use libvlc_media_discoverer_list_get() to get a list of the discoverer names available in this libVLC instance

Returns

media discover object or NULL in case of error

Version

LibVLC 3.0.0 or later

References LIBVLC_API, and psz_name.

libvlc_media_discoverer_release()

LIBVLC_API void libvlc_media_discoverer_release

(

libvlc_media_discoverer_t *

p_mdis

)

Release media discover object.

If the reference count reaches 0, then the object will be released.

Parameters

p_mdis

media service discover object

References LIBVLC_API.

libvlc_media_discoverer_start()

LIBVLC_API int libvlc_media_discoverer_start

(

libvlc_media_discoverer_t *

p_mdis

)

Start media discovery.

To stop it, call libvlc_media_discoverer_stop() or libvlc_media_discoverer_list_release() directly.

See also

libvlc_media_discoverer_stop

Parameters

p_mdis

media discover object

Returns

-1 in case of error, 0 otherwise

Version

LibVLC 3.0.0 or later

References LIBVLC_API.

libvlc_media_discoverer_stop()

LIBVLC_API void libvlc_media_discoverer_stop

(

libvlc_media_discoverer_t *

p_mdis

)

Stop media discovery.

See also

libvlc_media_discoverer_start

Parameters

p_mdis

media discover object

Version

LibVLC 3.0.0 or later

References LIBVLC_API.