]> git.sesse.net Git - vlc/blobdiff - src/control/media_list_player.c
Use var_Inherit* instead of var_CreateGet*.
[vlc] / src / control / media_list_player.c
index 1d1167a686f22ceb7997b86e3b21e6e41ceaf51a..a6d509869119c9eb33c94a04ca67d8ece623fa5d 100644 (file)
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
-#include "libvlc_internal.h"
+
+#ifdef HAVE_CONFIG_H
+# include "config.h"
+#endif
+
 #include <vlc/libvlc.h>
+#include <vlc/libvlc_media.h>
+#include <vlc/libvlc_media_list.h>
+#include <vlc/libvlc_media_player.h>
+#include <vlc/libvlc_media_list_player.h>
+#include <vlc/libvlc_events.h>
+#include <assert.h>
+
+#include "libvlc_internal.h"
+
+#include "media_internal.h" // Abuse, could and should be removed
 #include "media_list_path.h"
 
+//#define DEBUG_MEDIA_LIST_PLAYER
+
+/* This is a very dummy implementation of playlist on top of
+ * media_list and media_player.
+ *
+ * All this code is doing is simply computing the next item
+ * of a tree of media_list (see get_next_index()), and play
+ * the next item when the current is over. This is happening
+ * via the event callback media_player_reached_end().
+ *
+ * This is thread safe, and we use a two keys (locks) scheme
+ * to discriminate between callbacks and regular uses.
+ */
+
+struct libvlc_media_list_player_t
+{
+    libvlc_event_manager_t *    p_event_manager;
+    libvlc_instance_t *         p_libvlc_instance;
+    int                         i_refcount;
+    /* Protect access to this structure. */
+    vlc_mutex_t                 object_lock;
+    /* Protect access to this structure and from callback execution. */
+    vlc_mutex_t                 mp_callback_lock;
+    /* Indicate to media player callbacks that they are cancelled. */
+    bool                        are_mp_callback_cancelled;
+    libvlc_media_list_path_t    current_playing_item_path;
+    libvlc_media_t *            p_current_playing_item;
+    libvlc_media_list_t *       p_mlist;
+    libvlc_media_player_t *     p_mi;
+    libvlc_playback_mode_t      e_playback_mode;
+};
+
+/* This is not yet exported by libvlccore */
+static inline void vlc_assert_locked(vlc_mutex_t *mutex)
+{
+    VLC_UNUSED(mutex);
+}
+
+/*
+ * Forward declaration
+ */
+
+static
+int set_relative_playlist_position_and_play(libvlc_media_list_player_t *p_mlp,
+                                            int i_relative_position);
+static void stop(libvlc_media_list_player_t * p_mlp);
+
 /*
  * Private functions
  */
 
 /**************************************************************************
- *       get_next_index (private)
+ * Shortcuts
+ **************************************************************************/
+static inline void lock(libvlc_media_list_player_t * p_mlp)
+{
+    // Obtain an access to this structure
+    vlc_mutex_lock(&p_mlp->object_lock);
+
+    // Make sure no callback will occurs at the same time
+    vlc_mutex_lock(&p_mlp->mp_callback_lock);
+}
+
+static inline void unlock(libvlc_media_list_player_t * p_mlp)
+{
+    vlc_mutex_unlock(&p_mlp->mp_callback_lock);
+    vlc_mutex_unlock(&p_mlp->object_lock);
+}
+
+static inline void assert_locked(libvlc_media_list_player_t * p_mlp)
+{
+    vlc_assert_locked(&p_mlp->mp_callback_lock);
+}
+
+static inline libvlc_event_manager_t * mlist_em(libvlc_media_list_player_t * p_mlp)
+{
+    assert_locked(p_mlp);
+    return libvlc_media_list_event_manager(p_mlp->p_mlist);
+}
+
+static inline libvlc_event_manager_t * mplayer_em(libvlc_media_list_player_t * p_mlp)
+{
+    assert_locked(p_mlp);
+    return libvlc_media_player_event_manager(p_mlp->p_mi);
+}
+
+/**************************************************************************
+ *       get_next_path (private)
  *
- * Simple next item fetcher.
+ *  Returns the path to the next item in the list.
+ *  If looping is specified and the current item is the last list item in
+ *  the list it will return the first item in the list.
  **************************************************************************/
 static libvlc_media_list_path_t
-get_next_path( libvlc_media_list_player_t * p_mlp )
+get_next_path(libvlc_media_list_player_t * p_mlp, bool b_loop)
 {
-    /* We are entered with libvlc_media_list_lock( p_mlp->p_list ) */
+    assert_locked(p_mlp);
+
+    /* We are entered with libvlc_media_list_lock(p_mlp->p_list) */
     libvlc_media_list_path_t ret;
     libvlc_media_list_t * p_parent_of_playing_item;
     libvlc_media_list_t * p_sublist_of_playing_item;
+
+    if (!p_mlp->current_playing_item_path)
+    {
+        if (!libvlc_media_list_count(p_mlp->p_mlist))
+            return NULL;
+        return libvlc_media_list_path_with_root_index(0);
+    }
+
     p_sublist_of_playing_item = libvlc_media_list_sublist_at_path(
                             p_mlp->p_mlist,
-                            p_mlp->current_playing_item_path );
+                            p_mlp->current_playing_item_path);
+
     /* If item just gained a sublist just play it */
