playlist.h

Go to the documentation of this file.

#pragma once
 
#include "esp_err.h"
#include <stddef.h>
#include <stdbool.h>


typedef enum {
    PLAYLIST_REPEAT_OFF = 0,  
    PLAYLIST_REPEAT_ALL,      
    PLAYLIST_REPEAT_ONE,      
} playlist_repeat_t;

typedef struct {
    size_t      index;  
    const char *path;   
    const char *name;   
} playlist_track_t;

esp_err_t playlist_sync(void);

esp_err_t playlist_current(playlist_track_t *out);

esp_err_t playlist_next(playlist_track_t *out);

esp_err_t playlist_prev(playlist_track_t *out);

esp_err_t playlist_select(size_t index, playlist_track_t *out);

esp_err_t playlist_random(playlist_track_t *out);

void playlist_set_repeat(playlist_repeat_t mode);

playlist_repeat_t playlist_get_repeat(void);

void playlist_set_shuffle(bool on);

bool playlist_get_shuffle(void);
 
/* ---- queue view/edit (for the playlist browser UI) --------------------- */
/* The "queue" is the play order from the current track onward: row 0 is the
   track playing now, rows >= 1 are the upcoming tracks in play order. Edits
   only touch the upcoming region, so the current track keeps playing. These
   are session edits over the play order; a playlist_sync() (rescan/reboot)
   rebuilds the full order and any removed track reappears. */

size_t playlist_queue_len(void);

esp_err_t playlist_queue_at(size_t row, playlist_track_t *out);

esp_err_t playlist_queue_move_up(size_t row);

esp_err_t playlist_queue_move_down(size_t row);

esp_err_t playlist_queue_remove(size_t row);