* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
*****************************************************************************/
-#ifndef _VLC_VLM_H
-#define _VLC_VLM_H 1
+#ifndef VLC_VLM_H
+#define VLC_VLM_H 1
-/* VLM specific - structures and functions */
-enum
-{
- VOD_TYPE = 0,
- BROADCAST_TYPE,
- SCHEDULE_TYPE,
-};
+/**
+ * \file
+ * This file defines VLM core functions and structures in vlc
+ */
+
+#include <vlc_input.h>
+/**
+ * \defgroup server VLM
+ * VLM is the server core in vlc that allows streaming of multiple media streams
+ * at the same time. It provides broadcast, schedule and video on demand features
+ * for streaming using several streaming and network protocols.
+ * @{
+ */
+
+/** VLM media */
typedef struct
{
- /* instance name */
- char *psz_name;
+ int64_t id; /*< numeric id for vlm_media_t item */
+ bool b_enabled; /*< vlm_media_t is enabled */
- /* "playlist" index */
- int i_index;
+ char *psz_name; /*< descriptive name of vlm_media_t item */
- input_item_t item;
- input_thread_t *p_input;
+ int i_input; /*< number of input options */
+ char **ppsz_input; /*< array of input options */
-} vlm_media_instance_t;
+ int i_option; /*< number of output options */
+ char **ppsz_option; /*< array of output options */
-struct vlm_media_t
-{
- vlc_bool_t b_enabled;
- int i_type;
+ char *psz_output; /*< */
- /* name "media" is reserved */
- char *psz_name;
- input_item_t item;
+ bool b_vod; /*< vlm_media_t is of type VOD */
+ struct
+ {
+ bool b_loop; /*< this vlc_media_t broadcast item should loop */
+ } broadcast; /*< Broadcast specific information */
+ struct
+ {
+ char *psz_mux; /*< name of muxer to use */
+ } vod; /*< VOD specific information */
- /* "playlist" */
- int i_input;
- char **input;
+} vlm_media_t;
- int i_option;
- char **option;
+/** VLM media instance */
+typedef struct
+{
+ char *psz_name; /*< vlm media instance descriptive name */
- char *psz_output;
+ int64_t i_time; /*< vlm media instance vlm media current time */
+ int64_t i_length; /*< vlm media instance vlm media item length */
+ double d_position; /*< vlm media instance position in stream */
+ bool b_paused; /*< vlm media instance is paused */
+ int i_rate; // normal is INPUT_RATE_DEFAULT
+} vlm_media_instance_t;
- /* only for broadcast */
- vlc_bool_t b_loop;
+#if 0
+typedef struct
+{
- /* only for vod */
- vod_media_t *vod_media;
- char *psz_vod_output;
- char *psz_mux;
+} vlm_schedule_t
+#endif
- /* actual input instances */
- int i_instance;
- vlm_media_instance_t **instance;
+/** VLM events
+ * You can catch vlm event by adding a callback on the variable "intf-event"
+ * of the VLM object.
+ * This variable is an address that will hold a vlm_event_t* value.
+ */
+enum vlm_event_type_e
+{
+ /* */
+ VLM_EVENT_MEDIA_ADDED = 0x100,
+ VLM_EVENT_MEDIA_REMOVED,
+ VLM_EVENT_MEDIA_CHANGED,
+ /* */
+ VLM_EVENT_MEDIA_INSTANCE_STARTED = 0x200,
+ VLM_EVENT_MEDIA_INSTANCE_STOPPED,
+ VLM_EVENT_MEDIA_INSTANCE_STATE,
};
+typedef struct
+{
+ int i_type; /* a vlm_event_type_e value */
+ int64_t id; /* Media ID */
+ const char *psz_name; /* Media name */
+ const char *psz_instance_name; /* Instance name or NULL */
+ input_state_e input_state; /* Input instance event type */
+} vlm_event_t;
-struct vlm_schedule_t
+/** VLM control query */
+enum vlm_query_e
{
- /* names "schedule" is reserved */
- char *psz_name;
- vlc_bool_t b_enabled;
- /* list of commands to execute on date */
- int i_command;
- char **command;
+ /* --- Media control */
+ /* Get all medias */
+ VLM_GET_MEDIAS, /* arg1=vlm_media_t ***, int *pi_media */
+ /* Delete all medias */
+ VLM_CLEAR_MEDIAS, /* no arg */
- /* the date of 1st execution */
- mtime_t i_date;
+ /* Add a new media */
+ VLM_ADD_MEDIA, /* arg1=vlm_media_t* arg2=int64_t *p_id res=can fail */
+ /* Delete an existing media */
+ VLM_DEL_MEDIA, /* arg1=int64_t id */
+ /* Change properties of an existing media (all fields but id and b_vod) */
+ VLM_CHANGE_MEDIA, /* arg1=vlm_media_t* res=can fail */
+ /* Get 1 media by it's ID */
+ VLM_GET_MEDIA, /* arg1=int64_t id arg2=vlm_media_t ** */
+ /* Get media ID from its name */
+ VLM_GET_MEDIA_ID, /* arg1=const char *psz_name arg2=int64_t* */
- /* if != 0 repeat schedule every (period) */
- mtime_t i_period;
- /* number of times you have to repeat
- i_repeat < 0 : endless repeat */
- int i_repeat;
+ /* Media instance control XXX VOD control are for internal use only */
+ /* Get all media instances */
+ VLM_GET_MEDIA_INSTANCES, /* arg1=int64_t id arg2=vlm_media_instance_t *** arg3=int *pi_instance */
+ /* Delete all media instances */
+ VLM_CLEAR_MEDIA_INSTANCES, /* arg1=int64_t id */
+ /* Control broadcast instance */
+ VLM_START_MEDIA_BROADCAST_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name, int i_input_index res=can fail */
+ /* Control VOD instance */
+ VLM_START_MEDIA_VOD_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name, int i_input_index char *psz_vod_output res=can fail */
+ /* Stop an instance */
+ VLM_STOP_MEDIA_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name res=can fail */
+ /* Pause an instance */
+ VLM_PAUSE_MEDIA_INSTANCE, /* arg1=int64_t id, arg2=const char *psz_instance_name res=can fail */
+ /* Get instance position time (in microsecond) */
+ VLM_GET_MEDIA_INSTANCE_TIME, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=int64_t * */
+ /* Set instance position time (in microsecond) */
+ VLM_SET_MEDIA_INSTANCE_TIME, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=int64_t */
+ /* Get instance position ([0.0 .. 1.0]) */
+ VLM_GET_MEDIA_INSTANCE_POSITION, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=double * */
+ /* Set instance position ([0.0 .. 1.0]) */
+ VLM_SET_MEDIA_INSTANCE_POSITION, /* arg1=int64_t id, arg2=const char *psz_instance_name arg3=double */
+ /* Schedule control */
+ VLM_CLEAR_SCHEDULES, /* no arg */
+ /* TODO: missing schedule control */
+
+ /* */
};
+
+/* VLM specific - structures and functions */
+
/* ok, here is the structure of a vlm_message:
The parent node is ( name_of_the_command , NULL ), or
( name_of_the_command , message_error ) on error.
If a node has children, it should not have a value (=NULL).*/
struct vlm_message_t
{
- char *psz_name;
- char *psz_value;
+ char *psz_name; /*< message name */
+ char *psz_value; /*< message value */
- int i_child;
- vlm_message_t **child;
+ int i_child; /*< number of child messages */
+ vlm_message_t **child; /*< array of vlm_message_t */
};
-struct vlm_t
+#ifdef __cpluplus
+extern "C" {
+#endif
+
+VLC_EXPORT( vlm_t *, vlm_New, ( vlc_object_t * ) );
+#define vlm_New( a ) vlm_New( VLC_OBJECT(a) )
+VLC_EXPORT( void, vlm_Delete, ( vlm_t * ) );
+VLC_EXPORT( int, vlm_ExecuteCommand, ( vlm_t *, const char *, vlm_message_t ** ) );
+VLC_EXPORT( int, vlm_Control, ( vlm_t *p_vlm, int i_query, ... ) );
+
+VLC_EXPORT( vlm_message_t *, vlm_MessageSimpleNew, ( const char * ) );
+VLC_EXPORT( vlm_message_t *, vlm_MessageNew, ( const char *, const char *, ... ) LIBVLC_FORMAT( 2, 3 ) );
+VLC_EXPORT( vlm_message_t *, vlm_MessageAdd, ( vlm_message_t *, vlm_message_t * ) );
+VLC_EXPORT( void, vlm_MessageDelete, ( vlm_message_t * ) );
+
+/* media helpers */
+
+/**
+ * Initialize a vlm_media_t instance
+ * \param p_media vlm_media_t instance to initialize
+ */
+static inline void vlm_media_Init( vlm_media_t *p_media )
{
- VLC_COMMON_MEMBERS
+ memset( p_media, 0, sizeof(vlm_media_t) );
+ p_media->id = 0; // invalid id
+ p_media->psz_name = NULL;
+ TAB_INIT( p_media->i_input, p_media->ppsz_input );
+ TAB_INIT( p_media->i_option, p_media->ppsz_option );
+ p_media->psz_output = NULL;
+ p_media->b_vod = false;
- vlc_mutex_t lock;
+ p_media->vod.psz_mux = NULL;
+ p_media->broadcast.b_loop = false;
+}
- int i_media;
- vlm_media_t **media;
+/**
+ * Copy a vlm_media_t instance into another vlm_media_t instance
+ * \param p_dst vlm_media_t instance to copy to
+ * \param p_src vlm_media_t instance to copy from
+ */
+static inline void
+#ifndef __cplusplus
+vlm_media_Copy( vlm_media_t *restrict p_dst, const vlm_media_t *restrict p_src )
+#else
+vlm_media_Copy( vlm_media_t *p_dst, const vlm_media_t *p_src )
+#endif
+{
+ int i;
- int i_vod;
- vod_t *vod;
+ memset( p_dst, 0, sizeof(vlm_media_t) );
+ p_dst->id = p_src->id;
+ p_dst->b_enabled = p_src->b_enabled;
+ if( p_src->psz_name )
+ p_dst->psz_name = strdup( p_src->psz_name );
- int i_schedule;
- vlm_schedule_t **schedule;
-};
+ for( i = 0; i < p_src->i_input; i++ )
+ TAB_APPEND_CPP( char, p_dst->i_input, p_dst->ppsz_input, strdup(p_src->ppsz_input[i]) );
+ for( i = 0; i < p_src->i_option; i++ )
+ TAB_APPEND_CPP( char, p_dst->i_option, p_dst->ppsz_option, strdup(p_src->ppsz_option[i]) );
+
+ if( p_src->psz_output )
+ p_dst->psz_output = strdup( p_src->psz_output );
+
+ p_dst->b_vod = p_src->b_vod;
+ if( p_src->b_vod )
+ {
+ if( p_src->vod.psz_mux )
+ p_dst->vod.psz_mux = strdup( p_src->vod.psz_mux );
+ }
+ else
+ {
+ p_dst->broadcast.b_loop = p_src->broadcast.b_loop;
+ }
+}
+
+/**
+ * Cleanup and release memory associated with this vlm_media_t instance.
+ * You still need to release p_media itself with vlm_media_Delete().
+ * \param p_media vlm_media_t to cleanup
+ */
+static inline void vlm_media_Clean( vlm_media_t *p_media )
+{
+ int i;
+ free( p_media->psz_name );
+ for( i = 0; i < p_media->i_input; i++ )
+ free( p_media->ppsz_input[i]) ;
+ TAB_CLEAN(p_media->i_input, p_media->ppsz_input );
+
+ for( i = 0; i < p_media->i_option; i++ )
+ free( p_media->ppsz_option[i]) ;
+ TAB_CLEAN(p_media->i_option, p_media->ppsz_option );
+
+ free( p_media->psz_output );
+ if( p_media->b_vod )
+ free( p_media->vod.psz_mux );
+}
+
+/**
+ * Allocate a new vlm_media_t instance
+ * \return vlm_media_t instance
+ */
+static inline vlm_media_t *vlm_media_New(void)
+{
+ vlm_media_t *p_media = (vlm_media_t *)malloc( sizeof(vlm_media_t) );
+ if( p_media )
+ vlm_media_Init( p_media );
+ return p_media;
+}
+
+/**
+ * Delete a vlm_media_t instance
+ * \param p_media vlm_media_t instance to delete
+ */
+static inline void vlm_media_Delete( vlm_media_t *p_media )
+{
+ vlm_media_Clean( p_media );
+ free( p_media );
+}
+
+/**
+ * Copy a vlm_media_t instance
+ * \param p_src vlm_media_t instance to copy
+ * \return vlm_media_t duplicate of p_src
+ */
+static inline vlm_media_t *vlm_media_Duplicate( vlm_media_t *p_src )
+{
+ vlm_media_t *p_dst = vlm_media_New();
+ if( p_dst )
+ vlm_media_Copy( p_dst, p_src );
+ return p_dst;
+}
+
+/* media instance helpers */
+/**
+ * Initialize vlm_media_instance_t
+ * \param p_instance vlm_media_instance_t to initialize
+ */
+static inline void vlm_media_instance_Init( vlm_media_instance_t *p_instance )
+{
+ memset( p_instance, 0, sizeof(vlm_media_instance_t) );
+ p_instance->psz_name = NULL;
+ p_instance->i_time = 0;
+ p_instance->i_length = 0;
+ p_instance->d_position = 0.0;
+ p_instance->b_paused = false;
+ p_instance->i_rate = INPUT_RATE_DEFAULT;
+}
+
+/**
+ * Cleanup vlm_media_instance_t
+ * \param p_instance vlm_media_instance_t to cleanup
+ */
+static inline void vlm_media_instance_Clean( vlm_media_instance_t *p_instance )
+{
+ free( p_instance->psz_name );
+}
+
+/**
+ * Allocate a new vlm_media_instance_t
+ * \return a new vlm_media_instance_t
+ */
+static inline vlm_media_instance_t *vlm_media_instance_New(void)
+{
+ vlm_media_instance_t *p_instance = (vlm_media_instance_t *) malloc( sizeof(vlm_media_instance_t) );
+ if( p_instance )
+ vlm_media_instance_Init( p_instance );
+ return p_instance;
+}
+
+/**
+ * Delete a vlm_media_instance_t
+ * \param p_instance vlm_media_instance_t to delete
+ */
+static inline void vlm_media_instance_Delete( vlm_media_instance_t *p_instance )
+{
+ vlm_media_instance_Clean( p_instance );
+ free( p_instance );
+}
+
+#ifdef __cpluplus
+}
+#endif
-#define vlm_New( a ) __vlm_New( VLC_OBJECT(a) )
-VLC_EXPORT( vlm_t *, __vlm_New, ( vlc_object_t * ) );
-VLC_EXPORT( void, vlm_Delete, ( vlm_t * ) );
-VLC_EXPORT( int, vlm_ExecuteCommand, ( vlm_t *, const char *, vlm_message_t ** ) );
-VLC_EXPORT( void, vlm_MessageDelete, ( vlm_message_t * ) );
-VLC_EXPORT( vlm_media_t *, vlm_MediaNew, ( vlm_t *, const char *, int ) );
-VLC_EXPORT( void, vlm_MediaDelete, ( vlm_t *, vlm_media_t *, const char * ) );
-VLC_EXPORT( int, vlm_MediaSetup, ( vlm_t *, vlm_media_t *, const char *, const char * ) );
-VLC_EXPORT( int, vlm_MediaControl, ( vlm_t *, vlm_media_t *, const char *, const char *, const char * ) );
-VLC_EXPORT( vlm_media_t* , vlm_MediaSearch,( vlm_t *, const char *) );
-VLC_EXPORT( vlm_schedule_t *, vlm_ScheduleNew, ( vlm_t *, const char * ) );
-VLC_EXPORT( void, vlm_ScheduleDelete, ( vlm_t *, vlm_schedule_t *, const char * ) );
-VLC_EXPORT( int, vlm_ScheduleSetup, ( vlm_schedule_t *, const char *, const char * ) );
-VLC_EXPORT( int, vlm_MediaVodControl, ( void *, vod_media_t *, const char *, int, va_list ) );
-VLC_EXPORT( int, vlm_Save, ( vlm_t *, const char * ) );
-VLC_EXPORT( int, vlm_Load, ( vlm_t *, const char * ) );
+/**@}*/
#endif