-    if( p_sublist_of_playing_item )
+    if (p_sublist_of_playing_item)
     {
-        libvlc_media_list_release( p_sublist_of_playing_item );
-        return libvlc_media_list_path_copy_by_appending( p_mlp->current_playing_item_path, 0 );
+        libvlc_media_list_release(p_sublist_of_playing_item);
+        return libvlc_media_list_path_copy_by_appending(p_mlp->current_playing_item_path, 0);
     }
 
-    /* Try to catch next element */
-    p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(
-                            p_mlp->p_mlist,
-                            p_mlp->current_playing_item_path );
+    /* Try to catch parent element */
+    p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(p_mlp->p_mlist,
+                            p_mlp->current_playing_item_path);
 
-    int deepness = libvlc_media_list_path_deepness( p_mlp->current_playing_item_path );
-    if( deepness < 1 || !p_parent_of_playing_item )
+    int depth = libvlc_media_list_path_depth(p_mlp->current_playing_item_path);
+    if (depth < 1 || !p_parent_of_playing_item)
         return NULL;
 
-    ret = libvlc_media_list_path_copy( p_mlp->current_playing_item_path );
+    ret = libvlc_media_list_path_copy(p_mlp->current_playing_item_path);
+    ret[depth - 1]++; /* set to next element */
 
-    while( ret[deepness-1] >= libvlc_media_list_count( p_parent_of_playing_item, NULL ) )
+    /* If this goes beyond the end of the list */
+    while(ret[depth-1] >= libvlc_media_list_count(p_parent_of_playing_item))
     {
-        deepness--;
-        if( deepness <= 0 )
+        depth--;
+        if (depth <= 0)
         {
-            free( ret );
-            libvlc_media_list_release( p_parent_of_playing_item );
-            return NULL;
+            if(b_loop)
+            {
+                ret[0] = 0;
+                ret[1] = -1;
+                break;
+            }
+            else
+            {
+                free(ret);
+                libvlc_media_list_release(p_parent_of_playing_item);
+                return NULL;
+            }
         }
-        ret[deepness] = -1;
-        ret[deepness-1]++;
+        ret[depth] = -1;
+        ret[depth-1]++;
         p_parent_of_playing_item  = libvlc_media_list_parentlist_at_path(
                                         p_mlp->p_mlist,
-                                        ret );
+                                        ret);
     }
-    libvlc_media_list_release( p_parent_of_playing_item );
+
+    libvlc_media_list_release(p_parent_of_playing_item);
     return ret;
 }
 
 /**************************************************************************
- *       media_instance_reached_end (private) (Event Callback)
+ *       find_last_item (private)
+ *
+ *  Returns the path of the last descendant of a given item path.
+ *  Note: Due to the recursive nature of the function and the need to free
+ *        media list paths, paths passed in may be freed if they are replaced.
+          Recommended usage is to set return value to the same path that was
+          passed to the function (i.e. item = find_last_item(list, item); )
  **************************************************************************/
-static void
-media_instance_reached_end( const libvlc_event_t * p_event,
-                            void * p_user_data )
+static libvlc_media_list_path_t
+find_last_item( libvlc_media_list_t * p_mlist, libvlc_media_list_path_t current_item )
 {
-    libvlc_media_list_player_t * p_mlp = p_user_data;
-    libvlc_media_instance_t * p_mi = p_event->p_obj;
-    libvlc_media_descriptor_t *p_md, * p_current_md;
-
-    p_md = libvlc_media_instance_get_media_descriptor( p_mi, NULL );
-    /* XXX: need if p_mlp->p_current_playing_index is beyond */
-    p_current_md = libvlc_media_list_item_at_path(
-                        p_mlp->p_mlist,
-                        p_mlp->current_playing_item_path );
-    if( p_md != p_current_md )
+    libvlc_media_list_t * p_sublist = libvlc_media_list_sublist_at_path(p_mlist, current_item);
+    libvlc_media_list_path_t last_item_path = current_item;
+
+    if(p_sublist)
     {
-        msg_Warn( p_mlp->p_libvlc_instance->p_libvlc_int,
-                  "We are not sync-ed with the media instance" );
-        libvlc_media_descriptor_release( p_md );
-        libvlc_media_descriptor_release( p_current_md );
-        return;
+        int i_count = libvlc_media_list_count(p_sublist);
+        if(i_count > 0)
+        {
+            /* Add the last sublist item to the path. */
+            last_item_path = libvlc_media_list_path_copy_by_appending(current_item, i_count - 1);
+            free(current_item);
+            /* Check that sublist item for more descendants. */
+            last_item_path = find_last_item(p_mlist, last_item_path);
+        }
+
+        libvlc_media_list_release(p_sublist);
     }
-    libvlc_media_descriptor_release( p_md );
-    libvlc_media_descriptor_release( p_current_md );
-    libvlc_media_list_player_next( p_mlp, NULL );
+
+    return last_item_path;
 }
 
 /**************************************************************************
- *       playlist_item_deleted (private) (Event Callback)
+ *       get_previous_path (private)
+ *
+ *  Returns the path to the preceding item in the list.
+ *  If looping is specified and the current item is the first list item in
+ *  the list it will return the last descendant of the last item in the list.
  **************************************************************************/
