mm_player_next()

Skip to the next track.

Synopsis:

#include <mmplayer/mmplayerclient.h>
 
int mm_player_next( mmplayer_hdl_t *hdl )

Arguments:

hdl
The mm-player connection handle

Library:

mmplayerclient

Description:

Skip to the next track. The track considered as the "next track" depends on the shuffle and repeat mode settings.

When the repeat mode is REPEAT_ONE, the next track is always the current track (because it's set to repeat continuously).

When the repeat mode is REPEAT_ALL, the next track is the track immediately following the current track in either the sequential playback list (if shuffling is off) or in the randomized list (if shuffling is on). If the current track is the last track in the list, the next track is the first track in the list (because playback is looped).

When the repeat mode is REPEAT_OFF, the next track is selected in a similar manner based on the shuffle mode, except if the current track is the last track in the list, in which case playback stops because there is no next track.

Returns:

0 on success, -1 on failure