git.sesse.net Git - vlc/blob - src/control/media_list_player.c

   1 /*****************************************************************************
   2  * media_list_player.c: libvlc new API media_list player functions
   3  *****************************************************************************
   4  * Copyright (C) 2007 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Pierre d'Herbemont <pdherbemont # videolan.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23 #include "libvlc_internal.h"
  24 #include <vlc/libvlc.h>
  25 #include "media_list_path.h"
  26
  27 /*
  28  * Private functions
  29  */
  30
  31 /**************************************************************************
  32  *       get_next_index (private)
  33  *
  34  * Simple next item fetcher.
  35  **************************************************************************/
  36 static libvlc_media_list_path_t
  37 get_next_path( libvlc_media_list_player_t * p_mlp )
  38 {
  39     /* We are entered with libvlc_media_list_lock( p_mlp->p_list ) */
  40     libvlc_media_list_path_t ret;
  41     libvlc_media_list_t * p_parent_of_playing_item;
  42     libvlc_media_list_t * p_sublist_of_playing_item;
  43     p_sublist_of_playing_item = libvlc_media_list_sublist_at_path(
  44                             p_mlp->p_mlist,
  45                             p_mlp->current_playing_item_path );
  46
  47     /* If item just gained a sublist just play it */
  48     if( p_sublist_of_playing_item )
  49     {
  50         libvlc_media_list_release( p_sublist_of_playing_item );
  51         return libvlc_media_list_path_copy_by_appending( p_mlp->current_playing_item_path, 0 );
  52     }
  53
  54     /* Try to catch next element */
  55     p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(
  56                             p_mlp->p_mlist,
  57                             p_mlp->current_playing_item_path );
  58
  59     int deepness = libvlc_media_list_path_deepness( p_mlp->current_playing_item_path );
  60     if( deepness < 1 || !p_parent_of_playing_item )
  61         return NULL;
  62
  63     ret = libvlc_media_list_path_copy( p_mlp->current_playing_item_path );
  64
  65     while( ret[deepness-1] >= libvlc_media_list_count( p_parent_of_playing_item, NULL ) )
  66     {
  67         deepness--;
  68         if( deepness <= 0 )
  69         {
  70             free( ret );
  71             libvlc_media_list_release( p_parent_of_playing_item );
  72             return NULL;
  73         }
  74         ret[deepness] = -1;
  75         ret[deepness-1]++;
  76         p_parent_of_playing_item  = libvlc_media_list_parentlist_at_path(
  77                                         p_mlp->p_mlist,
  78                                         ret );
  79     }
  80     libvlc_media_list_release( p_parent_of_playing_item );
  81     return ret;
  82 }
  83
  84 /**************************************************************************
  85  *       media_instance_reached_end (private) (Event Callback)
  86  **************************************************************************/
  87 static void
  88 media_instance_reached_end( const libvlc_event_t * p_event,
  89                             void * p_user_data )
  90 {
  91     libvlc_media_list_player_t * p_mlp = p_user_data;
  92     libvlc_media_instance_t * p_mi = p_event->p_obj;
  93     libvlc_media_descriptor_t *p_md, * p_current_md;
  94
  95     p_md = libvlc_media_instance_get_media_descriptor( p_mi, NULL );
  96     /* XXX: need if p_mlp->p_current_playing_index is beyond */
  97     p_current_md = libvlc_media_list_item_at_path(
  98                         p_mlp->p_mlist,
  99                         p_mlp->current_playing_item_path );
 100     if( p_md != p_current_md )
 101     {
 102         msg_Warn( p_mlp->p_libvlc_instance->p_libvlc_int,
 103                   "We are not sync-ed with the media instance" );
 104         libvlc_media_descriptor_release( p_md );
 105         libvlc_media_descriptor_release( p_current_md );
 106         return;
 107     }
 108     libvlc_media_descriptor_release( p_md );
 109     libvlc_media_descriptor_release( p_current_md );
 110     libvlc_media_list_player_next( p_mlp, NULL );
 111 }
 112
 113 /**************************************************************************
 114  *       playlist_item_deleted (private) (Event Callback)
 115  **************************************************************************/
 116 static void
 117 mlist_item_deleted( const libvlc_event_t * p_event, void * p_user_data )
 118 {
 119     libvlc_media_descriptor_t * p_current_md;
 120     libvlc_media_list_player_t * p_mlp = p_user_data;
 121     libvlc_media_list_t * p_emitting_mlist = p_event->p_obj;
 122     /* XXX: need if p_mlp->p_current_playing_index is beyond */
 123     p_current_md = libvlc_media_list_item_at_path(
 124                         p_mlp->p_mlist,
 125                         p_mlp->current_playing_item_path );
 126
 127     if( p_event->u.media_list_item_deleted.item == p_current_md &&
 128         p_emitting_mlist == p_mlp->p_mlist )
 129     {
 130         /* We are playing this item, we choose to stop */
 131         libvlc_media_list_player_stop( p_mlp, NULL );
 132     }
 133 }
 134
 135 /**************************************************************************
 136  *       install_playlist_observer (private)
 137  **************************************************************************/
 138 static void
 139 install_playlist_observer( libvlc_media_list_player_t * p_mlp )
 140 {
 141     libvlc_event_attach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
 142             libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
 143 }
 144
 145 /**************************************************************************
 146  *       uninstall_playlist_observer (private)
 147  **************************************************************************/
 148 static void
 149 uninstall_playlist_observer( libvlc_media_list_player_t * p_mlp )
 150 {
 151     libvlc_event_detach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
 152             libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
 153 }
 154
 155 /**************************************************************************
 156  *       install_media_instance_observer (private)
 157  **************************************************************************/
 158 static void
 159 install_media_instance_observer( libvlc_media_list_player_t * p_mlp )
 160 {
 161     libvlc_event_attach( libvlc_media_instance_event_manager( p_mlp->p_mi, NULL ),
 162                          libvlc_MediaInstanceReachedEnd,
 163                           media_instance_reached_end, p_mlp, NULL );
 164 }
 165
 166
 167 /**************************************************************************
 168  *       uninstall_media_instance_observer (private)
 169  **************************************************************************/
 170 static void
 171 uninstall_media_instance_observer( libvlc_media_list_player_t * p_mlp )
 172 {
 173     libvlc_event_detach( libvlc_media_instance_event_manager( p_mlp->p_mi, NULL ),
 174                          libvlc_MediaInstanceReachedEnd,
 175                          media_instance_reached_end, p_mlp, NULL );
 176 }
 177
 178 /**************************************************************************
 179  *       set_current_playing_item (private)
 180  *
 181  * Playlist lock should be held
 182  **************************************************************************/
 183 static void
 184 set_current_playing_item( libvlc_media_list_player_t * p_mlp,
 185                           libvlc_media_list_path_t path,
 186                           libvlc_exception_t * p_e )
 187 {
 188     libvlc_media_descriptor_t * p_md;
 189
 190     p_md = libvlc_media_list_item_at_path( p_mlp->p_mlist, path );
 191     vlc_mutex_lock( &p_mlp->object_lock );
 192
 193     free( p_mlp->current_playing_item_path );
 194     p_mlp->current_playing_item_path = path;
 195
 196     if( !p_md )
 197     {
 198         vlc_mutex_unlock( &p_mlp->object_lock );
 199         return;
 200     }
 201
 202     /* We are not interested in getting media_descriptor stop event now */
 203     uninstall_media_instance_observer( p_mlp );
 204     if( p_md->p_subitems && libvlc_media_list_count( p_md->p_subitems, NULL ) > 0 )
 205     {
 206         libvlc_media_descriptor_t * p_submd;
 207         p_submd = libvlc_media_list_item_at_index( p_md->p_subitems, 0, NULL );
 208         libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_submd, NULL );
 209         libvlc_media_descriptor_release( p_submd );
 210     }
 211     else
 212         libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_md, NULL );
 213 //    wait_playing_state(); /* If we want to be synchronous */
 214     install_media_instance_observer( p_mlp );
 215
 216     vlc_mutex_unlock( &p_mlp->object_lock );
 217
 218     libvlc_media_list_unlock( p_mlp->p_mlist );
 219
 220     libvlc_media_descriptor_release( p_md ); /* for libvlc_media_list_item_at_index */
 221 }
 222
 223 /*
 224  * Public libvlc functions
 225  */
 226
 227 /**************************************************************************
 228  *         new (Public)
 229  **************************************************************************/
 230 libvlc_media_list_player_t *
 231 libvlc_media_list_player_new( libvlc_instance_t * p_instance,
 232                               libvlc_exception_t * p_e )
 233 {
 234     (void)p_e;
 235     libvlc_media_list_player_t * p_mlp;
 236     p_mlp = malloc(sizeof(libvlc_media_list_player_t));
 237     p_mlp->current_playing_item_path = NULL;
 238     p_mlp->p_mi = NULL;
 239     p_mlp->p_mlist = NULL;
 240     vlc_mutex_init( p_instance->p_libvlc_int, &p_mlp->object_lock );
 241     p_mlp->p_event_manager = libvlc_event_manager_new( p_mlp,
 242                                                        p_instance,
 243                                                        p_e );
 244     libvlc_event_manager_register_event_type( p_mlp->p_event_manager,
 245             libvlc_MediaListPlayerNextItemSet, p_e );
 246     libvlc_event_manager_register_event_type( p_mlp->p_event_manager,
 247             libvlc_MediaListPlayerNextItemSet, p_e );
 248
 249     return p_mlp;
 250 }
 251
 252 /**************************************************************************
 253  *         release (Public)
 254  **************************************************************************/
 255 void libvlc_media_list_player_release( libvlc_media_list_player_t * p_mlp )
 256 {
 257     free(p_mlp);
 258 }
 259
 260 /**************************************************************************
 261  *        set_media_instance (Public)
 262  **************************************************************************/
 263 void libvlc_media_list_player_set_media_instance(
 264                                      libvlc_media_list_player_t * p_mlp,
 265                                      libvlc_media_instance_t * p_mi,
 266                                      libvlc_exception_t * p_e )
 267 {
 268     vlc_mutex_lock( &p_mlp->object_lock );
 269
 270     if( p_mlp->p_mi )
 271     {
 272         uninstall_media_instance_observer( p_mlp );
 273         libvlc_media_instance_release( p_mlp->p_mi );
 274     }
 275     libvlc_media_instance_retain( p_mi );
 276     p_mlp->p_mi = p_mi;
 277
 278     install_media_instance_observer( p_mlp );
 279
 280     vlc_mutex_unlock( &p_mlp->object_lock );
 281 }
 282
 283 /**************************************************************************
 284  *       set_media_list (Public)
 285  **************************************************************************/
 286 void libvlc_media_list_player_set_media_list(
 287                                      libvlc_media_list_player_t * p_mlp,
 288                                      libvlc_media_list_t * p_mlist,
 289                                      libvlc_exception_t * p_e )
 290 {
 291     vlc_mutex_lock( &p_mlp->object_lock );
 292
 293     if( libvlc_media_list_player_is_playing( p_mlp, p_e ) )
 294     {
 295         libvlc_media_instance_stop( p_mlp->p_mi, p_e );
 296         /* Don't bother if there was an error. */
 297         libvlc_exception_clear( p_e );
 298     }
 299
 300     if( p_mlp->p_mlist )
 301     {
 302         uninstall_playlist_observer( p_mlp );
 303         libvlc_media_list_release( p_mlp->p_mlist );
 304     }
 305     libvlc_media_list_retain( p_mlist );
 306     p_mlp->p_mlist = p_mlist;
 307
 308     install_playlist_observer( p_mlp );
 309
 310     vlc_mutex_unlock( &p_mlp->object_lock );
 311 }
 312
 313 /**************************************************************************
 314  *        Play (Public)
 315  **************************************************************************/
 316 void libvlc_media_list_player_play( libvlc_media_list_player_t * p_mlp,
 317                                   libvlc_exception_t * p_e )
 318 {
 319     if( !p_mlp->current_playing_item_path )
 320     {
 321         libvlc_media_list_player_next( p_mlp, p_e );
 322         return; /* Will set to play */
 323     }
 324
 325     libvlc_media_instance_play( p_mlp->p_mi, p_e );
 326 }
 327
 328
 329 /**************************************************************************
 330  *        Pause (Public)
 331  **************************************************************************/
 332 void libvlc_media_list_player_pause( libvlc_media_list_player_t * p_mlp,
 333                                      libvlc_exception_t * p_e )
 334 {
 335     if( !p_mlp->p_mi )
 336         return;
 337     libvlc_media_instance_pause( p_mlp->p_mi, p_e );
 338 }
 339
 340 /**************************************************************************
 341  *        is_playing (Public)
 342  **************************************************************************/
 343 int libvlc_media_list_player_is_playing( libvlc_media_list_player_t * p_mlp,
 344                                          libvlc_exception_t * p_e )
 345 {
 346     libvlc_state_t state = libvlc_media_instance_get_state( p_mlp->p_mi, p_e );
 347     return (state == libvlc_Opening) || (state == libvlc_Buffering) ||
 348            (state == libvlc_Playing);
 349 }
 350
 351 /**************************************************************************
 352  *        State (Public)
 353  **************************************************************************/
 354 libvlc_state_t
 355 libvlc_media_list_player_get_state( libvlc_media_list_player_t * p_mlp,
 356                                     libvlc_exception_t * p_e )
 357 {
 358     if( !p_mlp->p_mi )
 359         return libvlc_Stopped;
 360     return libvlc_media_instance_get_state( p_mlp->p_mi, p_e );
 361 }
 362
 363 /**************************************************************************
 364  *        Play item at index (Public)
 365  **************************************************************************/
 366 void libvlc_media_list_player_play_item_at_index(
 367                         libvlc_media_list_player_t * p_mlp,
 368                         int i_index,
 369                         libvlc_exception_t * p_e )
 370 {
 371     set_current_playing_item( p_mlp, libvlc_media_list_path_with_root_index(i_index), p_e );
 372
 373     if( libvlc_exception_raised( p_e ) )
 374         return;
 375
 376     /* Send the next item event */
 377     libvlc_event_t event;
 378     event.type = libvlc_MediaListPlayerNextItemSet;
 379     libvlc_event_send( p_mlp->p_event_manager, &event );
 380
 381     libvlc_media_instance_play( p_mlp->p_mi, p_e );
 382 }
 383
 384 /**************************************************************************
 385  *        Play item (Public)
 386  **************************************************************************/
 387 void libvlc_media_list_player_play_item(
 388                         libvlc_media_list_player_t * p_mlp,
 389                         libvlc_media_descriptor_t * p_md,
 390                         libvlc_exception_t * p_e )
 391 {
 392     libvlc_media_list_path_t path = libvlc_media_list_path_of_item( p_mlp->p_mlist, p_md );
 393     if( !path )
 394     {
 395         libvlc_exception_raise( p_e, "No such item in media list" );
 396         return;
 397     }
 398     set_current_playing_item( p_mlp, path, p_e );
 399
 400     if( libvlc_exception_raised( p_e ) )
 401         return;
 402
 403     libvlc_media_instance_play( p_mlp->p_mi, p_e );
 404 }
 405
 406 /**************************************************************************
 407  *       Stop (Public)
 408  **************************************************************************/
 409 void libvlc_media_list_player_stop( libvlc_media_list_player_t * p_mlp,
 410                                     libvlc_exception_t * p_e )
 411 {
 412     libvlc_media_instance_stop( p_mlp->p_mi, p_e );
 413
 414     vlc_mutex_lock( &p_mlp->object_lock );
 415     free( p_mlp->current_playing_item_path );
 416     p_mlp->current_playing_item_path = NULL;
 417     vlc_mutex_unlock( &p_mlp->object_lock );
 418 }
 419
 420 /**************************************************************************
 421  *       Next (Public)
 422  **************************************************************************/
 423 void libvlc_media_list_player_next( libvlc_media_list_player_t * p_mlp,
 424                                     libvlc_exception_t * p_e )
 425 {
 426     libvlc_media_list_path_t path;
 427
 428     libvlc_media_list_lock( p_mlp->p_mlist );
 429
 430     path = get_next_path( p_mlp );
 431
 432     if( !path )
 433     {
 434         libvlc_media_list_unlock( p_mlp->p_mlist );
 435         libvlc_exception_raise( p_e, "No more element to play" );
 436         libvlc_media_list_player_stop( p_mlp, p_e );
 437         return;
 438     }
 439
 440     set_current_playing_item( p_mlp, path, p_e );
 441
 442     libvlc_media_instance_play( p_mlp->p_mi, p_e );
 443
 444     libvlc_media_list_unlock( p_mlp->p_mlist );
 445
 446     /* Send the next item event */
 447     libvlc_event_t event;
 448     event.type = libvlc_MediaListPlayerNextItemSet;
 449     libvlc_event_send( p_mlp->p_event_manager, &event);
 450 }