A media node.


#include <mmplayer/types.h>

typedef struct mmp_ms_node {
    char *id;
    char *name;
    ms_node_type_e type;
    int count;
    int ms_id;
    ms_type_e ms_type;
} mmp_ms_node_t;


char *id
Unique ID of the media node
char *name
Name of the media node
ms_node_type_e type
Media node type
int count
Number of children contained in this node (-1 means unknown)
int ms_id
ID of the media source on which the media node is located
ms_type_e ms_type
Device type of the media source




The mmp_ms_node_t structure stores information on media nodes. A media node is a container of media objects stored on a media source. This container can be an individual media file (i.e., a track) or a folder that stores other media nodes (as indicated by type). The value in name can be a filename, folder name, or metadata name, depending on the configuration of mm-player.

The mm_player_get_trksession_tracks(), mm_player_browse(), and mm_player_search() functions each return an array of mmp_ms_node_t structures, with each array element storing the information of a single media node. When calling the functions for browsing, getting metadata, or creating tracksessions, clients must pass in the media node ID (which can be read from the id field). To start browsing a media source whose folder structure is unknown, clients can specify the path of the root folder (/) in the call to mm_player_browse(). They can then read the IDs of the media nodes found in the root folder and perform other browsing operations to explore these nodes.