-static void
-mlist_item_deleted( const libvlc_event_t * p_event, void * p_user_data )
+static libvlc_media_list_path_t
+get_previous_path(libvlc_media_list_player_t * p_mlp, bool b_loop)
 {
-    libvlc_media_descriptor_t * p_current_md;
-    libvlc_media_list_player_t * p_mlp = p_user_data;
-    libvlc_media_list_t * p_emitting_mlist = p_event->p_obj;
-    /* XXX: need if p_mlp->p_current_playing_index is beyond */
-    p_current_md = libvlc_media_list_item_at_path(
-                        p_mlp->p_mlist,
-                        p_mlp->current_playing_item_path );
-
-    if( p_event->u.media_list_item_deleted.item == p_current_md &&
-        p_emitting_mlist == p_mlp->p_mlist )
+    assert_locked(p_mlp);
+
+    /* We are entered with libvlc_media_list_lock(p_mlp->p_list) */
+    libvlc_media_list_path_t ret;
+    libvlc_media_list_t * p_parent_of_playing_item;
+
+    if (!p_mlp->current_playing_item_path)
+    {
+        if (!libvlc_media_list_count(p_mlp->p_mlist))
+            return NULL;
+        return libvlc_media_list_path_with_root_index(0);
+    }
+
+    /* Try to catch parent element */
+    p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(
+                                            p_mlp->p_mlist,
+                                            p_mlp->current_playing_item_path);
+
+    int depth = libvlc_media_list_path_depth(p_mlp->current_playing_item_path);
+    if (depth < 1 || !p_parent_of_playing_item)
+        return NULL;
+
+    /* Set the return path to the current path */
+    ret = libvlc_media_list_path_copy(p_mlp->current_playing_item_path);
+
+    /* Change the return path to the previous list entry */
+    ret[depth - 1]--; /* set to previous element */
+    ret[depth] = -1;
+
+    /* Is the return path is beyond the start of the current list? */
+    if(ret[depth - 1] < 0)
+    {
+        /* Move to parent of current item */
+        depth--;
+
+        /* Are we at the root level of the tree? */
+        if (depth <= 0)
+        {
+            // Is looping enabled?
+            if(b_loop)
+            {
+                int i_count = libvlc_media_list_count(p_parent_of_playing_item);
+
+                /* Set current play item to the last element in the list */
+                ret[0] = i_count - 1;
+                ret[1] = -1;
+
+                /* Set the return path to the last descendant item of the current item */
+                ret = find_last_item(p_mlp->p_mlist, ret);
+            }
+            else
+            {
+                /* No looping so return empty path. */
+                free(ret);
+                ret = NULL;
+            }
+        }
+        else
+        {
+            /* This is the case of moving backward from the beginning of the
+            *  subitem list to its parent item.
+            *  This ensures that current path is properly terminated to
+            *  use that parent.
+            */
+            ret[depth] = -1;
+        }
+    }
+    else
     {
-        /* We are playing this item, we choose to stop */
-        libvlc_media_list_player_stop( p_mlp, NULL );
+        ret = find_last_item(p_mlp->p_mlist, ret);
     }
+
+    libvlc_media_list_release(p_parent_of_playing_item);
+    return ret;
 }
 
 /**************************************************************************
- *       install_playlist_observer (private)
+ *       media_player_reached_end (private) (Event Callback)
  **************************************************************************/
 static void
-install_playlist_observer( libvlc_media_list_player_t * p_mlp )
+media_player_reached_end(const libvlc_event_t * p_event, void * p_user_data)
 {
-    libvlc_event_attach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
-            libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
+    VLC_UNUSED(p_event);
+    libvlc_media_list_player_t * p_mlp = p_user_data;
+
+    vlc_mutex_lock(&p_mlp->mp_callback_lock);
+    if (!p_mlp->are_mp_callback_cancelled)
+        set_relative_playlist_position_and_play(p_mlp, 1);
+    vlc_mutex_unlock(&p_mlp->mp_callback_lock);
 }
 
 /**************************************************************************
- *       uninstall_playlist_observer (private)
+ *       playlist_item_deleted (private) (Event Callback)
  **************************************************************************/
 static void
