1 /*****************************************************************************
2 * media_list_player.c: libvlc new API media_list player functions
3 *****************************************************************************
4 * Copyright (C) 2007 the VideoLAN team
7 * Authors: Pierre d'Herbemont <pdherbemont # videolan.org>
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.
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.
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"
31 /**************************************************************************
32 * get_next_index (private)
34 * Simple next item fetcher.
35 **************************************************************************/
36 static libvlc_media_list_path_t
37 get_next_path( libvlc_media_list_player_t * p_mlp )
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;
44 p_sublist_of_playing_item = libvlc_media_list_sublist_at_path(
46 p_mlp->current_playing_item_path );
48 /* If item just gained a sublist just play it */
49 if( p_sublist_of_playing_item )
51 libvlc_media_list_release( p_sublist_of_playing_item );
52 return libvlc_media_list_path_copy_by_appending( p_mlp->current_playing_item_path, 0 );
55 /* Try to catch next element */
56 p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(
58 p_mlp->current_playing_item_path );
60 int deepness = libvlc_media_list_path_deepness( p_mlp->current_playing_item_path );
61 if( deepness < 1 || !p_parent_of_playing_item )
64 ret = libvlc_media_list_path_copy( p_mlp->current_playing_item_path );
66 while( ret[deepness-1] >= libvlc_media_list_count( p_parent_of_playing_item, NULL ) )
72 libvlc_media_list_release( p_parent_of_playing_item );
77 p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(
81 libvlc_media_list_release( p_parent_of_playing_item );
85 /**************************************************************************
86 * media_instance_reached_end (private) (Event Callback)
87 **************************************************************************/
89 media_instance_reached_end( const libvlc_event_t * p_event,
92 libvlc_media_list_player_t * p_mlp = p_user_data;
93 libvlc_media_instance_t * p_mi = p_event->p_obj;
94 libvlc_media_descriptor_t *p_md, * p_current_md;
96 p_md = libvlc_media_instance_get_media_descriptor( p_mi, NULL );
97 /* XXX: need if p_mlp->p_current_playing_index is beyond */
98 p_current_md = libvlc_media_list_item_at_path(
100 p_mlp->current_playing_item_path );
101 if( p_md != p_current_md )
103 msg_Warn( p_mlp->p_libvlc_instance->p_libvlc_int,
104 "We are not sync-ed with the media instance" );
105 libvlc_media_descriptor_release( p_md );
106 libvlc_media_descriptor_release( p_current_md );
109 libvlc_media_descriptor_release( p_md );
110 libvlc_media_descriptor_release( p_current_md );
111 libvlc_media_list_player_next( p_mlp, NULL );
114 /**************************************************************************
115 * playlist_item_deleted (private) (Event Callback)
116 **************************************************************************/
118 mlist_item_deleted( const libvlc_event_t * p_event, void * p_user_data )
120 libvlc_media_descriptor_t * p_current_md;
121 libvlc_media_list_player_t * p_mlp = p_user_data;
122 libvlc_media_list_t * p_emitting_mlist = p_event->p_obj;
123 /* XXX: need if p_mlp->p_current_playing_index is beyond */
124 p_current_md = libvlc_media_list_item_at_path(
126 p_mlp->current_playing_item_path );
128 if( p_event->u.media_list_item_deleted.item == p_current_md &&
129 p_emitting_mlist == p_mlp->p_mlist )
131 /* We are playing this item, we choose to stop */
132 libvlc_media_list_player_stop( p_mlp, NULL );
136 /**************************************************************************
137 * install_playlist_observer (private)
138 **************************************************************************/
140 install_playlist_observer( libvlc_media_list_player_t * p_mlp )
142 libvlc_event_attach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
143 libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
146 /**************************************************************************
147 * uninstall_playlist_observer (private)
148 **************************************************************************/
150 uninstall_playlist_observer( libvlc_media_list_player_t * p_mlp )
152 libvlc_event_detach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
153 libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
156 /**************************************************************************
157 * install_media_instance_observer (private)
158 **************************************************************************/
160 install_media_instance_observer( libvlc_media_list_player_t * p_mlp )
162 libvlc_event_attach( libvlc_media_instance_event_manager( p_mlp->p_mi, NULL ),
163 libvlc_MediaInstanceReachedEnd,
164 media_instance_reached_end, p_mlp, NULL );
168 /**************************************************************************
169 * uninstall_media_instance_observer (private)
170 **************************************************************************/
172 uninstall_media_instance_observer( libvlc_media_list_player_t * p_mlp )
174 libvlc_event_detach( libvlc_media_instance_event_manager( p_mlp->p_mi, NULL ),
175 libvlc_MediaInstanceReachedEnd,
176 media_instance_reached_end, p_mlp, NULL );
179 /**************************************************************************
180 * set_current_playing_item (private)
182 * Playlist lock should be held
183 **************************************************************************/
185 set_current_playing_item( libvlc_media_list_player_t * p_mlp,
186 libvlc_media_list_path_t path,
187 libvlc_exception_t * p_e )
191 libvlc_media_descriptor_t * p_md;
193 p_md = libvlc_media_list_item_at_path( p_mlp->p_mlist, path );
194 vlc_mutex_lock( &p_mlp->object_lock );
196 free( p_mlp->current_playing_item_path );
197 p_mlp->current_playing_item_path = path;
201 vlc_mutex_unlock( &p_mlp->object_lock );
205 /* We are not interested in getting media_descriptor stop event now */
206 uninstall_media_instance_observer( p_mlp );
207 if( p_md->p_subitems && libvlc_media_list_count( p_md->p_subitems, NULL ) > 0 )
209 libvlc_media_descriptor_t * p_submd;
210 p_submd = libvlc_media_list_item_at_index( p_md->p_subitems, 0, NULL );
211 libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_submd, NULL );
212 libvlc_media_descriptor_release( p_submd );
215 libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_md, NULL );
216 // wait_playing_state(); /* If we want to be synchronous */
217 install_media_instance_observer( p_mlp );
219 vlc_mutex_unlock( &p_mlp->object_lock );
221 libvlc_media_list_unlock( p_mlp->p_mlist );
223 libvlc_media_descriptor_release( p_md ); /* for libvlc_media_list_item_at_index */
227 * Public libvlc functions
230 /**************************************************************************
232 **************************************************************************/
233 libvlc_media_list_player_t *
234 libvlc_media_list_player_new( libvlc_instance_t * p_instance,
235 libvlc_exception_t * p_e )
238 libvlc_media_list_player_t * p_mlp;
239 p_mlp = malloc(sizeof(libvlc_media_list_player_t));
240 p_mlp->current_playing_item_path = NULL;
242 p_mlp->p_mlist = NULL;
243 vlc_mutex_init( p_instance->p_libvlc_int, &p_mlp->object_lock );
244 p_mlp->p_event_manager = libvlc_event_manager_new( p_mlp,
247 libvlc_event_manager_register_event_type( p_mlp->p_event_manager,
248 libvlc_MediaListPlayerNextItemSet, p_e );
253 /**************************************************************************
255 **************************************************************************/
256 void libvlc_media_list_player_release( libvlc_media_list_player_t * p_mlp )
261 /**************************************************************************
262 * set_media_instance (Public)
263 **************************************************************************/
264 void libvlc_media_list_player_set_media_instance(
265 libvlc_media_list_player_t * p_mlp,
266 libvlc_media_instance_t * p_mi,
267 libvlc_exception_t * p_e )
271 vlc_mutex_lock( &p_mlp->object_lock );
275 uninstall_media_instance_observer( p_mlp );
276 libvlc_media_instance_release( p_mlp->p_mi );
278 libvlc_media_instance_retain( p_mi );
281 install_media_instance_observer( p_mlp );
283 vlc_mutex_unlock( &p_mlp->object_lock );
286 /**************************************************************************
287 * set_media_list (Public)
288 **************************************************************************/
289 void libvlc_media_list_player_set_media_list(
290 libvlc_media_list_player_t * p_mlp,
291 libvlc_media_list_t * p_mlist,
292 libvlc_exception_t * p_e )
294 vlc_mutex_lock( &p_mlp->object_lock );
296 if( libvlc_media_list_player_is_playing( p_mlp, p_e ) )
298 libvlc_media_instance_stop( p_mlp->p_mi, p_e );
299 /* Don't bother if there was an error. */
300 libvlc_exception_clear( p_e );
305 uninstall_playlist_observer( p_mlp );
306 libvlc_media_list_release( p_mlp->p_mlist );
308 libvlc_media_list_retain( p_mlist );
309 p_mlp->p_mlist = p_mlist;
311 install_playlist_observer( p_mlp );
313 vlc_mutex_unlock( &p_mlp->object_lock );
316 /**************************************************************************
318 **************************************************************************/
319 void libvlc_media_list_player_play( libvlc_media_list_player_t * p_mlp,
320 libvlc_exception_t * p_e )
322 if( !p_mlp->current_playing_item_path )
324 libvlc_media_list_player_next( p_mlp, p_e );
325 return; /* Will set to play */
328 libvlc_media_instance_play( p_mlp->p_mi, p_e );
332 /**************************************************************************
334 **************************************************************************/
335 void libvlc_media_list_player_pause( libvlc_media_list_player_t * p_mlp,
336 libvlc_exception_t * p_e )
340 libvlc_media_instance_pause( p_mlp->p_mi, p_e );
343 /**************************************************************************
344 * is_playing (Public)
345 **************************************************************************/
347 libvlc_media_list_player_is_playing( libvlc_media_list_player_t * p_mlp,
348 libvlc_exception_t * p_e )
350 libvlc_state_t state = libvlc_media_instance_get_state( p_mlp->p_mi, p_e );
351 return (state == libvlc_Opening) || (state == libvlc_Buffering) ||
352 (state == libvlc_Playing);
355 /**************************************************************************
357 **************************************************************************/
359 libvlc_media_list_player_get_state( libvlc_media_list_player_t * p_mlp,
360 libvlc_exception_t * p_e )
363 return libvlc_Stopped;
364 return libvlc_media_instance_get_state( p_mlp->p_mi, p_e );
367 /**************************************************************************
368 * Play item at index (Public)
369 **************************************************************************/
370 void libvlc_media_list_player_play_item_at_index(
371 libvlc_media_list_player_t * p_mlp,
373 libvlc_exception_t * p_e )
375 set_current_playing_item( p_mlp, libvlc_media_list_path_with_root_index(i_index), p_e );
377 if( libvlc_exception_raised( p_e ) )
380 /* Send the next item event */
381 libvlc_event_t event;
382 event.type = libvlc_MediaListPlayerNextItemSet;
383 libvlc_event_send( p_mlp->p_event_manager, &event );
385 libvlc_media_instance_play( p_mlp->p_mi, p_e );
388 /**************************************************************************
390 **************************************************************************/
391 void libvlc_media_list_player_play_item(
392 libvlc_media_list_player_t * p_mlp,
393 libvlc_media_descriptor_t * p_md,
394 libvlc_exception_t * p_e )
396 libvlc_media_list_path_t path = libvlc_media_list_path_of_item( p_mlp->p_mlist, p_md );
399 libvlc_exception_raise( p_e, "No such item in media list" );
402 set_current_playing_item( p_mlp, path, p_e );
404 if( libvlc_exception_raised( p_e ) )
407 libvlc_media_instance_play( p_mlp->p_mi, p_e );
410 /**************************************************************************
412 **************************************************************************/
413 void libvlc_media_list_player_stop( libvlc_media_list_player_t * p_mlp,
414 libvlc_exception_t * p_e )
416 libvlc_media_instance_stop( p_mlp->p_mi, p_e );
418 vlc_mutex_lock( &p_mlp->object_lock );
419 free( p_mlp->current_playing_item_path );
420 p_mlp->current_playing_item_path = NULL;
421 vlc_mutex_unlock( &p_mlp->object_lock );
424 /**************************************************************************
426 **************************************************************************/
427 void libvlc_media_list_player_next( libvlc_media_list_player_t * p_mlp,
428 libvlc_exception_t * p_e )
430 libvlc_media_list_path_t path;
432 if (! p_mlp->p_mlist )
434 libvlc_exception_raise( p_e, "No more element to play" );
438 libvlc_media_list_lock( p_mlp->p_mlist );
440 path = get_next_path( p_mlp );
444 libvlc_media_list_unlock( p_mlp->p_mlist );
445 libvlc_exception_raise( p_e, "No more element to play" );
446 libvlc_media_list_player_stop( p_mlp, p_e );
450 set_current_playing_item( p_mlp, path, p_e );
452 libvlc_media_instance_play( p_mlp->p_mi, p_e );
454 libvlc_media_list_unlock( p_mlp->p_mlist );
456 /* Send the next item event */
457 libvlc_event_t event;
458 event.type = libvlc_MediaListPlayerNextItemSet;
459 libvlc_event_send( p_mlp->p_event_manager, &event);