1 /*****************************************************************************
2 * libvlc_audio.c: New libvlc audio control API
3 *****************************************************************************
4 * Copyright (C) 2006 VLC authors and VideoLAN
7 * Authors: Filippo Carone <filippo@carone.org>
8 * Jean-Paul Saman <jpsaman _at_ m2x _dot_ nl>
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU Lesser General Public License as published by
12 * the Free Software Foundation; either version 2.1 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU Lesser General Public License for more details.
20 * You should have received a copy of the GNU Lesser General Public License
21 * along with this program; if not, write to the Free Software Foundation,
22 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
31 #include <vlc/libvlc.h>
32 #include <vlc/libvlc_media.h>
33 #include <vlc/libvlc_media_player.h>
35 #include <vlc_common.h>
36 #include <vlc_input.h>
37 #include <vlc_aout_intf.h>
39 #include <vlc_modules.h>
41 #include "libvlc_internal.h"
42 #include "media_player_internal.h"
45 * Remember to release the returned audio_output_t since it is locked at
46 * the end of this function.
48 static audio_output_t *GetAOut( libvlc_media_player_t *mp )
52 input_thread_t *p_input = libvlc_get_input_thread( mp );
56 audio_output_t * p_aout = input_GetAout( p_input );
57 vlc_object_release( p_input );
59 libvlc_printerr( "No active audio output" );
63 /*****************************************
64 * Get the list of available audio outputs
65 *****************************************/
66 libvlc_audio_output_t *
67 libvlc_audio_output_list_get( libvlc_instance_t *p_instance )
69 VLC_UNUSED( p_instance );
70 libvlc_audio_output_t *p_list = NULL,
73 module_t **module_list = module_list_get( NULL );
75 for (size_t i = 0; module_list[i]; i++)
77 module_t *p_module = module_list[i];
79 if( module_provides( p_module, "audio output" ) )
83 p_actual = ( libvlc_audio_output_t * )
84 malloc( sizeof( libvlc_audio_output_t ) );
85 if( p_actual == NULL )
87 libvlc_printerr( "Not enough memory" );
88 libvlc_audio_output_list_release( p_list );
89 module_list_free( module_list );
95 p_previous = p_actual;
98 p_actual->psz_name = strdup( module_get_object( p_module ) );
99 p_actual->psz_description = strdup( module_get_name( p_module, true ) );
100 p_actual->p_next = NULL;
101 if( p_previous != p_actual ) /* not first item */
102 p_previous->p_next = p_actual;
103 p_previous = p_actual;
104 p_actual = p_actual->p_next;
108 module_list_free( module_list );
113 /********************************************
114 * Free the list of available audio outputs
115 ***********************************************/
116 void libvlc_audio_output_list_release( libvlc_audio_output_t *p_list )
118 libvlc_audio_output_t *p_actual, *p_before;
123 free( p_actual->psz_name );
124 free( p_actual->psz_description );
126 p_actual = p_before->p_next;
132 /***********************
133 * Set the audio output.
134 ***********************/
135 int libvlc_audio_output_set( libvlc_media_player_t *mp, const char *psz_name )
139 if( !module_exists( psz_name )
140 || asprintf( &value, "%s,none", psz_name ) == -1 )
142 var_SetString( mp, "aout", value );
147 /****************************
148 * Get count of devices.
149 *****************************/
150 int libvlc_audio_output_device_count( libvlc_instance_t *p_instance,
151 const char *psz_audio_output )
153 char *psz_config_name;
154 if( !psz_audio_output )
156 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1 )
159 module_config_t *p_module_config = config_FindConfig(
160 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name );
162 if( p_module_config && p_module_config->pf_update_list )
165 val.psz_string = strdup( p_module_config->value.psz );
167 p_module_config->pf_update_list(
168 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name, val, val, NULL );
169 free( val.psz_string );
170 free( psz_config_name );
172 return p_module_config->i_list;
175 free( psz_config_name );
179 /********************************
180 * Get long name of device
181 *********************************/
182 char * libvlc_audio_output_device_longname( libvlc_instance_t *p_instance,
183 const char *psz_audio_output,
186 char *psz_config_name;
187 if( !psz_audio_output )
189 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1 )
192 module_config_t *p_module_config = config_FindConfig(
193 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name );
195 if( p_module_config )
197 // refresh if there arent devices
198 if( p_module_config->i_list < 2 && p_module_config->pf_update_list )
201 val.psz_string = strdup( p_module_config->value.psz );
203 p_module_config->pf_update_list(
204 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name, val, val, NULL );
205 free( val.psz_string );
208 if( i_device >= 0 && i_device < p_module_config->i_list )
210 free( psz_config_name );
212 if( p_module_config->ppsz_list_text[i_device] )
213 return strdup( p_module_config->ppsz_list_text[i_device] );
215 return strdup( p_module_config->ppsz_list[i_device] );
219 free( psz_config_name );
223 /********************************
224 * Get id name of device
225 *********************************/
226 char * libvlc_audio_output_device_id( libvlc_instance_t *p_instance,
227 const char *psz_audio_output,
230 char *psz_config_name;
231 if( !psz_audio_output )
233 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1)
236 module_config_t *p_module_config = config_FindConfig(
237 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name );
239 if( p_module_config )
241 // refresh if there arent devices
242 if( p_module_config->i_list < 2 && p_module_config->pf_update_list )
245 val.psz_string = strdup( p_module_config->value.psz );
247 p_module_config->pf_update_list(
248 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name, val, val, NULL );
249 free( val.psz_string );
252 if( i_device >= 0 && i_device < p_module_config->i_list )
254 free( psz_config_name );
255 return strdup( p_module_config->ppsz_list[i_device] );
259 free( psz_config_name );
263 /*****************************
264 * Set device for using
265 *****************************/
266 void libvlc_audio_output_device_set( libvlc_media_player_t *mp,
267 const char *psz_audio_output,
268 const char *psz_device_id )
270 char *psz_config_name;
271 if( !psz_audio_output || !psz_device_id )
273 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1 )
275 if( !var_Type( mp, psz_config_name ) )
276 /* Don't recreate the same variable over and over and over... */
277 var_Create( mp, psz_config_name, VLC_VAR_STRING );
278 var_SetString( mp, psz_config_name, psz_device_id );
279 free( psz_config_name );
282 /*****************************************************************************
283 * libvlc_audio_output_get_device_type : Get the current audio device type
284 *****************************************************************************/
285 int libvlc_audio_output_get_device_type( libvlc_media_player_t *mp )
287 audio_output_t *p_aout = GetAOut( mp );
290 int i_device_type = var_GetInteger( p_aout, "audio-device" );
291 vlc_object_release( p_aout );
292 return i_device_type;
294 return libvlc_AudioOutputDevice_Error;
297 /*****************************************************************************
298 * libvlc_audio_output_set_device_type : Set the audio device type
299 *****************************************************************************/
300 void libvlc_audio_output_set_device_type( libvlc_media_player_t *mp,
303 audio_output_t *p_aout = GetAOut( mp );
306 if( var_SetInteger( p_aout, "audio-device", device_type ) < 0 )
307 libvlc_printerr( "Error setting audio device" );
308 vlc_object_release( p_aout );
311 void libvlc_audio_toggle_mute( libvlc_media_player_t *mp )
313 aout_MuteToggle( mp );
316 int libvlc_audio_get_mute( libvlc_media_player_t *mp )
318 return aout_MuteGet( mp );
321 void libvlc_audio_set_mute( libvlc_media_player_t *mp, int mute )
323 aout_MuteSet( VLC_OBJECT(mp), mute != 0 );
326 /*****************************************************************************
327 * libvlc_audio_get_volume : Get the current volume
328 *****************************************************************************/
329 int libvlc_audio_get_volume( libvlc_media_player_t *mp )
331 unsigned volume = aout_VolumeGet( mp );
333 return (volume * 100 + AOUT_VOLUME_DEFAULT / 2) / AOUT_VOLUME_DEFAULT;
337 /*****************************************************************************
338 * libvlc_audio_set_volume : Set the current volume
339 *****************************************************************************/
340 int libvlc_audio_set_volume( libvlc_media_player_t *mp, int volume )
342 volume = (volume * AOUT_VOLUME_DEFAULT + 50) / 100;
343 if (volume < 0 || volume > AOUT_VOLUME_MAX)
345 libvlc_printerr( "Volume out of range" );
348 aout_VolumeSet (mp, volume);
352 /*****************************************************************************
353 * libvlc_audio_get_track_count : Get the number of available audio tracks
354 *****************************************************************************/
355 int libvlc_audio_get_track_count( libvlc_media_player_t *p_mi )
357 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi );
360 if( !p_input_thread )
363 i_track_count = var_CountChoices( p_input_thread, "audio-es" );
365 vlc_object_release( p_input_thread );
366 return i_track_count;
369 /*****************************************************************************
370 * libvlc_audio_get_track_description : Get the description of available audio tracks
371 *****************************************************************************/
372 libvlc_track_description_t *
373 libvlc_audio_get_track_description( libvlc_media_player_t *p_mi )
375 return libvlc_get_track_description( p_mi, "audio-es" );
378 /*****************************************************************************
379 * libvlc_audio_get_track : Get the current audio track
380 *****************************************************************************/
381 int libvlc_audio_get_track( libvlc_media_player_t *p_mi )
383 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi );
384 vlc_value_t val_list;
389 if( !p_input_thread )
392 if( var_Get( p_input_thread, "audio-es", &val ) < 0 )
394 vlc_object_release( p_input_thread );
395 libvlc_printerr( "Audio track information not found" );
399 var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
400 for( i = 0; i < val_list.p_list->i_count; i++ )
402 if( val_list.p_list->p_values[i].i_int == val.i_int )
408 var_FreeList( &val_list, NULL );
409 vlc_object_release( p_input_thread );
413 /*****************************************************************************
414 * libvlc_audio_set_track : Set the current audio track
415 *****************************************************************************/
416 int libvlc_audio_set_track( libvlc_media_player_t *p_mi, int i_track )
418 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi );
419 vlc_value_t val_list;
423 if( !p_input_thread )
426 var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
427 if( (i_track < 0) || (i_track > val_list.p_list->i_count) )
429 libvlc_printerr( "Audio track out of range" );
434 newval = val_list.p_list->p_values[i_track];
435 i_ret = var_Set( p_input_thread, "audio-es", newval );
438 libvlc_printerr( "Audio track out of range" ); /* Race... */
445 var_FreeList( &val_list, NULL );
446 vlc_object_release( p_input_thread );
450 /*****************************************************************************
451 * libvlc_audio_get_channel : Get the current audio channel
452 *****************************************************************************/
453 int libvlc_audio_get_channel( libvlc_media_player_t *mp )
455 audio_output_t *p_aout = GetAOut( mp );
459 int val = var_GetInteger( p_aout, "audio-channels" );
460 vlc_object_release( p_aout );
464 /*****************************************************************************
465 * libvlc_audio_set_channel : Set the current audio channel
466 *****************************************************************************/
467 int libvlc_audio_set_channel( libvlc_media_player_t *mp, int channel )
469 audio_output_t *p_aout = GetAOut( mp );
475 if( var_SetInteger( p_aout, "audio-channels", channel ) < 0 )
477 libvlc_printerr( "Audio channel out of range" );
480 vlc_object_release( p_aout );
484 /*****************************************************************************
485 * libvlc_audio_get_delay : Get the current audio delay
486 *****************************************************************************/
487 int64_t libvlc_audio_get_delay( libvlc_media_player_t *p_mi )
489 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
491 if( p_input_thread != NULL )
493 val = var_GetTime( p_input_thread, "audio-delay" );
494 vlc_object_release( p_input_thread );
499 /*****************************************************************************
500 * libvlc_audio_set_delay : Set the current audio delay
501 *****************************************************************************/
502 int libvlc_audio_set_delay( libvlc_media_player_t *p_mi, int64_t i_delay )
504 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
506 if( p_input_thread != NULL )
508 var_SetTime( p_input_thread, "audio-delay", i_delay );
509 vlc_object_release( p_input_thread );