1 /*****************************************************************************
2 * standard.c: standard stream output module
3 *****************************************************************************
4 * Copyright (C) 2003-2011 VLC authors and VideoLAN
7 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
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.
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.
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 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
31 #include <vlc_common.h>
32 #include <vlc_plugin.h>
35 #include <vlc_network.h>
38 /*****************************************************************************
40 *****************************************************************************/
41 #define ACCESS_TEXT N_("Output access method")
42 #define ACCESS_LONGTEXT N_( \
43 "Output method to use for the stream." )
44 #define MUX_TEXT N_("Output muxer")
45 #define MUX_LONGTEXT N_( \
46 "Muxer to use for the stream." )
47 #define DEST_TEXT N_("Output destination")
48 #define DEST_LONGTEXT N_( \
49 "Destination (URL) to use for the stream. Overrides path and bind parameters" )
50 #define BIND_TEXT N_("address to bind to (helper setting for dst)")
51 #define BIND_LONGTEXT N_( \
52 "address:port to bind vlc to listening incoming streams "\
53 "helper setting for dst,dst=bind+'/'+path. dst-parameter overrides this" )
54 #define PATH_TEXT N_("filename for stream (helper setting for dst)")
55 #define PATH_LONGTEXT N_( \
56 "Filename for stream "\
57 "helper setting for dst, dst=bind+'/'+path, dst-parameter overrides this" )
58 #define NAME_TEXT N_("Session name")
59 #define NAME_LONGTEXT N_( \
60 "This is the name of the session that will be announced in the SDP " \
61 "(Session Descriptor)." )
62 #define DESC_TEXT N_("Session description")
63 #define DESC_LONGTEXT N_( \
64 "This allows you to give a short description with details about the stream, " \
65 "that will be announced in the SDP (Session Descriptor)." )
66 #define URL_TEXT N_("Session URL")
67 #define URL_LONGTEXT N_( \
68 "This allows you to give a URL with more details about the stream " \
69 "(often the website of the streaming organization), that will " \
70 "be announced in the SDP (Session Descriptor)." )
71 #define EMAIL_TEXT N_("Session email")
72 #define EMAIL_LONGTEXT N_( \
73 "This allows you to give a contact mail address for the stream, that will " \
74 "be announced in the SDP (Session Descriptor)." )
75 #define PHONE_TEXT N_("Session phone number")
76 #define PHONE_LONGTEXT N_( \
77 "This allows you to give a contact telephone number for the stream, that will " \
78 "be announced in the SDP (Session Descriptor)." )
81 #define SAP_TEXT N_("SAP announcing")
82 #define SAP_LONGTEXT N_("Announce this session with SAP.")
84 static int Open ( vlc_object_t
* );
85 static void Close ( vlc_object_t
* );
87 #define SOUT_CFG_PREFIX "sout-standard-"
90 set_shortname( N_("Standard"))
91 set_description( N_("Standard stream output") )
92 set_capability( "sout stream", 50 )
93 add_shortcut( "standard", "std", "file", "http", "udp" )
94 set_category( CAT_SOUT
)
95 set_subcategory( SUBCAT_SOUT_STREAM
)
97 add_string( SOUT_CFG_PREFIX
"access", "", ACCESS_TEXT
, ACCESS_LONGTEXT
, false )
98 add_string( SOUT_CFG_PREFIX
"mux", "", MUX_TEXT
, MUX_LONGTEXT
, false )
99 add_string( SOUT_CFG_PREFIX
"dst", "", DEST_TEXT
, DEST_LONGTEXT
, false )
100 add_string( SOUT_CFG_PREFIX
"bind", "", BIND_TEXT
, BIND_LONGTEXT
, false )
101 add_string( SOUT_CFG_PREFIX
"path", "", PATH_TEXT
, PATH_LONGTEXT
, false )
102 add_bool( SOUT_CFG_PREFIX
"sap", false, SAP_TEXT
, SAP_LONGTEXT
, true )
103 add_string( SOUT_CFG_PREFIX
"name", "", NAME_TEXT
, NAME_LONGTEXT
, true )
104 add_obsolete_string( SOUT_CFG_PREFIX
"group" ) /* since 2.1.0 */
105 add_string( SOUT_CFG_PREFIX
"description", "", DESC_TEXT
, DESC_LONGTEXT
, true )
106 add_string( SOUT_CFG_PREFIX
"url", "", URL_TEXT
, URL_LONGTEXT
, true )
107 add_string( SOUT_CFG_PREFIX
"email", "", EMAIL_TEXT
, EMAIL_LONGTEXT
, true )
108 add_string( SOUT_CFG_PREFIX
"phone", "", PHONE_TEXT
, PHONE_LONGTEXT
, true )
110 set_callbacks( Open
, Close
)
114 /*****************************************************************************
115 * Exported prototypes
116 *****************************************************************************/
117 static const char *const ppsz_sout_options
[] = {
118 "access", "mux", "url", "dst",
119 "sap", "name", "description", "url", "email", "phone",
123 #define DEFAULT_PORT 1234
125 struct sout_stream_sys_t
128 session_descriptor_t
*p_session
;
131 struct sout_stream_id_sys_t
135 static sout_stream_id_sys_t
* Add( sout_stream_t
*p_stream
, es_format_t
*p_fmt
)
137 return (sout_stream_id_sys_t
*)sout_MuxAddStream( p_stream
->p_sys
->p_mux
, p_fmt
);
140 static int Del( sout_stream_t
*p_stream
, sout_stream_id_sys_t
*id
)
142 sout_MuxDeleteStream( p_stream
->p_sys
->p_mux
, (sout_input_t
*)id
);
146 static int Send( sout_stream_t
*p_stream
, sout_stream_id_sys_t
*id
,
149 sout_MuxSendBuffer( p_stream
->p_sys
->p_mux
, (sout_input_t
*)id
, p_buffer
);
152 static void create_SDP(sout_stream_t
*p_stream
, sout_access_out_t
*p_access
)
154 sout_stream_sys_t
*p_sys
= p_stream
->p_sys
;
156 static const struct addrinfo hints
= {
157 .ai_family
= AF_UNSPEC
,
158 .ai_socktype
= SOCK_DGRAM
,
160 .ai_flags
= AI_NUMERICHOST
| AI_NUMERICSERV
| AI_IDN
,
162 char *shost
= var_GetNonEmptyString (p_access
, "src-addr");
163 char *dhost
= var_GetNonEmptyString (p_access
, "dst-addr");
164 int sport
= var_GetInteger (p_access
, "src-port");
165 int dport
= var_GetInteger (p_access
, "dst-port");
166 struct sockaddr_storage src
, dst
;
167 socklen_t srclen
= 0, dstlen
= 0;
168 struct addrinfo
*res
;
170 if (!vlc_getaddrinfo (dhost
, dport
, &hints
, &res
))
172 memcpy (&dst
, res
->ai_addr
, dstlen
= res
->ai_addrlen
);
176 if (!vlc_getaddrinfo (shost
, sport
, &hints
, &res
))
178 memcpy (&src
, res
->ai_addr
, srclen
= res
->ai_addrlen
);
182 char *head
= vlc_sdp_Start (VLC_OBJECT (p_stream
), SOUT_CFG_PREFIX
,
183 (struct sockaddr
*)&src
, srclen
,
184 (struct sockaddr
*)&dst
, dstlen
);
189 char *psz_sdp
= NULL
;
190 if (asprintf (&psz_sdp
, "%s"
191 "m=video %d udp mpeg\r\n", head
, dport
) == -1)
195 /* Register the SDP with the SAP thread */
198 msg_Dbg (p_stream
, "Generated SDP:\n%s", psz_sdp
);
200 sout_AnnounceRegisterSDP (p_stream
, psz_sdp
, dhost
);
207 static const char *getMuxFromAlias( const char *psz_alias
)
209 static struct { const char alias
[6]; const char mux
[32]; } mux_alias
[] =
230 { "flv", "avformat{mux=flv}" },
231 { "mkv", "avformat{mux=matroska}"},
232 { "webm", "avformat{mux=webm}"},
238 for( size_t i
= 0; i
< sizeof mux_alias
/ sizeof *mux_alias
; i
++ )
239 if( !strcasecmp( psz_alias
, mux_alias
[i
].alias
) )
240 return mux_alias
[i
].mux
;
245 static int fixAccessMux( sout_stream_t
*p_stream
, char **ppsz_mux
,
246 char **ppsz_access
, const char *psz_url
)
248 char *psz_mux
= *ppsz_mux
;
249 char *psz_access
= *ppsz_access
;
252 const char *psz_ext
= psz_url
? strrchr( psz_url
, '.' ) : NULL
;
254 psz_ext
++; /* use extension */
255 const char *psz_mux_byext
= getMuxFromAlias( psz_ext
);
261 msg_Err( p_stream
, "no access _and_ no muxer" );
266 "no access _and_ no muxer, extension gives file/%s",
268 *ppsz_access
= strdup("file");
269 *ppsz_mux
= strdup(psz_mux_byext
);
273 if( !strncmp( psz_access
, "mmsh", 4 ) )
274 *ppsz_mux
= strdup("asfh");
275 else if (!strcmp (psz_access
, "udp"))
276 *ppsz_mux
= strdup("ts");
277 else if( psz_mux_byext
)
278 *ppsz_mux
= strdup(psz_mux_byext
);
281 msg_Err( p_stream
, "no mux specified or found by extension" );
286 else if( !psz_access
)
288 if( !strncmp( psz_mux
, "asfh", 4 ) )
289 *ppsz_access
= strdup("mmsh");
290 else /* default file */
291 *ppsz_access
= strdup("file");
296 static void checkAccessMux( sout_stream_t
*p_stream
, char *psz_access
,
299 if( !strncmp( psz_access
, "mmsh", 4 ) && strncmp( psz_mux
, "asfh", 4 ) )
300 msg_Err( p_stream
, "mmsh output is only valid with asfh mux" );
301 else if( strncmp( psz_access
, "file", 4 ) &&
302 ( !strncmp( psz_mux
, "mov", 3 ) || !strncmp( psz_mux
, "mp4", 3 ) ) )
303 msg_Err( p_stream
, "mov and mp4 mux are only valid with file output" );
304 else if( !strncmp( psz_access
, "udp", 3 ) )
306 if( !strncmp( psz_mux
, "ffmpeg", 6 ) || !strncmp( psz_mux
, "avformat", 8 ) )
307 { /* why would you use ffmpeg's ts muxer ? YOU DON'T LOVE VLC ??? */
308 char *psz_ffmpeg_mux
= var_CreateGetString( p_stream
, "sout-avformat-mux" );
309 if( !psz_ffmpeg_mux
|| strncmp( psz_ffmpeg_mux
, "mpegts", 6 ) )
310 msg_Err( p_stream
, "UDP output is only valid with TS mux" );
311 free( psz_ffmpeg_mux
);
313 else if( strncmp( psz_mux
, "ts", 2 ) )
314 msg_Err( p_stream
, "UDP output is only valid with TS mux" );
318 /*****************************************************************************
320 *****************************************************************************/
321 static int Open( vlc_object_t
*p_this
)
323 sout_stream_t
*p_stream
= (sout_stream_t
*)p_this
;
324 sout_stream_sys_t
*p_sys
;
325 char *psz_mux
, *psz_access
, *psz_url
;
326 sout_access_out_t
*p_access
;
327 int ret
= VLC_EGENERIC
;
329 config_ChainParse( p_stream
, SOUT_CFG_PREFIX
, ppsz_sout_options
,
332 psz_mux
= var_GetNonEmptyString( p_stream
, SOUT_CFG_PREFIX
"mux" );
334 psz_access
= var_GetNonEmptyString( p_stream
, SOUT_CFG_PREFIX
"access" );
336 psz_access
= strdup(p_stream
->psz_name
);
338 psz_url
= var_GetNonEmptyString( p_stream
, SOUT_CFG_PREFIX
"dst" );
341 char *psz_bind
= var_GetNonEmptyString( p_stream
, SOUT_CFG_PREFIX
"bind" );
344 char *psz_path
= var_GetNonEmptyString( p_stream
, SOUT_CFG_PREFIX
"path" );
347 if( asprintf( &psz_url
, "%s/%s", psz_bind
, psz_path
) == -1 )
357 p_sys
= p_stream
->p_sys
= malloc( sizeof( sout_stream_sys_t
) );
363 p_sys
->p_session
= NULL
;
365 if( fixAccessMux( p_stream
, &psz_mux
, &psz_access
, psz_url
) )
368 checkAccessMux( p_stream
, psz_access
, psz_mux
);
370 p_access
= sout_AccessOutNew( p_stream
, psz_access
, psz_url
);
371 if( p_access
== NULL
)
373 msg_Err( p_stream
, "no suitable sout access module for `%s/%s://%s'",
374 psz_access
, psz_mux
, psz_url
);
378 p_sys
->p_mux
= sout_MuxNew( p_stream
->p_sout
, psz_mux
, p_access
);
381 const char *psz_mux_guess
= getMuxFromAlias( psz_mux
);
382 if( psz_mux_guess
&& strcmp( psz_mux_guess
, psz_mux
) )
384 msg_Dbg( p_stream
, "Couldn't open mux `%s', trying `%s' instead",
385 psz_mux
, psz_mux_guess
);
386 p_sys
->p_mux
= sout_MuxNew( p_stream
->p_sout
, psz_mux_guess
, p_access
);
391 msg_Err( p_stream
, "no suitable sout mux module for `%s/%s://%s'",
392 psz_access
, psz_mux
, psz_url
);
394 sout_AccessOutDelete( p_access
);
399 if( var_GetBool( p_stream
, SOUT_CFG_PREFIX
"sap" ) )
400 create_SDP( p_stream
, p_access
);
402 p_stream
->pf_add
= Add
;
403 p_stream
->pf_del
= Del
;
404 p_stream
->pf_send
= Send
;
405 if( !sout_AccessOutCanControlPace( p_access
) )
406 p_stream
->pace_nocontrol
= true;
410 msg_Dbg( p_this
, "using `%s/%s://%s'", psz_access
, psz_mux
, psz_url
);
413 if( ret
!= VLC_SUCCESS
)
422 /*****************************************************************************
424 *****************************************************************************/
425 static void Close( vlc_object_t
* p_this
)
427 sout_stream_t
*p_stream
= (sout_stream_t
*)p_this
;
428 sout_stream_sys_t
*p_sys
= p_stream
->p_sys
;
429 sout_access_out_t
*p_access
= p_sys
->p_mux
->p_access
;
431 if( p_sys
->p_session
!= NULL
)
432 sout_AnnounceUnRegister( p_stream
, p_sys
->p_session
);
434 sout_MuxDelete( p_sys
->p_mux
);
435 sout_AccessOutDelete( p_access
);