LibVLC Tutorial

2011-02-18T11:18:40Z

Svlasov: /* Linking against LibVLC */

== LibVLC Tutorial ==

=== Installing the SDK ===
This code is written for LibVLC version 1.1.0 or later. It '''cannot''' be compiled with older versions.

==== Windows ====
VLC binary installers for Windows do not include the LibVLC SDK. It would be a waste of bandwidth and space for most users.

You can find the SDK files, i.e. development headers and import libraries, from the plain ZIP packages in the <code>sdk</code> directory. Alternatively, you can build VLC from source.

See [[LibVLC_Tutorial_086c]] for some more instructions on getting the build working.

==== Linux ====
You should find the necessary files (libvlc.so, libvlc.pc, header files...) in a binary package called libvlc-dev (Debian, Ubuntu...), libvlc-devel (RPM distros) or similar. Make sure that the version is recent enough before going forward.

=== Linking against LibVLC ===

<pre>
cc example.c -lvlc -o example
</pre>

On Linux/BSD, you may prefer to use pkg-config:
<pre>
pkg-config --print-errors 'libvlc >= 1.1.0'
cc -c example.c -o example.o $(pkg-config --cflags libvlc)
cc example.o -o example $(pkg-config --libs libvlc)
</pre>

=== Sample LibVLC Code ===
This sample code will (try to) play back an URL.
There is also an [[LibVLC SampleCode SDL|example using SDL for video output]].
<pre>
#include <stdio.h>
#include <stdlib.h>
#include <vlc/vlc.h>

int main(int argc, char* argv[])
{
libvlc_instance_t * inst;
libvlc_media_player_t *mp;
libvlc_media_t *m;

/* Load the VLC engine */
inst = libvlc_new (0, NULL);

/* Create a new item */
m = libvlc_media_new_path (inst, "http://mycool.movie.com/test.mov");

/* Create a media player playing environement */
mp = libvlc_media_player_new_from_media (m);

/* No need to keep the media now */
libvlc_media_release (m);

#if 0
/* This is a non working code that show how to hooks into a window,
* if we have a window around */
libvlc_media_player_set_xdrawable (mp, xdrawable);
/* or on windows */
libvlc_media_player_set_hwnd (mp, hwnd);
/* or on mac os */
libvlc_media_player_set_nsobject (mp, view);
#endif

/* play the media_player */
libvlc_media_player_play (mp);

sleep (10); /* Let it play a bit */

/* Stop playing */
libvlc_media_player_stop (mp);

/* Free the media_player */
libvlc_media_player_release (mp);

libvlc_release (inst);

return 0;
}
</pre>

VideoLAN Wiki - User contributions [en]

LibVLC Tutorial