1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5<title>souphttpsrc: GStreamer Good Plugins 1.0 Plugins Reference Manual</title> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="index.html" title="GStreamer Good Plugins 1.0 Plugins Reference Manual"> 8<link rel="up" href="ch01.html" title="gst-plugins-good Elements"> 9<link rel="prev" href="gst-plugins-good-plugins-souphttpclientsink.html" title="souphttpclientsink"> 10<link rel="next" href="gst-plugins-good-plugins-spectrum.html" title="spectrum"> 11<meta name="generator" content="GTK-Doc V1.28 (XML mode)"> 12<link rel="stylesheet" href="style.css" type="text/css"> 13</head> 14<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 15<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> 16<td width="100%" align="left" class="shortcuts"> 17<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 18 <a href="#gst-plugins-good-plugins-souphttpsrc.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 19 <a href="#gst-plugins-good-plugins-souphttpsrc.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> 20 <a href="#gst-plugins-good-plugins-souphttpsrc.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> 21 <a href="#gst-plugins-good-plugins-souphttpsrc.properties" class="shortcut">Properties</a></span> 22</td> 23<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 24<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 25<td><a accesskey="p" href="gst-plugins-good-plugins-souphttpclientsink.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 26<td><a accesskey="n" href="gst-plugins-good-plugins-spectrum.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 27</tr></table> 28<div class="refentry"> 29<a name="gst-plugins-good-plugins-souphttpsrc"></a><div class="titlepage"></div> 30<div class="refnamediv"><table width="100%"><tr> 31<td valign="top"> 32<h2><span class="refentrytitle"><a name="gst-plugins-good-plugins-souphttpsrc.top_of_page"></a>souphttpsrc</span></h2> 33<p>souphttpsrc</p> 34</td> 35<td class="gallery_image" valign="top" align="right"></td> 36</tr></table></div> 37<div class="refsect1"> 38<a name="gst-plugins-good-plugins-souphttpsrc.properties"></a><h2>Properties</h2> 39<div class="informaltable"><table class="informaltable" border="0"> 40<colgroup> 41<col width="150px" class="properties_type"> 42<col width="300px" class="properties_name"> 43<col width="200px" class="properties_flags"> 44</colgroup> 45<tbody> 46<tr> 47<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 48<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--automatic-redirect" title="The “automatic-redirect” property">automatic-redirect</a></td> 49<td class="property_flags">Read / Write</td> 50</tr> 51<tr> 52<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td> 53<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--cookies" title="The “cookies” property">cookies</a></td> 54<td class="property_flags">Read / Write</td> 55</tr> 56<tr> 57<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 58<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--iradio-mode" title="The “iradio-mode” property">iradio-mode</a></td> 59<td class="property_flags">Read / Write</td> 60</tr> 61<tr> 62<td class="property_type"> 63<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 64<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--location" title="The “location” property">location</a></td> 65<td class="property_flags">Read / Write</td> 66</tr> 67<tr> 68<td class="property_type"> 69<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 70<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--proxy" title="The “proxy” property">proxy</a></td> 71<td class="property_flags">Read / Write</td> 72</tr> 73<tr> 74<td class="property_type"> 75<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 76<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--user-agent" title="The “user-agent” property">user-agent</a></td> 77<td class="property_flags">Read / Write</td> 78</tr> 79<tr> 80<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 81<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--is-live" title="The “is-live” property">is-live</a></td> 82<td class="property_flags">Read / Write</td> 83</tr> 84<tr> 85<td class="property_type"> 86<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 87<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--proxy-id" title="The “proxy-id” property">proxy-id</a></td> 88<td class="property_flags">Read / Write</td> 89</tr> 90<tr> 91<td class="property_type"> 92<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 93<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--proxy-pw" title="The “proxy-pw” property">proxy-pw</a></td> 94<td class="property_flags">Read / Write</td> 95</tr> 96<tr> 97<td class="property_type"> 98<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 99<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--user-id" title="The “user-id” property">user-id</a></td> 100<td class="property_flags">Read / Write</td> 101</tr> 102<tr> 103<td class="property_type"> 104<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 105<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--user-pw" title="The “user-pw” property">user-pw</a></td> 106<td class="property_flags">Read / Write</td> 107</tr> 108<tr> 109<td class="property_type"> 110<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstStructure.html#GstStructure-struct"><span class="type">GstStructure</span></a> *</td> 111<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--extra-headers" title="The “extra-headers” property">extra-headers</a></td> 112<td class="property_flags">Read / Write</td> 113</tr> 114<tr> 115<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td> 116<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--timeout" title="The “timeout” property">timeout</a></td> 117<td class="property_flags">Read / Write</td> 118</tr> 119<tr> 120<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 121<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--compress" title="The “compress” property">compress</a></td> 122<td class="property_flags">Read / Write</td> 123</tr> 124<tr> 125<td class="property_type"><a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupLogger.html#SoupLoggerLogLevel"><span class="type">SoupLoggerLogLevel</span></a></td> 126<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--http-log-level" title="The “http-log-level” property">http-log-level</a></td> 127<td class="property_flags">Read / Write</td> 128</tr> 129<tr> 130<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 131<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--keep-alive" title="The “keep-alive” property">keep-alive</a></td> 132<td class="property_flags">Read / Write</td> 133</tr> 134<tr> 135<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 136<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--retries" title="The “retries” property">retries</a></td> 137<td class="property_flags">Read / Write</td> 138</tr> 139<tr> 140<td class="property_type"> 141<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 142<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--ssl-ca-file" title="The “ssl-ca-file” property">ssl-ca-file</a></td> 143<td class="property_flags">Read / Write</td> 144</tr> 145<tr> 146<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 147<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--ssl-strict" title="The “ssl-strict” property">ssl-strict</a></td> 148<td class="property_flags">Read / Write</td> 149</tr> 150<tr> 151<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 152<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--ssl-use-system-ca-file" title="The “ssl-use-system-ca-file” property">ssl-use-system-ca-file</a></td> 153<td class="property_flags">Read / Write</td> 154</tr> 155<tr> 156<td class="property_type"> 157<a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="type">GTlsDatabase</span></a> *</td> 158<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--tls-database" title="The “tls-database” property">tls-database</a></td> 159<td class="property_flags">Read / Write</td> 160</tr> 161<tr> 162<td class="property_type"> 163<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 164<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--method" title="The “method” property">method</a></td> 165<td class="property_flags">Read / Write</td> 166</tr> 167<tr> 168<td class="property_type"> 169<a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="type">GTlsInteraction</span></a> *</td> 170<td class="property_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--tls-interaction" title="The “tls-interaction” property">tls-interaction</a></td> 171<td class="property_flags">Read / Write</td> 172</tr> 173</tbody> 174</table></div> 175</div> 176<a name="GstSoupHTTPSrc"></a><div class="refsect1"> 177<a name="gst-plugins-good-plugins-souphttpsrc.other"></a><h2>Types and Values</h2> 178<div class="informaltable"><table class="informaltable" width="100%" border="0"> 179<colgroup> 180<col width="150px" class="name"> 181<col class="description"> 182</colgroup> 183<tbody><tr> 184<td class="datatype_keyword">struct</td> 185<td class="function_name"><a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc-struct" title="struct GstSoupHTTPSrc">GstSoupHTTPSrc</a></td> 186</tr></tbody> 187</table></div> 188</div> 189<div class="refsect1"> 190<a name="gst-plugins-good-plugins-souphttpsrc.object-hierarchy"></a><h2>Object Hierarchy</h2> 191<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> 192 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> 193 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstObject.html#GstObject-struct">GstObject</a> 194 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct">GstElement</a> 195 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-libs-1.0/GstBaseSrc.html#GstBaseSrc-struct">GstBaseSrc</a> 196 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-libs-1.0/GstPushSrc.html#GstPushSrc-struct">GstPushSrc</a> 197 <span class="lineart">╰──</span> GstSoupHTTPSrc 198</pre> 199</div> 200<div class="refsect1"> 201<a name="gst-plugins-good-plugins-souphttpsrc.implemented-interfaces"></a><h2>Implemented Interfaces</h2> 202<p> 203GstSoupHTTPSrc implements 204 <a href="/usr/share/gtk-doc/html/gstreamer-1.0/gstreamer-GstUriHandler.html#GstURIHandler-struct">GstURIHandler</a>.</p> 205</div> 206<div class="refsect1"> 207<a name="gst-plugins-good-plugins-souphttpsrc.description"></a><h2>Description</h2> 208<p>This plugin reads data from a remote location specified by a URI. 209Supported protocols are 'http', 'https'.</p> 210<p>An HTTP proxy must be specified by its URL. 211If the "http_proxy" environment variable is set, its value is used. 212If built with libsoup's GNOME integration features, the GNOME proxy 213configuration will be used, or failing that, proxy autodetection. 214The <a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--proxy" title="The “proxy” property"><span class="type">“proxy”</span></a> property can be used to override the default.</p> 215<p>In case the <a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--iradio-mode" title="The “iradio-mode” property"><span class="type">“iradio-mode”</span></a> property is set and the location is 216an HTTP resource, souphttpsrc will send special Icecast HTTP headers to the 217server to request additional Icecast meta-information. 218If the server is not an Icecast server, it will behave as if the 219<a class="link" href="gst-plugins-good-plugins-souphttpsrc.html#GstSoupHTTPSrc--iradio-mode" title="The “iradio-mode” property"><span class="type">“iradio-mode”</span></a> property were not set. If it is, souphttpsrc will 220output data with a media type of application/x-icy, in which case you will 221need to use the <span class="type">ICYDemux</span> element as follow-up element to extract the Icecast 222metadata and to determine the underlying media type.</p> 223<div class="refsect2"> 224<a name="id-1.2.247.8.5"></a><h3>Example launch line</h3> 225<div class="informalexample"> 226 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 227 <tbody> 228 <tr> 229 <td class="listing_lines" align="right"><pre>1 2302</pre></td> 231 <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">1.0</span> <span class="gtkdoc opt">-</span>v souphttpsrc location<span class="gtkdoc opt">=</span>https<span class="gtkdoc opt">:</span><span class="gtkdoc slc">//some.server.org/index.html</span> 232 <span class="gtkdoc opt">!</span> filesink location<span class="gtkdoc opt">=/</span>home<span class="gtkdoc opt">/</span>joe<span class="gtkdoc opt">/</span>server<span class="gtkdoc opt">.</span>html</pre></td> 233 </tr> 234 </tbody> 235 </table> 236</div> 237 The above pipeline reads a web page from a server using the HTTPS protocol 238and writes it to a local file. 239<div class="informalexample"> 240 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 241 <tbody> 242 <tr> 243 <td class="listing_lines" align="right"><pre>1 2442 2453 2464</pre></td> 247 <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">1.0</span> <span class="gtkdoc opt">-</span>v souphttpsrc user<span class="gtkdoc opt">-</span>agent<span class="gtkdoc opt">=</span><span class="string">"FooPlayer 0.99 beta"</span> 248 automatic<span class="gtkdoc opt">-</span>redirect<span class="gtkdoc opt">=</span><span class="keyword">false</span> proxy<span class="gtkdoc opt">=</span>http<span class="gtkdoc opt">:</span><span class="gtkdoc slc">//proxy.intranet.local:8080</span> 249 location<span class="gtkdoc opt">=</span>http<span class="gtkdoc opt">:</span><span class="gtkdoc slc">//music.foobar.com/demo.mp3 ! mpgaudioparse</span> 250 <span class="gtkdoc opt">!</span> mpg123audiodec <span class="gtkdoc opt">!</span> audioconvert <span class="gtkdoc opt">!</span> audioresample <span class="gtkdoc opt">!</span> autoaudiosink</pre></td> 251 </tr> 252 </tbody> 253 </table> 254</div> 255 The above pipeline will read and decode and play an mp3 file from a 256web server using the HTTP protocol. If the server sends redirects, 257the request fails instead of following the redirect. The specified 258HTTP proxy server is used. The User-Agent HTTP request header 259is set to a custom string instead of "GStreamer souphttpsrc." 260<div class="informalexample"> 261 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 262 <tbody> 263 <tr> 264 <td class="listing_lines" align="right"><pre>1 2652 2663 2674</pre></td> 268 <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">1.0</span> <span class="gtkdoc opt">-</span>v souphttpsrc location<span class="gtkdoc opt">=</span>http<span class="gtkdoc opt">:</span><span class="gtkdoc slc">//10.11.12.13/mjpeg</span> 269 <span class="keyword">do</span><span class="gtkdoc opt">-</span>timestamp<span class="gtkdoc opt">=</span><span class="keyword">true</span> <span class="gtkdoc opt">!</span> multipartdemux 270 <span class="gtkdoc opt">!</span> image<span class="gtkdoc opt">/</span>jpeg<span class="gtkdoc opt">,</span>width<span class="gtkdoc opt">=</span><span class="number">640</span><span class="gtkdoc opt">,</span>height<span class="gtkdoc opt">=</span><span class="number">480</span> <span class="gtkdoc opt">!</span> matroskamux 271 <span class="gtkdoc opt">!</span> filesink location<span class="gtkdoc opt">=</span>mjpeg<span class="gtkdoc opt">.</span>mkv</pre></td> 272 </tr> 273 </tbody> 274 </table> 275</div> 276 The above pipeline reads a motion JPEG stream from an IP camera 277using the HTTP protocol, encoded as mime/multipart image/jpeg 278parts, and writes a Matroska motion JPEG file. The width and 279height properties are set in the caps to provide the Matroska 280multiplexer with the information to set this in the header. 281Timestamps are set on the buffers as they arrive from the camera. 282These are used by the mime/multipart demultiplexer to emit timestamps 283on the JPEG-encoded video frame buffers. This allows the Matroska 284multiplexer to timestamp the frames in the resulting file. 285</div> 286<div class="refsynopsisdiv"> 287<h2>Synopsis</h2> 288<div class="refsect2"> 289<a name="id-1.2.247.8.6.1"></a><h3>Element Information</h3> 290<div class="variablelist"><table border="0" class="variablelist"> 291<colgroup> 292<col align="left" valign="top"> 293<col> 294</colgroup> 295<tbody> 296<tr> 297<td><p><span class="term">plugin</span></p></td> 298<td> 299 <a class="link" href="gst-plugins-good-plugins-plugin-soup.html#plugin-soup">soup</a> 300 </td> 301</tr> 302<tr> 303<td><p><span class="term">author</span></p></td> 304<td>Wouter Cloetens <wouter@mind.be></td> 305</tr> 306<tr> 307<td><p><span class="term">class</span></p></td> 308<td>Source/Network</td> 309</tr> 310</tbody> 311</table></div> 312</div> 313<hr> 314<div class="refsect2"> 315<a name="id-1.2.247.8.6.2"></a><h3>Element Pads</h3> 316<div class="variablelist"><table border="0" class="variablelist"> 317<colgroup> 318<col align="left" valign="top"> 319<col> 320</colgroup> 321<tbody> 322<tr> 323<td><p><span class="term">name</span></p></td> 324<td>src</td> 325</tr> 326<tr> 327<td><p><span class="term">direction</span></p></td> 328<td>source</td> 329</tr> 330<tr> 331<td><p><span class="term">presence</span></p></td> 332<td>always</td> 333</tr> 334<tr> 335<td><p><span class="term">details</span></p></td> 336<td>ANY</td> 337</tr> 338</tbody> 339</table></div> 340</div> 341</div> 342</div> 343<div class="refsect1"> 344<a name="gst-plugins-good-plugins-souphttpsrc.functions_details"></a><h2>Functions</h2> 345<p></p> 346</div> 347<div class="refsect1"> 348<a name="gst-plugins-good-plugins-souphttpsrc.other_details"></a><h2>Types and Values</h2> 349<div class="refsect2"> 350<a name="GstSoupHTTPSrc-struct"></a><h3>struct GstSoupHTTPSrc</h3> 351<pre class="programlisting">struct GstSoupHTTPSrc;</pre> 352</div> 353</div> 354<div class="refsect1"> 355<a name="gst-plugins-good-plugins-souphttpsrc.property-details"></a><h2>Property Details</h2> 356<div class="refsect2"> 357<a name="GstSoupHTTPSrc--automatic-redirect"></a><h3>The <code class="literal">“automatic-redirect”</code> property</h3> 358<pre class="programlisting"> “automatic-redirect” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 359<p>Automatically follow HTTP redirects (HTTP Status Code 3xx).</p> 360<p>Flags: Read / Write</p> 361<p>Default value: TRUE</p> 362</div> 363<hr> 364<div class="refsect2"> 365<a name="GstSoupHTTPSrc--cookies"></a><h3>The <code class="literal">“cookies”</code> property</h3> 366<pre class="programlisting"> “cookies” <a href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> 367<p>HTTP request cookies.</p> 368<p>Flags: Read / Write</p> 369</div> 370<hr> 371<div class="refsect2"> 372<a name="GstSoupHTTPSrc--iradio-mode"></a><h3>The <code class="literal">“iradio-mode”</code> property</h3> 373<pre class="programlisting"> “iradio-mode” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 374<p>Enable internet radio mode (ask server to send shoutcast/icecast metadata interleaved with the actual stream data).</p> 375<p>Flags: Read / Write</p> 376<p>Default value: TRUE</p> 377</div> 378<hr> 379<div class="refsect2"> 380<a name="GstSoupHTTPSrc--location"></a><h3>The <code class="literal">“location”</code> property</h3> 381<pre class="programlisting"> “location” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 382<p>Location to read from.</p> 383<p>Flags: Read / Write</p> 384<p>Default value: ""</p> 385</div> 386<hr> 387<div class="refsect2"> 388<a name="GstSoupHTTPSrc--proxy"></a><h3>The <code class="literal">“proxy”</code> property</h3> 389<pre class="programlisting"> “proxy” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 390<p>HTTP proxy server URI.</p> 391<p>Flags: Read / Write</p> 392<p>Default value: ""</p> 393</div> 394<hr> 395<div class="refsect2"> 396<a name="GstSoupHTTPSrc--user-agent"></a><h3>The <code class="literal">“user-agent”</code> property</h3> 397<pre class="programlisting"> “user-agent” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 398<p>Value of the User-Agent HTTP request header field.</p> 399<p>Flags: Read / Write</p> 400<p>Default value: "GStreamer souphttpsrc 1.16.2 "</p> 401</div> 402<hr> 403<div class="refsect2"> 404<a name="GstSoupHTTPSrc--is-live"></a><h3>The <code class="literal">“is-live”</code> property</h3> 405<pre class="programlisting"> “is-live” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 406<p>Act like a live source.</p> 407<p>Flags: Read / Write</p> 408<p>Default value: FALSE</p> 409</div> 410<hr> 411<div class="refsect2"> 412<a name="GstSoupHTTPSrc--proxy-id"></a><h3>The <code class="literal">“proxy-id”</code> property</h3> 413<pre class="programlisting"> “proxy-id” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 414<p>HTTP proxy URI user id for authentication.</p> 415<p>Flags: Read / Write</p> 416<p>Default value: ""</p> 417</div> 418<hr> 419<div class="refsect2"> 420<a name="GstSoupHTTPSrc--proxy-pw"></a><h3>The <code class="literal">“proxy-pw”</code> property</h3> 421<pre class="programlisting"> “proxy-pw” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 422<p>HTTP proxy URI user password for authentication.</p> 423<p>Flags: Read / Write</p> 424<p>Default value: ""</p> 425</div> 426<hr> 427<div class="refsect2"> 428<a name="GstSoupHTTPSrc--user-id"></a><h3>The <code class="literal">“user-id”</code> property</h3> 429<pre class="programlisting"> “user-id” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 430<p>HTTP location URI user id for authentication.</p> 431<p>Flags: Read / Write</p> 432<p>Default value: ""</p> 433</div> 434<hr> 435<div class="refsect2"> 436<a name="GstSoupHTTPSrc--user-pw"></a><h3>The <code class="literal">“user-pw”</code> property</h3> 437<pre class="programlisting"> “user-pw” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 438<p>HTTP location URI user password for authentication.</p> 439<p>Flags: Read / Write</p> 440<p>Default value: ""</p> 441</div> 442<hr> 443<div class="refsect2"> 444<a name="GstSoupHTTPSrc--extra-headers"></a><h3>The <code class="literal">“extra-headers”</code> property</h3> 445<pre class="programlisting"> “extra-headers” <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstStructure.html#GstStructure-struct"><span class="type">GstStructure</span></a> *</pre> 446<p>Extra headers to append to the HTTP request.</p> 447<p>Flags: Read / Write</p> 448</div> 449<hr> 450<div class="refsect2"> 451<a name="GstSoupHTTPSrc--timeout"></a><h3>The <code class="literal">“timeout”</code> property</h3> 452<pre class="programlisting"> “timeout” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre> 453<p>Value in seconds to timeout a blocking I/O (0 = No timeout).</p> 454<p>Flags: Read / Write</p> 455<p>Allowed values: <= 3600</p> 456<p>Default value: 15</p> 457</div> 458<hr> 459<div class="refsect2"> 460<a name="GstSoupHTTPSrc--compress"></a><h3>The <code class="literal">“compress”</code> property</h3> 461<pre class="programlisting"> “compress” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 462<p>Allow compressed content encodings.</p> 463<p>Flags: Read / Write</p> 464<p>Default value: FALSE</p> 465</div> 466<hr> 467<div class="refsect2"> 468<a name="GstSoupHTTPSrc--http-log-level"></a><h3>The <code class="literal">“http-log-level”</code> property</h3> 469<pre class="programlisting"> “http-log-level” <a href="/usr/share/gtk-doc/html/libsoup-2.4/SoupLogger.html#SoupLoggerLogLevel"><span class="type">SoupLoggerLogLevel</span></a></pre> 470<p>Set log level for soup's HTTP session log.</p> 471<p>Flags: Read / Write</p> 472<p>Default value: SOUP_LOGGER_LOG_HEADERS</p> 473</div> 474<hr> 475<div class="refsect2"> 476<a name="GstSoupHTTPSrc--keep-alive"></a><h3>The <code class="literal">“keep-alive”</code> property</h3> 477<pre class="programlisting"> “keep-alive” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 478<p>Use HTTP persistent connections.</p> 479<p>Flags: Read / Write</p> 480<p>Default value: TRUE</p> 481</div> 482<hr> 483<div class="refsect2"> 484<a name="GstSoupHTTPSrc--retries"></a><h3>The <code class="literal">“retries”</code> property</h3> 485<pre class="programlisting"> “retries” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 486<p>Maximum number of retries until giving up (-1=infinite).</p> 487<p>Flags: Read / Write</p> 488<p>Allowed values: >= G_MAXULONG</p> 489<p>Default value: 3</p> 490</div> 491<hr> 492<div class="refsect2"> 493<a name="GstSoupHTTPSrc--ssl-ca-file"></a><h3>The <code class="literal">“ssl-ca-file”</code> property</h3> 494<pre class="programlisting"> “ssl-ca-file” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 495<p>Location of a SSL anchor CA file to use.</p> 496<p>Flags: Read / Write</p> 497<p>Default value: NULL</p> 498</div> 499<hr> 500<div class="refsect2"> 501<a name="GstSoupHTTPSrc--ssl-strict"></a><h3>The <code class="literal">“ssl-strict”</code> property</h3> 502<pre class="programlisting"> “ssl-strict” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 503<p>Strict SSL certificate checking.</p> 504<p>Flags: Read / Write</p> 505<p>Default value: TRUE</p> 506</div> 507<hr> 508<div class="refsect2"> 509<a name="GstSoupHTTPSrc--ssl-use-system-ca-file"></a><h3>The <code class="literal">“ssl-use-system-ca-file”</code> property</h3> 510<pre class="programlisting"> “ssl-use-system-ca-file” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 511<p>Use system CA file.</p> 512<p>Flags: Read / Write</p> 513<p>Default value: TRUE</p> 514</div> 515<hr> 516<div class="refsect2"> 517<a name="GstSoupHTTPSrc--tls-database"></a><h3>The <code class="literal">“tls-database”</code> property</h3> 518<pre class="programlisting"> “tls-database” <a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="type">GTlsDatabase</span></a> *</pre> 519<p>TLS database with anchor certificate authorities used to validate the server certificate.</p> 520<p>Flags: Read / Write</p> 521</div> 522<hr> 523<div class="refsect2"> 524<a name="GstSoupHTTPSrc--method"></a><h3>The <code class="literal">“method”</code> property</h3> 525<pre class="programlisting"> “method” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 526<p>The HTTP method to use (GET, HEAD, OPTIONS, etc).</p> 527<p>Flags: Read / Write</p> 528<p>Default value: NULL</p> 529</div> 530<hr> 531<div class="refsect2"> 532<a name="GstSoupHTTPSrc--tls-interaction"></a><h3>The <code class="literal">“tls-interaction”</code> property</h3> 533<pre class="programlisting"> “tls-interaction” <a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="type">GTlsInteraction</span></a> *</pre> 534<p>A GTlsInteraction object to be used when the connection or certificate database need to interact with the user.</p> 535<p>Flags: Read / Write</p> 536</div> 537</div> 538</div> 539<div class="footer"> 540<hr>Generated by GTK-Doc V1.28</div> 541</body> 542</html>
