souphttpsrc: GStreamer Good Plugins 1.0 Plugins Reference Manual

## souphttpsrc souphttpsrc |

## Properties

gboolean | automatic-redirect | Read / Write
GStrv | cookies | Read / Write
gboolean | iradio-mode | Read / Write
gchar * | location | Read / Write
gchar * | proxy | Read / Write
gchar * | user-agent | Read / Write
gboolean | is-live | Read / Write
gchar * | proxy-id | Read / Write
gchar * | proxy-pw | Read / Write
gchar * | user-id | Read / Write
gchar * | user-pw | Read / Write
GstStructure * | extra-headers | Read / Write
guint | timeout | Read / Write
gboolean | compress | Read / Write
SoupLoggerLogLevel | http-log-level | Read / Write
gboolean | keep-alive | Read / Write
gint | retries | Read / Write
gchar * | ssl-ca-file | Read / Write
gboolean | ssl-strict | Read / Write
gboolean | ssl-use-system-ca-file | Read / Write
GTlsDatabase * | tls-database | Read / Write
gchar * | method | Read / Write

## Types and Values

struct | GstSoupHTTPSrc

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GstObject
                ╰── GstElement
                    ╰── GstBaseSrc
                        ╰── GstPushSrc
                            ╰── GstSoupHTTPSrc

## Implemented Interfaces

GstSoupHTTPSrc implements GstURIHandler.

## Description

## Synopsis

### Element Information

plugin | soup
author | Wouter Cloetens <wouter@mind.be>
class | Source/Network

### Element Pads

name | src
direction | source
presence | always
details | ANY

## Functions

## Types and Values

### struct GstSoupHTTPSrc

    struct GstSoupHTTPSrc;

## Property Details

### The `“automatic-redirect”` property

      “automatic-redirect”       gboolean

Automatically follow HTTP redirects (HTTP Status Code 3xx).

Flags: Read / Write

Default value: TRUE

### The `“cookies”` property

      “cookies”                  GStrv

HTTP request cookies.

Flags: Read / Write

### The `“iradio-mode”` property

      “iradio-mode”              gboolean

Enable internet radio mode (ask server to send shoutcast/icecast metadata interleaved with the actual stream data).

Flags: Read / Write

Default value: TRUE

### The `“location”` property

      “location”                 gchar *

Location to read from.

Flags: Read / Write

Default value: ""

### The `“proxy”` property

      “proxy”                    gchar *

HTTP proxy server URI.

Flags: Read / Write

Default value: ""

### The `“user-agent”` property

      “user-agent”               gchar *

Value of the User-Agent HTTP request header field.

Flags: Read / Write

Default value: "GStreamer souphttpsrc "

### The `“is-live”` property

      “is-live”                  gboolean

Act like a live source.

Flags: Read / Write

Default value: FALSE

### The `“proxy-id”` property

      “proxy-id”                 gchar *

HTTP proxy URI user id for authentication.

Flags: Read / Write

Default value: ""

### The `“proxy-pw”` property

      “proxy-pw”                 gchar *

HTTP proxy URI user password for authentication.

Flags: Read / Write

Default value: ""

### The `“user-id”` property

      “user-id”                  gchar *

HTTP location URI user id for authentication.

Flags: Read / Write

Default value: ""

### The `“user-pw”` property

      “user-pw”                  gchar *

HTTP location URI user password for authentication.

Flags: Read / Write

Default value: ""

### The `“extra-headers”` property

      “extra-headers”            GstStructure *

Extra headers to append to the HTTP request.

Flags: Read / Write

### The `“timeout”` property

      “timeout”                  guint

Value in seconds to timeout a blocking I/O (0 = No timeout).

Flags: Read / Write

Allowed values: <= 3600

Default value: 15

### The `“compress”` property

      “compress”                 gboolean

Allow compressed content encodings.

Flags: Read / Write

Default value: FALSE

### The `“http-log-level”` property

      “http-log-level”           SoupLoggerLogLevel

Set log level for soup's HTTP session log.

Flags: Read / Write

Default value: SOUP_LOGGER_LOG_HEADERS

### The `“keep-alive”` property

      “keep-alive”               gboolean

Use HTTP persistent connections.

Flags: Read / Write

Default value: FALSE

### The `“retries”` property

      “retries”                  gint

Maximum number of retries until giving up (-1=infinite).

Flags: Read / Write

Allowed values: >= G_MAXULONG

Default value: 3

### The `“ssl-ca-file”` property

      “ssl-ca-file”              gchar *

Location of a SSL anchor CA file to use.

Flags: Read / Write

Default value: NULL

### The `“ssl-strict”` property

      “ssl-strict”               gboolean

Strict SSL certificate checking.

Flags: Read / Write

Default value: TRUE

### The `“ssl-use-system-ca-file”` property

      “ssl-use-system-ca-file”   gboolean

Use system CA file.

Flags: Read / Write

Default value: TRUE

### The `“tls-database”` property

      “tls-database”             GTlsDatabase *

TLS database with anchor certificate authorities used to validate the server certificate.

Flags: Read / Write

### The `“method”` property

      “method”                   gchar *

The HTTP method to use (GET, HEAD, OPTIONS, etc).

Flags: Read / Write

Default value: NULL