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;
43 p_sublist_of_playing_item = libvlc_media_list_sublist_at_path(
45 p_mlp->current_playing_item_path );
47 /* If item just gained a sublist just play it */
48 if( p_sublist_of_playing_item )
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 );
54 /* Try to catch next element */
55 p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(
57 p_mlp->current_playing_item_path );
59 int deepness = libvlc_media_list_path_deepness( p_mlp->current_playing_item_path );
60 if( deepness < 1 || !p_parent_of_playing_item )
63 ret = libvlc_media_list_path_copy( p_mlp->current_playing_item_path );
65 while( ret[deepness-1] >= libvlc_media_list_count( p_parent_of_playing_item, NULL ) )
71 libvlc_media_list_release( p_parent_of_playing_item );
76 p_parent_of_playing_item = libvlc_media_list_parentlist_at_path(
80 libvlc_media_list_release( p_parent_of_playing_item );
84 /**************************************************************************
85 * media_instance_reached_end (private) (Event Callback)
86 **************************************************************************/
88 media_instance_reached_end( const libvlc_event_t * p_event,
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;
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(
99 p_mlp->current_playing_item_path );
100 if( p_md != p_current_md )
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 );
108 libvlc_media_descriptor_release( p_md );
109 libvlc_media_descriptor_release( p_current_md );
110 libvlc_media_list_player_next( p_mlp, NULL );
113 /**************************************************************************
114 * playlist_item_deleted (private) (Event Callback)
115 **************************************************************************/
117 mlist_item_deleted( const libvlc_event_t * p_event, void * p_user_data )
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(
125 p_mlp->current_playing_item_path );
127 if( p_event->u.media_list_item_deleted.item == p_current_md &&
128 p_emitting_mlist == p_mlp->p_mlist )
130 /* We are playing this item, we choose to stop */
131 libvlc_media_list_player_stop( p_mlp, NULL );
135 /**************************************************************************
136 * install_playlist_observer (private)
137 **************************************************************************/
139 install_playlist_observer( libvlc_media_list_player_t * p_mlp )
141 libvlc_event_attach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
142 libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
145 /**************************************************************************
146 * uninstall_playlist_observer (private)
147 **************************************************************************/
149 uninstall_playlist_observer( libvlc_media_list_player_t * p_mlp )
151 libvlc_event_detach( libvlc_media_list_event_manager( p_mlp->p_mlist, NULL ),
152 libvlc_MediaListItemDeleted, mlist_item_deleted, p_mlp, NULL );
155 /**************************************************************************
156 * install_media_instance_observer (private)
157 **************************************************************************/
159 install_media_instance_observer( libvlc_media_list_player_t * p_mlp )
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 );
167 /**************************************************************************
168 * uninstall_media_instance_observer (private)
169 **************************************************************************/
171 uninstall_media_instance_observer( libvlc_media_list_player_t * p_mlp )
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 );
178 /**************************************************************************
180 **************************************************************************/
182 libvlc_media_list_player_is_playing( libvlc_media_list_player_t * p_mlp,
183 libvlc_exception_t * p_e )
185 //libvlc_exception_raise( p_e, "Unimplemented" );
189 /**************************************************************************
190 * set_current_playing_item (private)
192 * Playlist lock should be held
193 **************************************************************************/
195 set_current_playing_item( libvlc_media_list_player_t * p_mlp,
196 libvlc_media_list_path_t path,
197 libvlc_exception_t * p_e )
199 libvlc_media_descriptor_t * p_md;
201 p_md = libvlc_media_list_item_at_path( p_mlp->p_mlist, path );
204 if( !libvlc_exception_raised( p_e ) )
205 libvlc_exception_raise( p_e, "Can't obtain a media" );
209 vlc_mutex_lock( &p_mlp->object_lock );
211 free( p_mlp->current_playing_item_path );
212 p_mlp->current_playing_item_path = path;
214 /* We are not interested in getting media_descriptor stop event now */
215 uninstall_media_instance_observer( p_mlp );
216 if( p_md->p_subitems && libvlc_media_list_count( p_md->p_subitems, NULL ) > 0 )
218 libvlc_media_descriptor_t * p_submd;
219 p_submd = libvlc_media_list_item_at_index( p_md->p_subitems, 0, NULL );
220 libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_submd, NULL );
221 libvlc_media_descriptor_release( p_submd );
224 libvlc_media_instance_set_media_descriptor( p_mlp->p_mi, p_md, NULL );
225 // wait_playing_state(); /* If we want to be synchronous */
226 install_media_instance_observer( p_mlp );
228 vlc_mutex_unlock( &p_mlp->object_lock );
230 libvlc_media_list_unlock( p_mlp->p_mlist );
232 libvlc_media_descriptor_release( p_md ); /* for libvlc_media_list_item_at_index */
236 * Public libvlc functions
239 /**************************************************************************
241 **************************************************************************/
242 libvlc_media_list_player_t *
243 libvlc_media_list_player_new( libvlc_instance_t * p_instance,
244 libvlc_exception_t * p_e )
247 libvlc_media_list_player_t * p_mlp;
248 p_mlp = malloc(sizeof(libvlc_media_list_player_t));
249 p_mlp->current_playing_item_path = NULL;
251 p_mlp->p_mlist = NULL;
252 vlc_mutex_init( p_instance->p_libvlc_int, &p_mlp->object_lock );
253 p_mlp->p_event_manager = libvlc_event_manager_new( p_mlp,
256 libvlc_event_manager_register_event_type( p_mlp->p_event_manager,
257 libvlc_MediaListPlayerNextItemSet, p_e );
258 libvlc_event_manager_register_event_type( p_mlp->p_event_manager,
259 libvlc_MediaListPlayerNextItemSet, p_e );
264 /**************************************************************************
266 **************************************************************************/
267 void libvlc_media_list_player_release( libvlc_media_list_player_t * p_mlp )
272 /**************************************************************************
273 * set_media_instance (Public)
274 **************************************************************************/
275 void libvlc_media_list_player_set_media_instance(
276 libvlc_media_list_player_t * p_mlp,
277 libvlc_media_instance_t * p_mi,
278 libvlc_exception_t * p_e )
280 vlc_mutex_lock( &p_mlp->object_lock );
284 uninstall_media_instance_observer( p_mlp );
285 libvlc_media_instance_release( p_mlp->p_mi );
287 libvlc_media_instance_retain( p_mi );
290 install_media_instance_observer( p_mlp );
292 vlc_mutex_unlock( &p_mlp->object_lock );
295 /**************************************************************************
296 * set_media_list (Public)
297 **************************************************************************/
298 void libvlc_media_list_player_set_media_list(
299 libvlc_media_list_player_t * p_mlp,
300 libvlc_media_list_t * p_mlist,
301 libvlc_exception_t * p_e )
303 vlc_mutex_lock( &p_mlp->object_lock );
305 if( libvlc_media_list_player_is_playing( p_mlp, p_e ) )
307 libvlc_media_instance_stop( p_mlp->p_mi, p_e );
308 /* Don't bother if there was an error. */
309 libvlc_exception_clear( p_e );
314 uninstall_playlist_observer( p_mlp );
315 libvlc_media_list_release( p_mlp->p_mlist );
317 libvlc_media_list_retain( p_mlist );
318 p_mlp->p_mlist = p_mlist;
320 install_playlist_observer( p_mlp );
322 vlc_mutex_unlock( &p_mlp->object_lock );
325 /**************************************************************************
327 **************************************************************************/
328 void libvlc_media_list_player_play( libvlc_media_list_player_t * p_mlp,
329 libvlc_exception_t * p_e )
331 if( !p_mlp->current_playing_item_path )
333 libvlc_media_list_player_next( p_mlp, p_e );
334 return; /* Will set to play */
337 libvlc_media_instance_play( p_mlp->p_mi, p_e );
340 /**************************************************************************
341 * Play item at index (Public)
342 **************************************************************************/
343 void libvlc_media_list_player_play_item_at_index(
344 libvlc_media_list_player_t * p_mlp,
346 libvlc_exception_t * p_e )
348 set_current_playing_item( p_mlp, libvlc_media_list_path_with_root_index(i_index), p_e );
350 if( libvlc_exception_raised( p_e ) )
353 /* Send the next item event */
354 libvlc_event_t event;
355 event.type = libvlc_MediaListPlayerNextItemSet;
356 libvlc_event_send( p_mlp->p_event_manager, &event );
358 libvlc_media_instance_play( p_mlp->p_mi, p_e );
361 /**************************************************************************
363 **************************************************************************/
364 void libvlc_media_list_player_play_item(
365 libvlc_media_list_player_t * p_mlp,
366 libvlc_media_descriptor_t * p_md,
367 libvlc_exception_t * p_e )
369 libvlc_media_list_path_t path = libvlc_media_list_path_of_item( p_mlp->p_mlist, p_md );
372 libvlc_exception_raise( p_e, "No such item in media list" );
375 set_current_playing_item( p_mlp, path, p_e );
377 if( libvlc_exception_raised( p_e ) )
380 libvlc_media_instance_play( p_mlp->p_mi, p_e );
383 /**************************************************************************
385 **************************************************************************/
386 void libvlc_media_list_player_stop( libvlc_media_list_player_t * p_mlp,
387 libvlc_exception_t * p_e )
389 libvlc_media_instance_stop( p_mlp->p_mi, p_e );
391 vlc_mutex_lock( &p_mlp->object_lock );
392 p_mlp->current_playing_item_path = NULL;
393 vlc_mutex_unlock( &p_mlp->object_lock );
396 /**************************************************************************
398 **************************************************************************/
399 void libvlc_media_list_player_next( libvlc_media_list_player_t * p_mlp,
400 libvlc_exception_t * p_e )
402 libvlc_media_list_path_t path;
404 libvlc_media_list_lock( p_mlp->p_mlist );
406 path = get_next_path( p_mlp );
410 libvlc_media_list_unlock( p_mlp->p_mlist );
411 libvlc_exception_raise( p_e, "No more element to play" );
412 libvlc_media_list_player_stop( p_mlp, p_e );
416 set_current_playing_item( p_mlp, path, p_e );
418 libvlc_media_instance_play( p_mlp->p_mi, p_e );
420 libvlc_media_list_unlock( p_mlp->p_mlist );
422 /* Send the next item event */
423 libvlc_event_t event;
424 event.type = libvlc_MediaListPlayerNextItemSet;
425 libvlc_event_send( p_mlp->p_event_manager, &event);