git.sesse.net Git - vlc/blob - lib/vlm.c

   1 /*****************************************************************************
   2  * vlm.c: libvlc new API VLM handling functions
   3  *****************************************************************************
   4  * Copyright (C) 2005 VLC authors and VideoLAN
   5  * $Id$
   6  *
   7  * Authors: Clément Stenac <zorglub@videolan.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify it
  10  * under the terms of the GNU Lesser General Public License as published by
  11  * the Free Software Foundation; either version 2.1 of the License, or
  12  * (at your option) any later version.
  13  *
  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 Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public License
  20  * along with this program; if not, write to the Free Software Foundation,
  21  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 #ifdef HAVE_CONFIG_H
  25 # include <config.h>
  26 #endif
  27
  28 #include <vlc/libvlc.h>
  29 #include <vlc/libvlc_vlm.h>
  30 #include <vlc_es.h>
  31 #include <vlc_input.h>
  32 #include <vlc_vlm.h>
  33 #include <assert.h>
  34
  35 #include "libvlc_internal.h"
  36
  37 /* VLM events callback. Transmit to libvlc */
  38 static int VlmEvent( vlc_object_t *p_this, const char * name,
  39                      vlc_value_t old_val, vlc_value_t newval, void *param )
  40 {
  41     VLC_UNUSED(p_this);
  42     VLC_UNUSED(name);
  43     VLC_UNUSED(old_val);
  44     vlm_event_t *event = (vlm_event_t*)newval.p_address;
  45     libvlc_event_manager_t *p_event_manager = (libvlc_event_manager_t *) param;
  46     libvlc_event_t libvlc_event;
  47
  48     libvlc_event.u.vlm_media_event.psz_instance_name = NULL;
  49     libvlc_event.u.vlm_media_event.psz_media_name = event->psz_name;
  50
  51     switch( event->i_type )
  52     {
  53     case VLM_EVENT_MEDIA_ADDED:
  54         libvlc_event.type = libvlc_VlmMediaAdded;
  55         break;
  56     case VLM_EVENT_MEDIA_REMOVED:
  57         libvlc_event.type = libvlc_VlmMediaRemoved;
  58         break;
  59     case VLM_EVENT_MEDIA_CHANGED:
  60         libvlc_event.type = libvlc_VlmMediaChanged;
  61         break;
  62     case VLM_EVENT_MEDIA_INSTANCE_STARTED:
  63         libvlc_event.type = libvlc_VlmMediaInstanceStarted;
  64         break;
  65     case VLM_EVENT_MEDIA_INSTANCE_STOPPED:
  66         libvlc_event.type = libvlc_VlmMediaInstanceStopped;
  67         break;
  68     case VLM_EVENT_MEDIA_INSTANCE_STATE:
  69         libvlc_event.u.vlm_media_event.psz_instance_name =
  70             event->psz_instance_name;
  71         switch( event->input_state )
  72         {
  73         case INIT_S:
  74             libvlc_event.type = libvlc_VlmMediaInstanceStatusInit;
  75             break;
  76         case OPENING_S:
  77             libvlc_event.type =
  78                 libvlc_VlmMediaInstanceStatusOpening;
  79             break;
  80         case PLAYING_S:
  81             libvlc_event.type =
  82                 libvlc_VlmMediaInstanceStatusPlaying;
  83             break;
  84         case PAUSE_S:
  85             libvlc_event.type = libvlc_VlmMediaInstanceStatusPause;
  86             break;
  87         case END_S:
  88             libvlc_event.type = libvlc_VlmMediaInstanceStatusEnd;
  89             break;
  90         case ERROR_S:
  91             libvlc_event.type = libvlc_VlmMediaInstanceStatusError;
  92             break;
  93         default:
  94             return 0;
  95         }
  96         break;
  97     default:
  98         return 0;
  99     }
 100     libvlc_event_send( p_event_manager, &libvlc_event );
 101     return 0;
 102 }
 103
 104 static void libvlc_vlm_release_internal( libvlc_instance_t *p_instance )
 105 {
 106     vlm_t *p_vlm = p_instance->libvlc_vlm.p_vlm;
 107     if( !p_instance->libvlc_vlm.p_vlm )
 108         return;
 109     /* We need to remove medias in order to receive events */
 110     vlm_Control( p_vlm, VLM_CLEAR_MEDIAS );
 111     vlm_Control( p_vlm, VLM_CLEAR_SCHEDULES );
 112
 113     var_DelCallback( (vlc_object_t *)p_vlm, "intf-event", VlmEvent,
 114                      p_instance->libvlc_vlm.p_event_manager );
 115     p_instance->libvlc_vlm.pf_release = NULL;
 116     libvlc_event_manager_release( p_instance->libvlc_vlm.p_event_manager );
 117     p_instance->libvlc_vlm.p_event_manager = NULL;
 118     vlm_Delete( p_vlm );
 119     p_instance->libvlc_vlm.p_vlm = NULL;
 120 }
 121
 122 static int libvlc_vlm_init( libvlc_instance_t *p_instance )
 123 {
 124     if( !p_instance->libvlc_vlm.p_event_manager )
 125     {
 126         p_instance->libvlc_vlm.p_event_manager =
 127             libvlc_event_manager_new( p_instance->libvlc_vlm.p_vlm, p_instance );
 128         if( unlikely(p_instance->libvlc_vlm.p_event_manager == NULL) )
 129             return VLC_ENOMEM;
 130         libvlc_event_manager_register_event_type(
 131             p_instance->libvlc_vlm.p_event_manager,
 132             libvlc_VlmMediaAdded );
 133         libvlc_event_manager_register_event_type(
 134             p_instance->libvlc_vlm.p_event_manager,
 135             libvlc_VlmMediaRemoved );
 136         libvlc_event_manager_register_event_type(
 137             p_instance->libvlc_vlm.p_event_manager,
 138             libvlc_VlmMediaChanged );
 139         libvlc_event_manager_register_event_type(
 140             p_instance->libvlc_vlm.p_event_manager,
 141             libvlc_VlmMediaInstanceStarted );
 142         libvlc_event_manager_register_event_type(
 143             p_instance->libvlc_vlm.p_event_manager,
 144             libvlc_VlmMediaInstanceStopped );
 145         libvlc_event_manager_register_event_type(
 146             p_instance->libvlc_vlm.p_event_manager,
 147             libvlc_VlmMediaInstanceStatusInit );
 148         libvlc_event_manager_register_event_type(
 149             p_instance->libvlc_vlm.p_event_manager,
 150             libvlc_VlmMediaInstanceStatusOpening );
 151         libvlc_event_manager_register_event_type(
 152             p_instance->libvlc_vlm.p_event_manager,
 153             libvlc_VlmMediaInstanceStatusPlaying );
 154         libvlc_event_manager_register_event_type(
 155             p_instance->libvlc_vlm.p_event_manager,
 156             libvlc_VlmMediaInstanceStatusPause );
 157         libvlc_event_manager_register_event_type(
 158             p_instance->libvlc_vlm.p_event_manager,
 159             libvlc_VlmMediaInstanceStatusEnd );
 160         libvlc_event_manager_register_event_type(
 161             p_instance->libvlc_vlm.p_event_manager,
 162             libvlc_VlmMediaInstanceStatusError );
 163     }
 164
 165     if( !p_instance->libvlc_vlm.p_vlm )
 166     {
 167         p_instance->libvlc_vlm.p_vlm = vlm_New( p_instance->p_libvlc_int );
 168         if( !p_instance->libvlc_vlm.p_vlm )
 169         {
 170             libvlc_printerr( "VLM not supported or out of memory" );
 171             return VLC_EGENERIC;
 172         }
 173         var_AddCallback( (vlc_object_t *)p_instance->libvlc_vlm.p_vlm,
 174                          "intf-event", VlmEvent,
 175                          p_instance->libvlc_vlm.p_event_manager );
 176         p_instance->libvlc_vlm.pf_release = libvlc_vlm_release_internal;
 177     }
 178
 179     return VLC_SUCCESS;
 180 }
 181
 182 void libvlc_vlm_release( libvlc_instance_t *p_instance )
 183 {
 184     libvlc_vlm_release_internal( p_instance );
 185 }
 186
 187 #define VLM_RET(p,ret) do { \
 188     if( libvlc_vlm_init( p_instance ) ) \
 189         return (ret); \
 190     (p) = p_instance->libvlc_vlm.p_vlm; \
 191   } while(0)
 192
 193 static vlm_media_instance_t *
 194 libvlc_vlm_get_media_instance( libvlc_instance_t *p_instance,
 195                                const char *psz_name, int i_minstance_idx )
 196 {
 197     vlm_t *p_vlm;
 198     vlm_media_instance_t **pp_minstance;
 199     vlm_media_instance_t *p_minstance;
 200     int i_minstance;
 201     int64_t id;
 202
 203     VLM_RET(p_vlm, NULL);
 204
 205     if( vlm_Control( p_vlm, VLM_GET_MEDIA_ID, psz_name, &id ) ||
 206         vlm_Control( p_vlm, VLM_GET_MEDIA_INSTANCES, id, &pp_minstance,
 207                      &i_minstance ) )
 208     {
 209         libvlc_printerr( "%s: media instances not found", psz_name );
 210         return NULL;
 211     }
 212     p_minstance = NULL;
 213     if( i_minstance_idx >= 0 && i_minstance_idx < i_minstance )
 214     {
 215         p_minstance = pp_minstance[i_minstance_idx];
 216         TAB_REMOVE( i_minstance, pp_minstance, p_minstance );
 217     }
 218     while( i_minstance > 0 )
 219         vlm_media_instance_Delete( pp_minstance[--i_minstance] );
 220     TAB_CLEAN( i_minstance, pp_minstance );
 221     return p_minstance;
 222 }
 223
 224 /* local function to be used in libvlc_vlm_show_media only */
 225 static char* recurse_answer( vlm_message_t *p_answer, const char* psz_delim,
 226                              const int i_list ) {
 227     char* psz_childdelim = NULL;
 228     char* psz_nametag = NULL;
 229     char* psz_response = strdup( "" );
 230     char *psz_tmp;
 231     int i_success = 0;
 232     int i;
 233     vlm_message_t *aw_child, **paw_child;
 234
 235     i_success = asprintf( &psz_childdelim, "%s\t", psz_delim);
 236     if( i_success == -1 )
 237         return psz_response;
 238
 239     paw_child = p_answer->child;
 240     aw_child = *( paw_child );
 241     /* Iterate over children */
 242     for( i = 0; i < p_answer->i_child; i++ )
 243     {
 244         /* Spare comma if it is the last element */
 245         char c_comma = ',';
 246         if( i == (p_answer->i_child - 1) )
 247             c_comma = ' ';
 248
 249         /* Append name of child node, if not in a list */
 250         if( !i_list )
 251         {
 252             i_success = asprintf( &psz_tmp, "%s\"%s\": ",
 253                           psz_response, aw_child->psz_name );
 254             if( i_success == -1 ) break;
 255             free( psz_response );
 256             psz_response = psz_tmp;
 257         }
 258
 259         /* If child node has children, */
 260         if( aw_child->i_child )
 261         {
 262             /* If the parent node is a list (hence the child node is
 263              * inside a list), create a property of its name as if it
 264              * had a name value node
 265              */
 266             if( i_list )
 267             {
 268                 i_success = asprintf( &psz_nametag, "\"name\": \"%s\",%s",
 269                               aw_child->psz_name, psz_childdelim );
 270                 if( i_success == -1 ) break;
 271             }
 272             else
 273             {
 274                 psz_nametag = strdup( "" );
 275             }
 276             /* If the child is a list itself, format it accordingly and
 277              * recurse through the child's children, telling them that
 278              * they are inside a list.
 279              */
 280             if( strcmp( aw_child->psz_name, "media" ) == 0 ||
 281                 strcmp( aw_child->psz_name, "inputs" ) == 0 ||
 282                 strcmp( aw_child->psz_name, "options" ) == 0 )
 283             {
 284                 char *psz_recurse = recurse_answer( aw_child, psz_childdelim, 1 ),
 285                 i_success = asprintf( &psz_tmp, "%s[%s%s%s]%c%s",
 286                                       psz_response, psz_childdelim, psz_recurse,
 287                                       psz_delim, c_comma, psz_delim );
 288                 free( psz_recurse );
 289                 if( i_success == -1 ) break;
 290                 free( psz_response );
 291                 psz_response = psz_tmp;
 292             }
 293             /* Not a list, so format the child as a JSON object and
 294              * recurse through the child's children
 295              */
 296             else
 297             {
 298                 char *psz_recurse = recurse_answer( aw_child, psz_childdelim, 0 ),
 299                 i_success = asprintf( &psz_tmp, "%s{%s%s%s%s}%c%s",
 300                                       psz_response, psz_childdelim, psz_nametag,
 301                                       psz_recurse, psz_delim, c_comma, psz_delim );
 302                 free( psz_recurse );
 303                 if( i_success == -1 ) break;
 304                 free( psz_response );
 305                 psz_response = psz_tmp;
 306             }
 307         }
 308         /* Otherwise - when no children are present - the node is a
 309          * value node. So print the value string
 310          */
 311         else
 312         {
 313             /* If value is equivalent to NULL, print it as null */
 314             if( aw_child->psz_value == NULL
 315                 || strcmp( aw_child->psz_value, "(null)" ) == 0 )
 316             {
 317                 i_success = asprintf( &psz_tmp, "%snull%c%s",
 318                                       psz_response, c_comma, psz_delim );
 319                 if( i_success == -1 ) break;
 320                 free( psz_response );
 321                 psz_response = psz_tmp;
 322             }
 323             /* Otherwise print the value in quotation marks */
 324             else
 325             {
 326                 i_success = asprintf( &psz_tmp, "%s\"%s\"%c%s",
 327                                       psz_response, aw_child->psz_value,
 328                                       c_comma, psz_delim );
 329                 if( i_success == -1 ) break;
 330                 free( psz_response );
 331                 psz_response = psz_tmp;
 332             }
 333         }
 334         /* getting next child */
 335         paw_child++;
 336         aw_child = *( paw_child );
 337     }
 338     free( psz_nametag );
 339     free( psz_childdelim );
 340     if( i_success == -1 )
 341     {
 342         free( psz_response );
 343         psz_response = strdup( "" );
 344     }
 345     return psz_response;
 346 }
 347
 348 const char* libvlc_vlm_show_media( libvlc_instance_t *p_instance,
 349                                    const char *psz_name )
 350 {
 351     char *psz_message = NULL;
 352     vlm_message_t *answer = NULL;
 353     char *psz_response = NULL;
 354     const char *psz_fmt = NULL;
 355     const char *psz_delimiter = NULL;
 356     int i_list;
 357     vlm_t *p_vlm = NULL;
 358
 359     VLM_RET(p_vlm, NULL);
 360
 361     assert( psz_name );
 362
 363     if( asprintf( &psz_message, "show %s", psz_name ) == -1 )
 364         return NULL;
 365
 366     vlm_ExecuteCommand( p_vlm, psz_message, &answer );
 367     if( answer->psz_value )
 368     {
 369         libvlc_printerr( "Unable to call show %s: %s",
 370                          psz_name, answer->psz_value );
 371     }
 372     else if ( answer->child )
 373     {   /* in case everything was requested  */
 374         if ( strcmp( psz_name, "" ) == 0 )
 375         {
 376             psz_fmt = "{\n\t%s\n}\n";
 377             psz_delimiter = "\n\t";
 378             i_list = 0;
 379         }
 380         else
 381         {
 382             psz_fmt = "%s\n";
 383             psz_delimiter = "\n";
 384             i_list = 1;
 385         }
 386         char *psz_tmp = recurse_answer( answer, psz_delimiter, i_list );
 387         if( asprintf( &psz_response, psz_fmt, psz_tmp ) == -1 )
 388         {
 389             libvlc_printerr( "Out of memory" );
 390             psz_response = NULL;
 391         }
 392         free( psz_tmp );
 393     }
 394     free( psz_message );
 395     return( psz_response );
 396 }
 397
 398
 399 int libvlc_vlm_add_broadcast( libvlc_instance_t *p_instance,
 400                               const char *psz_name,
 401                               const char *psz_input,
 402                               const char *psz_output, int i_options,
 403                               const char * const *ppsz_options,
 404                               int b_enabled, int b_loop )
 405 {
 406     vlm_t *p_vlm;
 407     vlm_media_t m;
 408     int n;
 409
 410     VLM_RET(p_vlm, -1);
 411
 412     vlm_media_Init( &m );
 413     m.psz_name = strdup( psz_name );
 414     m.b_enabled = b_enabled;
 415     m.b_vod = false;
 416     m.broadcast.b_loop = b_loop;
 417     if( psz_input )
 418         TAB_APPEND( m.i_input, m.ppsz_input, strdup(psz_input) );
 419     if( psz_output )
 420         m.psz_output = strdup( psz_output );
 421     for( n = 0; n < i_options; n++ )
 422         TAB_APPEND( m.i_option, m.ppsz_option, strdup(ppsz_options[n]) );
 423
 424     n = vlm_Control( p_vlm, VLM_ADD_MEDIA, &m, NULL );
 425     vlm_media_Clean( &m );
 426     if( n )
 427     {
 428         libvlc_printerr( "Media %s creation failed", psz_name );
 429         return -1;
 430     }
 431     return 0;
 432 }
 433
 434 int libvlc_vlm_add_vod( libvlc_instance_t *p_instance, const char *psz_name,
 435                         const char *psz_input, int i_options,
 436                         const char * const *ppsz_options, int b_enabled,
 437                         const char *psz_mux )
 438 {
 439     vlm_t *p_vlm;
 440     vlm_media_t m;
 441     int n;
 442
 443     VLM_RET(p_vlm, -1);
 444
 445     vlm_media_Init( &m );
 446     m.psz_name = strdup( psz_name );
 447     m.b_enabled = b_enabled;
 448     m.b_vod = true;
 449     m.vod.psz_mux = psz_mux ? strdup( psz_mux ) : NULL;
 450     if( psz_input )
 451         TAB_APPEND( m.i_input, m.ppsz_input, strdup(psz_input) );
 452     for( n = 0; n < i_options; n++ )
 453         TAB_APPEND( m.i_option, m.ppsz_option, strdup(ppsz_options[n]) );
 454
 455     n = vlm_Control( p_vlm, VLM_ADD_MEDIA, &m, NULL );
 456     vlm_media_Clean( &m );
 457     if( n )
 458     {
 459         libvlc_printerr( "Media %s creation failed", psz_name );
 460         return -1;
 461     }
 462     return 0;
 463 }
 464
 465 int libvlc_vlm_del_media( libvlc_instance_t *p_instance, const char *psz_name )
 466 {
 467     vlm_t *p_vlm;
 468     int64_t id;
 469
 470     VLM_RET(p_vlm, -1);
 471
 472     if( vlm_Control( p_vlm, VLM_GET_MEDIA_ID, psz_name, &id ) ||
 473         vlm_Control( p_vlm, VLM_DEL_MEDIA, id ) )
 474     {
 475         libvlc_printerr( "Unable to delete %s", psz_name );
 476         return -1;
 477     }
 478     return 0;
 479 }
 480
 481 static vlm_media_t *get_media( libvlc_instance_t *p_instance,
 482                                vlm_t **restrict pp_vlm, const char *name )
 483 {
 484     vlm_media_t *p_media;
 485     vlm_t *p_vlm;
 486     int64_t id;
 487
 488     VLM_RET(p_vlm, NULL);
 489     if( vlm_Control( p_vlm, VLM_GET_MEDIA_ID, name, &id ) ||
 490         vlm_Control( p_vlm, VLM_GET_MEDIA, id, &p_media ) )
 491         return NULL;
 492     *pp_vlm = p_vlm;
 493     return p_media;
 494 }
 495
 496 #define VLM_CHANGE(psz_error, code ) do {   \
 497     vlm_t *p_vlm;           \
 498     vlm_media_t *p_media = get_media( p_instance, &p_vlm, psz_name ); \
 499     if( p_media != NULL ) { \
 500         code;               \
 501         if( vlm_Control( p_vlm, VLM_CHANGE_MEDIA, p_media ) )       \
 502             p_vlm = NULL;                                           \
 503         vlm_media_Delete( p_media );                                \
 504         if( p_vlm != NULL ) \
 505             return 0;       \
 506     }                       \
 507     libvlc_printerr( psz_error, psz_name );                         \
 508     return -1;              \
 509   } while(0)
 510
 511 int libvlc_vlm_set_enabled( libvlc_instance_t *p_instance,
 512                             const char *psz_name, int b_enabled )
 513 {
 514 #define VLM_CHANGE_CODE { p_media->b_enabled = b_enabled; }
 515     VLM_CHANGE( "Unable to delete %s", VLM_CHANGE_CODE );
 516 #undef VLM_CHANGE_CODE
 517 }
 518
 519 int libvlc_vlm_set_loop( libvlc_instance_t *p_instance, const char *psz_name,
 520                          int b_loop )
 521 {
 522 #define VLM_CHANGE_CODE { p_media->broadcast.b_loop = b_loop; }
 523     VLM_CHANGE( "Unable to change %s loop property", VLM_CHANGE_CODE );
 524 #undef VLM_CHANGE_CODE
 525 }
 526
 527 int libvlc_vlm_set_mux( libvlc_instance_t *p_instance, const char *psz_name,
 528                         const char *psz_mux )
 529 {
 530 #define VLM_CHANGE_CODE { if( p_media->b_vod ) { \
 531                             free( p_media->vod.psz_mux ); \
 532                             p_media->vod.psz_mux = psz_mux \
 533                                  ? strdup( psz_mux ) : NULL; \
 534                           } }
 535     VLM_CHANGE( "Unable to change %s mux property", VLM_CHANGE_CODE );
 536 #undef VLM_CHANGE_CODE
 537 }
 538
 539 int libvlc_vlm_set_output( libvlc_instance_t *p_instance,
 540                            const char *psz_name, const char *psz_output )
 541 {
 542 #define VLM_CHANGE_CODE { free( p_media->psz_output ); \
 543                           p_media->psz_output = strdup( psz_output ); }
 544     VLM_CHANGE( "Unable to change %s output property", VLM_CHANGE_CODE );
 545 #undef VLM_CHANGE_CODE
 546 }
 547
 548 int libvlc_vlm_set_input( libvlc_instance_t *p_instance,
 549                           const char *psz_name, const char *psz_input )
 550 {
 551 #define VLM_CHANGE_CODE { while( p_media->i_input > 0 ) \
 552                             free( p_media->ppsz_input[--p_media->i_input] );\
 553                           TAB_APPEND( p_media->i_input, p_media->ppsz_input, \
 554                                       strdup(psz_input) ); }
 555     VLM_CHANGE( "Unable to change %s input property", VLM_CHANGE_CODE );
 556 #undef VLM_CHANGE_CODE
 557 }
 558
 559 int libvlc_vlm_add_input( libvlc_instance_t *p_instance,
 560                           const char *psz_name, const char *psz_input )
 561 {
 562 #define VLM_CHANGE_CODE { TAB_APPEND( p_media->i_input, p_media->ppsz_input, \
 563                           strdup(psz_input) ); }
 564     VLM_CHANGE( "Unable to change %s input property", VLM_CHANGE_CODE );
 565 #undef VLM_CHANGE_CODE
 566 }
 567
 568 int libvlc_vlm_change_media( libvlc_instance_t *p_instance,
 569                              const char *psz_name, const char *psz_input,
 570                              const char *psz_output, int i_options,
 571                              const char * const *ppsz_options, int b_enabled,
 572                              int b_loop )
 573 {
 574 #define VLM_CHANGE_CODE { int n;        \
 575     p_media->b_enabled = b_enabled;     \
 576     p_media->broadcast.b_loop = b_loop; \
 577     while( p_media->i_input > 0 )       \
 578         free( p_media->ppsz_input[--p_media->i_input] );    \
 579     if( psz_input )                     \
 580         TAB_APPEND( p_media->i_input, p_media->ppsz_input, strdup(psz_input) ); \
 581     free( p_media->psz_output );        \
 582     p_media->psz_output = psz_output ? strdup( psz_output ) : NULL; \
 583     while( p_media->i_option > 0 )     \
 584         free( p_media->ppsz_option[--p_media->i_option] );        \
 585     for( n = 0; n < i_options; n++ )    \
 586         TAB_APPEND( p_media->i_option, p_media->ppsz_option, \
 587                     strdup(ppsz_options[n]) );   \
 588   }
 589     VLM_CHANGE( "Unable to change %s properties", VLM_CHANGE_CODE );
 590 #undef VLM_CHANGE_CODE
 591 }
 592
 593 int libvlc_vlm_play_media( libvlc_instance_t *p_instance,
 594                            const char *psz_name )
 595 {
 596     vlm_t *p_vlm;
 597     int64_t id;
 598
 599     VLM_RET(p_vlm, -1);
 600
 601     if( vlm_Control( p_vlm, VLM_GET_MEDIA_ID, psz_name, &id ) ||
 602         vlm_Control( p_vlm, VLM_START_MEDIA_BROADCAST_INSTANCE, id, NULL, 0 ) )
 603     {
 604         libvlc_printerr( "Unable to play %s", psz_name );
 605         return -1;
 606     }
 607     return 0;
 608 }
 609
 610 int libvlc_vlm_stop_media( libvlc_instance_t *p_instance,
 611                            const char *psz_name )
 612 {
 613     vlm_t *p_vlm;
 614     int64_t id;
 615
 616     VLM_RET(p_vlm, -1);
 617
 618     if( vlm_Control( p_vlm, VLM_GET_MEDIA_ID, psz_name, &id ) ||
 619         vlm_Control( p_vlm, VLM_STOP_MEDIA_INSTANCE, id, NULL ) )
 620     {
 621         libvlc_printerr( "Unable to stop %s", psz_name );
 622         return -1;
 623     }
 624     return 0;
 625 }
 626
 627 int libvlc_vlm_pause_media( libvlc_instance_t *p_instance,
 628                             const char *psz_name )
 629 {
 630     vlm_t *p_vlm;
 631     int64_t id;
 632
 633     VLM_RET(p_vlm, -1);
 634
 635     if( vlm_Control( p_vlm, VLM_GET_MEDIA_ID, psz_name, &id ) ||
 636         vlm_Control( p_vlm, VLM_PAUSE_MEDIA_INSTANCE, id, NULL ) )
 637     {
 638         libvlc_printerr( "Unable to pause %s", psz_name );
 639         return -1;
 640     }
 641     return 0;
 642 }
 643
 644 int libvlc_vlm_seek_media( libvlc_instance_t *p_instance,
 645                            const char *psz_name, float f_percentage )
 646 {
 647     vlm_t *p_vlm;
 648     int64_t id;
 649
 650     VLM_RET(p_vlm, -1);
 651
 652     if( vlm_Control( p_vlm, VLM_GET_MEDIA_ID, psz_name, &id ) ||
 653         vlm_Control( p_vlm, VLM_SET_MEDIA_INSTANCE_POSITION, id, NULL,
 654                      f_percentage ) )
 655     {
 656         libvlc_printerr( "Unable to seek %s to %f%%", psz_name, f_percentage );
 657         return -1;
 658     }
 659     return 0;
 660 }
 661
 662 float libvlc_vlm_get_media_instance_position( libvlc_instance_t *p_instance,
 663                                               const char *psz_name,
 664                                               int i_instance )
 665 {
 666     vlm_media_instance_t *p_mi;
 667     float result = -1.;
 668
 669     p_mi = libvlc_vlm_get_media_instance( p_instance, psz_name, i_instance );
 670     if( p_mi )
 671     {
 672         result = p_mi->d_position;
 673         vlm_media_instance_Delete( p_mi );
 674     }
 675     return result;
 676 }
 677
 678 int libvlc_vlm_get_media_instance_time( libvlc_instance_t *p_instance,
 679                                         const char *psz_name, int i_instance )
 680 {
 681     vlm_media_instance_t *p_mi;
 682     int result = -1;
 683
 684     p_mi = libvlc_vlm_get_media_instance( p_instance, psz_name, i_instance );
 685     if( p_mi )
 686     {
 687         result = p_mi->i_time;
 688         vlm_media_instance_Delete( p_mi );
 689     }
 690     return result;
 691 }
 692
 693 int libvlc_vlm_get_media_instance_length( libvlc_instance_t *p_instance,
 694                                           const char *psz_name,
 695                                           int i_instance )
 696 {
 697     vlm_media_instance_t *p_mi;
 698     int result = -1;
 699
 700     p_mi = libvlc_vlm_get_media_instance( p_instance, psz_name, i_instance );
 701     if( p_mi )
 702     {
 703         result = p_mi->i_length;
 704         vlm_media_instance_Delete( p_mi );
 705     }
 706     return result;
 707 }
 708
 709 int libvlc_vlm_get_media_instance_rate( libvlc_instance_t *p_instance,
 710                                         const char *psz_name, int i_instance )
 711 {
 712     vlm_media_instance_t *p_mi;
 713     int result = -1;
 714
 715     p_mi = libvlc_vlm_get_media_instance( p_instance, psz_name, i_instance );
 716     if( p_mi )
 717     {
 718         result = p_mi->i_rate;
 719         vlm_media_instance_Delete( p_mi );
 720     }
 721     return result;
 722 }
 723
 724 #if 0
 725 int libvlc_vlm_get_media_instance_title( libvlc_instance_t *p_instance,
 726                                          const char *psz_name, int i_instance )
 727 {
 728     vlm_media_instance_t *p_mi;
 729
 730     p_mi = libvlc_vlm_get_media_instance( p_instance, psz_name, i_instance );
 731     if( p_mi )
 732         vlm_media_instance_Delete( p_mi );
 733     return p_mi ? 0 : -1;
 734 }
 735
 736 int libvlc_vlm_get_media_instance_chapter( libvlc_instance_t *p_instance,
 737                                            const char *psz_name,
 738                                            int i_instance )
 739 {
 740     vlm_media_instance_t *p_mi;
 741
 742     p_mi = libvlc_vlm_get_media_instance( p_instance, psz_name,
 743                                           i_instance );
 744     if( p_mi )
 745         vlm_media_instance_Delete( p_mi );
 746     return p_mi ? 0 : -1;
 747 }
 748
 749 int libvlc_vlm_get_media_instance_seekable( libvlc_instance_t *p_instance,
 750                                             const char *psz_name,
 751                                             int i_instance )
 752 {
 753     vlm_media_instance_t *p_mi;
 754
 755     p_mi = libvlc_vlm_get_media_instance( p_instance, psz_name, i_instance );
 756     if( p_mi )
 757         vlm_media_instance_Delete( p_mi );
 758     return p_mi ? 0 : -1;
 759 }
 760 #endif
 761
 762 libvlc_event_manager_t *
 763 libvlc_vlm_get_event_manager( libvlc_instance_t *p_instance )
 764 {
 765     vlm_t *p_vlm;
 766     VLM_RET( p_vlm, NULL);
 767     return p_instance->libvlc_vlm.p_event_manager;
 768 }