-uninstall_playlist_observer( libvlc_media_list_player_t * p_mlp )
+mlist_item_deleted(const libvlc_event_t * p_event, void * p_user_data)
 {
-    libvlc_event_detach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
-            libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
+    // Nothing to do. For now.
+    (void)p_event; (void)p_user_data;
 }
 
+
 /**************************************************************************
- *       install_media_instance_observer (private)
+ * install_playlist_observer (private)
  **************************************************************************/
 static void
-install_media_instance_observer( libvlc_media_list_player_t * p_mlp )
+install_playlist_observer(libvlc_media_list_player_t * p_mlp)
 {
-    libvlc_event_attach( libvlc_media_instance_event_manager( p_mlp->p_mi, NULL ),
-                         libvlc_MediaInstanceReachedEnd,
-                          media_instance_reached_end, p_mlp, NULL );
+    assert_locked(p_mlp);
+    libvlc_event_attach(mlist_em(p_mlp), libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp);
 }
 
+/**************************************************************************
+ * uninstall_playlist_observer (private)
+ **************************************************************************/
+static void
+uninstall_playlist_observer(libvlc_media_list_player_t * p_mlp)
+{
+    assert_locked(p_mlp);
+    if (!p_mlp->p_mlist) return;
+    libvlc_event_detach(mlist_em(p_mlp), libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp);
+}
 
 /**************************************************************************
- *       uninstall_media_instance_observer (private)
+ * install_media_player_observer (private)
  **************************************************************************/
 static void
-uninstall_media_instance_observer( libvlc_media_list_player_t * p_mlp )
+install_media_player_observer(libvlc_media_list_player_t * p_mlp)
 {
-    libvlc_event_detach( libvlc_media_instance_event_manager( p_mlp->p_mi, NULL ),
-                         libvlc_MediaInstanceReachedEnd,
-                         media_instance_reached_end, p_mlp, NULL );
+    assert_locked(p_mlp);
+    libvlc_event_attach_async(mplayer_em(p_mlp), libvlc_MediaPlayerEndReached, media_player_reached_end, p_mlp);
+}
+
+
+/**************************************************************************
+ *       uninstall_media_player_observer (private)
+ **************************************************************************/
+static void
+uninstall_media_player_observer(libvlc_media_list_player_t * p_mlp)
+{
+    assert_locked(p_mlp);
+    if (!p_mlp->p_mi) return;
+
+    // From now on, media_player callback won't be relevant.
+    p_mlp->are_mp_callback_cancelled = true;
+
+    // Allow callbacks to run, because detach() will wait until all callbacks are processed.
+    // This is safe because only callbacks are allowed, and there execution will be cancelled.
+    vlc_mutex_unlock(&p_mlp->mp_callback_lock);
+    libvlc_event_detach(mplayer_em(p_mlp), libvlc_MediaPlayerEndReached, media_player_reached_end, p_mlp);
+
+    // Now, lock back the callback lock. No more callback will be present from this point.
+    vlc_mutex_lock(&p_mlp->mp_callback_lock);
+    p_mlp->are_mp_callback_cancelled = false;
+
+    // What is here is safe, because we guarantee that we won't be able to anything concurrently,
+    // - except (cancelled) callbacks - thanks to the object_lock.
 }
 
 /**************************************************************************
@@ -181,45 +408,36 @@ uninstall_media_instance_observer( libvlc_media_list_player_t * p_mlp )
  * Playlist lock should be held
  **************************************************************************/
 static void
-set_current_playing_item( libvlc_media_list_player_t * p_mlp,
-                          libvlc_media_list_path_t path,
-                          libvlc_exception_t * p_e )
+set_current_playing_item(libvlc_media_list_player_t * p_mlp, libvlc_media_list_path_t path)
 {
-    VLC_UNUSED(p_e);
-
-    libvlc_media_descriptor_t * p_md;
-    
-    p_md = libvlc_media_list_item_at_path( p_mlp->p_mlist, path ); 
-    vlc_mutex_lock( &p_mlp->object_lock );
-    
-    free( p_mlp->current_playing_item_path );
-    p_mlp->current_playing_item_path = path;
+    assert_locked(p_mlp);
 
-    if( !p_md )
+    /* First, save the new path that we are going to play */
+    if (p_mlp->current_playing_item_path != path)
     {
-        vlc_mutex_unlock( &p_mlp->object_lock );
-        return;
+        free(p_mlp->current_playing_item_path);
+        p_mlp->current_playing_item_path = path;
     }
 
-    /* We are not interested in getting media_descriptor stop event now */
-    uninstall_media_instance_observer( p_mlp );
-    if( p_md->p_subitems && libvlc_media_list_count( p_md->p_subitems, NULL ) > 0 )
-    {
-        libvlc_media_descriptor_t * p_submd;
-        p_submd = libvlc_media_list_item_at_index( p_md->p_subitems, 0, NULL );
-        libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_submd, NULL );
-        libvlc_media_descriptor_release( p_submd );
-    }
-    else
-        libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_md, NULL );
-//    wait_playing_state(); /* If we want to be synchronous */
-    install_media_instance_observer( p_mlp );
+    if (!path)
+        return;
+
+    libvlc_media_t * p_md;
+    p_md = libvlc_media_list_item_at_path(p_mlp->p_mlist, path);
+    if (!p_md)
+        return;
+
+    /* Make sure media_player_reached_end() won't get called */
+    uninstall_media_player_observer(p_mlp);
+
+    /* Create a new media_player if there is none */
+    if (!p_mlp->p_mi)
+        p_mlp->p_mi = libvlc_media_player_new_from_media(p_md);
 
-    vlc_mutex_unlock( &p_mlp->object_lock );
+    libvlc_media_player_set_media(p_mlp->p_mi, p_md);
 
-    libvlc_media_list_unlock( p_mlp->p_mlist );        
-    
-    libvlc_media_descriptor_release( p_md ); /* for libvlc_media_list_item_at_index */
+    install_media_player_observer(p_mlp);
+    libvlc_media_release(p_md); /* for libvlc_media_list_item_at_index */
 }
 
 /*
@@ -230,21 +448,30 @@ set_current_playing_item( libvlc_media_list_player_t * p_mlp,
  *         new (Public)
  **************************************************************************/
 libvlc_media_list_player_t *
-libvlc_media_list_player_new( libvlc_instance_t * p_instance,
-                              libvlc_exception_t * p_e )
+libvlc_media_list_player_new(libvlc_instance_t * p_instance)
 {
-    (void)p_e;
     libvlc_media_list_player_t * p_mlp;
-    p_mlp = malloc(sizeof(libvlc_media_list_player_t));
-    p_mlp->current_playing_item_path = NULL;
-    p_mlp->p_mi = NULL;
-    p_mlp->p_mlist = NULL;
-    vlc_mutex_init( p_instance->p_libvlc_int, &p_mlp->object_lock );
-    p_mlp->p_event_manager = libvlc_event_manager_new( p_mlp,
-                                                       p_instance,
-                                                       p_e );
-    libvlc_event_manager_register_event_type( p_mlp->p_event_manager,
-            libvlc_MediaListPlayerNextItemSet, p_e );
+    p_mlp = calloc( 1, sizeof(libvlc_media_list_player_t) );
+    if (unlikely(p_mlp == NULL))
+    {
+        libvlc_printerr("Not enough memory");
+        return NULL;
+    }
+
+    p_mlp->p_event_manager = libvlc_event_manager_new(p_mlp, p_instance);
+    if (unlikely(p_mlp->p_event_manager == NULL))
+    {
+        free (p_mlp);
+        return NULL;
+    }
+
+    libvlc_retain(p_instance);
+    p_mlp->p_libvlc_instance = p_instance;
+    p_mlp->i_refcount = 1;
+    vlc_mutex_init(&p_mlp->object_lock);
+    vlc_mutex_init(&p_mlp->mp_callback_lock);
+    libvlc_event_manager_register_event_type(p_mlp->p_event_manager, libvlc_MediaListPlayerNextItemSet);
+    p_mlp->e_playback_mode = libvlc_playback_mode_default;
 
     return p_mlp;
 }
@@ -252,101 +479,139 @@ libvlc_media_list_player_new( libvlc_instance_t * p_instance,
 /**************************************************************************
  *         release (Public)
  **************************************************************************/
-void libvlc_media_list_player_release( libvlc_media_list_player_t * p_mlp )
+void libvlc_media_list_player_release(libvlc_media_list_player_t * p_mlp)
 {
+    if (!p_mlp)
+        return;
+
+    lock(p_mlp);
+    p_mlp->i_refcount--;
+    if (p_mlp->i_refcount > 0)
+    {
+        unlock(p_mlp);
+        return;
+    }
+
+    assert(p_mlp->i_refcount == 0);
+
+    /* Keep the lock(), because the uninstall functions
+     * check for it. That's convenient. */
+
+    if (p_mlp->p_mi)
+    {
+        uninstall_media_player_observer(p_mlp);
+        libvlc_media_player_release(p_mlp->p_mi);
+    }
+    if (p_mlp->p_mlist)
+    {
+        uninstall_playlist_observer(p_mlp);
+        libvlc_media_list_release(p_mlp->p_mlist);
+    }
+
+    unlock(p_mlp);
+    vlc_mutex_destroy(&p_mlp->object_lock);
+    vlc_mutex_destroy(&p_mlp->mp_callback_lock);
+
+    libvlc_event_manager_release(p_mlp->p_event_manager);
+
+    free(p_mlp->current_playing_item_path);
+    libvlc_release(p_mlp->p_libvlc_instance);
     free(p_mlp);
 }
 
 /**************************************************************************
- *        set_media_instance (Public)
+ *        event_manager (Public)
  **************************************************************************/
-void libvlc_media_list_player_set_media_instance(
-                                     libvlc_media_list_player_t * p_mlp,
-                                     libvlc_media_instance_t * p_mi,
-                                     libvlc_exception_t * p_e )
+libvlc_event_manager_t *
+libvlc_media_list_player_event_manager(libvlc_media_list_player_t * p_mlp)
 {
-    VLC_UNUSED(p_e);
+    return p_mlp->p_event_manager;
+}
 
-    vlc_mutex_lock( &p_mlp->object_lock );
+/**************************************************************************
+ *        set_media_player (Public)
+ **************************************************************************/
+void libvlc_media_list_player_set_media_player(libvlc_media_list_player_t * p_mlp, libvlc_media_player_t * p_mi)
+{
+    lock(p_mlp);
 
-    if( p_mlp->p_mi )
+    if (p_mlp->p_mi)
     {
-        uninstall_media_instance_observer( p_mlp );
-        libvlc_media_instance_release( p_mlp->p_mi );
+        uninstall_media_player_observer(p_mlp);
+        libvlc_media_player_release(p_mlp->p_mi);
     }
-    libvlc_media_instance_retain( p_mi );
+    libvlc_media_player_retain(p_mi);
     p_mlp->p_mi = p_mi;
 
-    install_media_instance_observer( p_mlp );
+    install_media_player_observer(p_mlp);
 
-    vlc_mutex_unlock( &p_mlp->object_lock );
+    unlock(p_mlp);
 }
 
 /**************************************************************************
  *       set_media_list (Public)
  **************************************************************************/
-void libvlc_media_list_player_set_media_list(
-                                     libvlc_media_list_player_t * p_mlp,
-                                     libvlc_media_list_t * p_mlist,
-                                     libvlc_exception_t * p_e )
-{
-    vlc_mutex_lock( &p_mlp->object_lock );
-    if( libvlc_media_list_player_is_playing( p_mlp, p_e ) )
-    {
-        libvlc_media_instance_stop( p_mlp->p_mi, p_e );
-        /* Don't bother if there was an error. */
-        libvlc_exception_clear( p_e );
-    }
+void libvlc_media_list_player_set_media_list(libvlc_media_list_player_t * p_mlp, libvlc_media_list_t * p_mlist)
+{
+    assert (p_mlist);
 
-    if( p_mlp->p_mlist )
+    lock(p_mlp);
+    if (p_mlp->p_mlist)
     {
-        uninstall_playlist_observer( p_mlp );
-        libvlc_media_list_release( p_mlp->p_mlist );
+        uninstall_playlist_observer(p_mlp);
+        libvlc_media_list_release(p_mlp->p_mlist);
     }
-    libvlc_media_list_retain( p_mlist );
+    libvlc_media_list_retain(p_mlist);
     p_mlp->p_mlist = p_mlist;
-    install_playlist_observer( p_mlp );
 
-    vlc_mutex_unlock( &p_mlp->object_lock );
+    install_playlist_observer(p_mlp);
+
+    unlock(p_mlp);
 }
 
 /**************************************************************************
  *        Play (Public)
  **************************************************************************/
-void libvlc_media_list_player_play( libvlc_media_list_player_t * p_mlp,
-                                  libvlc_exception_t * p_e )
+void libvlc_media_list_player_play(libvlc_media_list_player_t * p_mlp)
 {
-    if( !p_mlp->current_playing_item_path )
+    lock(p_mlp);
+    if (!p_mlp->current_playing_item_path)
     {
-        libvlc_media_list_player_next( p_mlp, p_e );
+        set_relative_playlist_position_and_play(p_mlp, 1);
+        unlock(p_mlp);
         return; /* Will set to play */
     }
-
-    libvlc_media_instance_play( p_mlp->p_mi, p_e );
+    libvlc_media_player_play(p_mlp->p_mi);
+    unlock(p_mlp);
 }
 
 
 /**************************************************************************
  *        Pause (Public)
  **************************************************************************/
-void libvlc_media_list_player_pause( libvlc_media_list_player_t * p_mlp,
-                                     libvlc_exception_t * p_e )
+void libvlc_media_list_player_pause(libvlc_media_list_player_t * p_mlp)
 {
-    if( !p_mlp->p_mi )
+    lock(p_mlp);
+    if (!p_mlp->p_mi)
+    {
+        unlock(p_mlp);
         return;
-    libvlc_media_instance_pause( p_mlp->p_mi, p_e );
+    }
+    libvlc_media_player_pause(p_mlp->p_mi);
+    unlock(p_mlp);
 }
 
 /**************************************************************************
  *        is_playing (Public)
  **************************************************************************/
-vlc_bool_t
-libvlc_media_list_player_is_playing( libvlc_media_list_player_t * p_mlp,
-                                     libvlc_exception_t * p_e )
+int
+libvlc_media_list_player_is_playing(libvlc_media_list_player_t * p_mlp)
 {
-    libvlc_state_t state = libvlc_media_instance_get_state( p_mlp->p_mi, p_e );
+    if (!p_mlp->p_mi)
+    {
+        return libvlc_NothingSpecial;
+    }
+    libvlc_state_t state = libvlc_media_player_get_state(p_mlp->p_mi);
     return (state == libvlc_Opening) || (state == libvlc_Buffering) ||
            (state == libvlc_Playing);
 }
@@ -355,99 +620,189 @@ libvlc_media_list_player_is_playing( libvlc_media_list_player_t * p_mlp,
  *        State (Public)
  **************************************************************************/
 libvlc_state_t
-libvlc_media_list_player_get_state( libvlc_media_list_player_t * p_mlp,
-                                    libvlc_exception_t * p_e )
+libvlc_media_list_player_get_state(libvlc_media_list_player_t * p_mlp)
 {
-    if( !p_mlp->p_mi )
-        return libvlc_Stopped;
-    return libvlc_media_instance_get_state( p_mlp->p_mi, p_e );
+    if (!p_mlp->p_mi)
+        return libvlc_Ended;
+    return libvlc_media_player_get_state(p_mlp->p_mi);
 }
 
 /**************************************************************************
  *        Play item at index (Public)
  **************************************************************************/
-void libvlc_media_list_player_play_item_at_index(
-                        libvlc_media_list_player_t * p_mlp,
-                        int i_index,
-                        libvlc_exception_t * p_e )
+int libvlc_media_list_player_play_item_at_index(libvlc_media_list_player_t * p_mlp, int i_index)
 {
-    set_current_playing_item( p_mlp, libvlc_media_list_path_with_root_index(i_index), p_e );
-
-    if( libvlc_exception_raised( p_e ) )
-        return;
+    lock(p_mlp);
+    set_current_playing_item(p_mlp, libvlc_media_list_path_with_root_index(i_index));
+    libvlc_media_player_play(p_mlp->p_mi);
+    unlock(p_mlp);
 
     /* Send the next item event */
     libvlc_event_t event;
     event.type = libvlc_MediaListPlayerNextItemSet;
-    libvlc_event_send( p_mlp->p_event_manager, &event );
-
-    libvlc_media_instance_play( p_mlp->p_mi, p_e );
+    libvlc_event_send(p_mlp->p_event_manager, &event);
+    return 0;
 }
 
 /**************************************************************************
  *        Play item (Public)
  **************************************************************************/
-void libvlc_media_list_player_play_item(
-                        libvlc_media_list_player_t * p_mlp,
-                        libvlc_media_descriptor_t * p_md,
-                        libvlc_exception_t * p_e )
+int libvlc_media_list_player_play_item(libvlc_media_list_player_t * p_mlp, libvlc_media_t * p_md)
 {
-    libvlc_media_list_path_t path = libvlc_media_list_path_of_item( p_mlp->p_mlist, p_md );
-    if( !path )
+    lock(p_mlp);
+    libvlc_media_list_path_t path = libvlc_media_list_path_of_item(p_mlp->p_mlist, p_md);
+    if (!path)
     {
-        libvlc_exception_raise( p_e, "No such item in media list" );
-        return;
+        libvlc_printerr("Item not found in media list");
+        unlock(p_mlp);
+        return -1;
     }
-    set_current_playing_item( p_mlp, path, p_e );
-
-    if( libvlc_exception_raised( p_e ) )
-        return;
 
-    libvlc_media_instance_play( p_mlp->p_mi, p_e );
+    set_current_playing_item(p_mlp, path);
+    libvlc_media_player_play(p_mlp->p_mi);
+    unlock(p_mlp);
+    return 0;
 }
 
 /**************************************************************************
- *       Stop (Public)
+ *       Stop (Private)
+ *
+ * Lock must be held.
  **************************************************************************/
-void libvlc_media_list_player_stop( libvlc_media_list_player_t * p_mlp,
-                                    libvlc_exception_t * p_e )
+static void stop(libvlc_media_list_player_t * p_mlp)
 {
-    libvlc_media_instance_stop( p_mlp->p_mi, p_e );
+    assert_locked(p_mlp);
 
-    vlc_mutex_lock( &p_mlp->object_lock );
-    free( p_mlp->current_playing_item_path );
+    if (p_mlp->p_mi)
+    {
+        /* We are not interested in getting media stop event now */
+        uninstall_media_player_observer(p_mlp);
+        libvlc_media_player_stop(p_mlp->p_mi);
+        install_media_player_observer(p_mlp);
+    }
+
+    free(p_mlp->current_playing_item_path);
     p_mlp->current_playing_item_path = NULL;
-    vlc_mutex_unlock( &p_mlp->object_lock );
 }
 
 /**************************************************************************
- *       Next (Public)
+ *       Stop (Public)
  **************************************************************************/
-void libvlc_media_list_player_next( libvlc_media_list_player_t * p_mlp,
-                                    libvlc_exception_t * p_e )
-{    
-    libvlc_media_list_path_t path;
-    
-    libvlc_media_list_lock( p_mlp->p_mlist );
+void libvlc_media_list_player_stop(libvlc_media_list_player_t * p_mlp)
+{
+    lock(p_mlp);
+    stop(p_mlp);
+    unlock(p_mlp);
+}
 
-    path = get_next_path( p_mlp );
+/**************************************************************************
+ *       Set relative playlist position and play (Private)
+ *
+ * Sets the currently played item to the given relative play item position
+ * (based on the currently playing item) and then begins the new item playback.
+ * Lock must be held.
+ **************************************************************************/
+static int set_relative_playlist_position_and_play(
+                                      libvlc_media_list_player_t * p_mlp,
+                                      int i_relative_position)
+{
+    assert_locked(p_mlp);
 
-    if( !path )
+    if (!p_mlp->p_mlist)
     {
-        libvlc_media_list_unlock( p_mlp->p_mlist );
-        libvlc_exception_raise( p_e, "No more element to play" );
-        libvlc_media_list_player_stop( p_mlp, p_e );
-        return;
+        libvlc_printerr("No media list");
+        return -1;
     }
 
-    set_current_playing_item( p_mlp, path, p_e );
-    
-    libvlc_media_instance_play( p_mlp->p_mi, p_e );
+    libvlc_media_list_lock(p_mlp->p_mlist);
+
+    libvlc_media_list_path_t path = p_mlp->current_playing_item_path;
 
-    libvlc_media_list_unlock( p_mlp->p_mlist );
+    if(p_mlp->e_playback_mode != libvlc_playback_mode_repeat)
+    {
+        bool b_loop = (p_mlp->e_playback_mode == libvlc_playback_mode_loop);
+
+        if(i_relative_position > 0)
+        {
+            do
+            {
+                path = get_next_path(p_mlp, b_loop);
+                set_current_playing_item(p_mlp, path);
+                --i_relative_position;
+            }
+            while(i_relative_position > 0);
+        }
+        else if(i_relative_position < 0)
+        {
+            do
+            {
+                path = get_previous_path(p_mlp, b_loop);
+                set_current_playing_item(p_mlp, path);
+                ++i_relative_position;
+            }
+            while (i_relative_position < 0);
+        }
+    }
+    else
+    {
+        set_current_playing_item(p_mlp, path);
+    }
+
+#ifdef DEBUG_MEDIA_LIST_PLAYER
+    printf("Playing:");
+    libvlc_media_list_path_dump(path);
+#endif
+
+    if (!path)
+    {
+        libvlc_media_list_unlock(p_mlp->p_mlist);
+        return -1;
+    }
+
+    libvlc_media_player_play(p_mlp->p_mi);
+
+    libvlc_media_list_unlock(p_mlp->p_mlist);
 
     /* Send the next item event */
     libvlc_event_t event;
     event.type = libvlc_MediaListPlayerNextItemSet;
-    libvlc_event_send( p_mlp->p_event_manager, &event);
+    libvlc_media_t * p_md = libvlc_media_list_item_at_path(p_mlp->p_mlist, path);
+    event.u.media_list_player_next_item_set.item = p_md;
+    libvlc_event_send(p_mlp->p_event_manager, &event);
+    libvlc_media_release(p_md);
+    return 0;
+}
+
+/**************************************************************************
+ *       Next (Public)
+ **************************************************************************/
+int libvlc_media_list_player_next(libvlc_media_list_player_t * p_mlp)
+{
+    lock(p_mlp);
+    int failure = set_relative_playlist_position_and_play(p_mlp, 1);
+    unlock(p_mlp);
+    return failure;
+}
+
+/**************************************************************************
+ *       Previous (Public)
+ **************************************************************************/
+int libvlc_media_list_player_previous(libvlc_media_list_player_t * p_mlp)
+{
+    lock(p_mlp);
+    int failure = set_relative_playlist_position_and_play(p_mlp, -1);
+    unlock(p_mlp);
+    return failure;
+}
+
+/**************************************************************************
+ *       Set Playback Mode (Public)
+ **************************************************************************/
+void libvlc_media_list_player_set_playback_mode(
+                                            libvlc_media_list_player_t * p_mlp,
+                                            libvlc_playback_mode_t e_mode )
+{
+    lock(p_mlp);
+    p_mlp->e_playback_mode = e_mode;
+    unlock(p_mlp);
 }