multiudpsink

multiudpsink is a network sink that sends UDP packets to multiple clients. It can be combined with rtp payload encoders to implement RTP streaming.

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──GstBaseSink
                    ╰──GstMultiUDPSink

Factory details

Authors: – Wim Taymans

Classification:Sink/Network

Rank – none

Plugin – gstudp

Package – GStreamer Good Plug-ins git

Pad Templates

sink

ANY

Presencealways

Directionsink


Signals

add

add_callback (GstElement * gstmultiudpsink,
              gchararray * host,
              gint * port,
              gpointer * udata)
def add_callback (gstmultiudpsink, host, port, udata):
    #python callback for the 'add' signal
function add_callback(gstmultiudpsink: GstElement * gstmultiudpsink, host: gchararray * host, port: gint * port, udata: gpointer * udata): {
    // javascript callback for the 'add' signal
}

Add a client with destination host and port to the list of clients. When the same host/port pair is added multiple times, the send-duplicates property defines if the packets are sent multiple times to the same host/port pair or not.

When a host/port pair is added multiple times, an equal amount of remove calls must be performed to actually remove the host/port pair from the list of destinations.

Parameters:

gstmultiudpsink

the sink on which the signal is emitted

host

the hostname/IP address of the client to add

port

the port of the client to add

udata
No description available

clear

clear_callback (GstElement * gstmultiudpsink,
                gpointer * udata)
def clear_callback (gstmultiudpsink, udata):
    #python callback for the 'clear' signal
function clear_callback(gstmultiudpsink: GstElement * gstmultiudpsink, udata: gpointer * udata): {
    // javascript callback for the 'clear' signal
}

Clear the list of clients.

Parameters:

gstmultiudpsink

the sink on which the signal is emitted

udata
No description available

client-added

client_added_callback (GstElement * gstmultiudpsink,
                       gchararray * host,
                       gint * port,
                       gpointer * udata)
def client_added_callback (gstmultiudpsink, host, port, udata):
    #python callback for the 'client-added' signal
function client_added_callback(gstmultiudpsink: GstElement * gstmultiudpsink, host: gchararray * host, port: gint * port, udata: gpointer * udata): {
    // javascript callback for the 'client-added' signal
}

Signal emitted when a new client is added to the list of clients.

Parameters:

gstmultiudpsink

the sink emitting the signal

host

the hostname/IP address of the added client

port

the port of the added client

udata
No description available

client-removed

client_removed_callback (GstElement * gstmultiudpsink,
                         gchararray * host,
                         gint * port,
                         gpointer * udata)
def client_removed_callback (gstmultiudpsink, host, port, udata):
    #python callback for the 'client-removed' signal
function client_removed_callback(gstmultiudpsink: GstElement * gstmultiudpsink, host: gchararray * host, port: gint * port, udata: gpointer * udata): {
    // javascript callback for the 'client-removed' signal
}

Signal emitted when a client is removed from the list of clients.

Parameters:

gstmultiudpsink

the sink emitting the signal

host

the hostname/IP address of the removed client

port

the port of the removed client

udata
No description available

get-stats

GstStructure *
get_stats_callback (GstElement * gstmultiudpsink,
                    gchararray * host,
                    gint * port,
                    gpointer * udata)
def get_stats_callback (gstmultiudpsink, host, port, udata):
    #python callback for the 'get-stats' signal
function get_stats_callback(gstmultiudpsink: GstElement * gstmultiudpsink, host: gchararray * host, port: gint * port, udata: gpointer * udata): {
    // javascript callback for the 'get-stats' signal
}

Get the statistics of the client with destination host and port.

Parameters:

gstmultiudpsink

the sink on which the signal is emitted

host

the hostname/IP address of the client to get stats on

port

the port of the client to get stats on

udata
No description available
Returns ( GstStructure * ) –

a GstStructure: bytes_sent, packets_sent, connect_time (in epoch nanoseconds), disconnect_time (in epoch nanoseconds)


remove

remove_callback (GstElement * gstmultiudpsink,
                 gchararray * host,
                 gint * port,
                 gpointer * udata)
def remove_callback (gstmultiudpsink, host, port, udata):
    #python callback for the 'remove' signal
function remove_callback(gstmultiudpsink: GstElement * gstmultiudpsink, host: gchararray * host, port: gint * port, udata: gpointer * udata): {
    // javascript callback for the 'remove' signal
}

Remove the client with destination host and port from the list of clients.

Parameters:

gstmultiudpsink

the sink on which the signal is emitted

host

the hostname/IP address of the client to remove

port

the port of the client to remove

udata
No description available

Properties

async

“async” gboolean *

Go asynchronously to PAUSED

Flags : Read / Write

Default value : true


auto-multicast

“auto-multicast” gboolean *

Automatically join/leave the multicast groups, FALSE means user has to do it himself

Flags : Read / Write

Default value : true


bind-address

“bind-address” gchararray *

Address to bind the socket to

Flags : Read / Write

Default value : NULL


bind-port

“bind-port” gint *

Port to bind the socket to

Flags : Read / Write

Default value : 0


blocksize

“blocksize” guint *

Size in bytes to pull per buffer (0 = default)

Flags : Read / Write

Default value : 4096


buffer-size

“buffer-size” gint *

Size of the kernel send buffer in bytes, 0=default

Flags : Read / Write

Default value : 0


bytes-served

“bytes-served” guint64 *

Total number of bytes sent to all clients

Flags : Read

Default value : 0


bytes-to-serve

“bytes-to-serve” guint64 *

Number of bytes received to serve to clients

Flags : Read

Default value : 0


clients

“clients” gchararray *

A comma separated list of host:port pairs with destinations

Flags : Read / Write


close-socket

“close-socket” gboolean *

Close socket if passed as property on state change

Flags : Read / Write

Default value : true


enable-last-sample

“enable-last-sample” gboolean *

Enable the last-sample property

Flags : Read / Write

Default value : true


force-ipv4

“force-ipv4” gboolean *

Forcing the use of an IPv4 socket (DEPRECATED, has no effect anymore)

Flags : Read / Write

Default value : false


last-sample

“last-sample” GstSample *

The last sample received in the sink

Flags : Read


loop

“loop” gboolean *

Used for setting the multicast loop parameter. TRUE = enable, FALSE = disable

Flags : Read / Write

Default value : true


max-bitrate

“max-bitrate” guint64 *

The maximum bits per second to render (0 = disabled)

Flags : Read / Write

Default value : 0


max-lateness

“max-lateness” gint64 *

Maximum number of nanoseconds that a buffer can be late before it is dropped (-1 unlimited)

Flags : Read / Write

Default value : 18446744073709551615


multicast-iface

“multicast-iface” gchararray *

The network interface on which to join the multicast group

Flags : Read / Write

Default value : NULL


name

“name” gchararray *

The name of the object

Flags : Read / Write / Construct

Default value : NULL


parent

“parent” GstObject *

The parent of the object

Flags : Read / Write


processing-deadline

“processing-deadline” guint64 *

Maximum processing deadline in nanoseconds

Flags : Read / Write

Default value : 20000000


qos

“qos” gboolean *

Generate Quality-of-Service events upstream

Flags : Read / Write

Default value : false


qos-dscp

“qos-dscp” gint *

Quality of Service, differentiated services code point (-1 default)

Flags : Read / Write

Default value : -1


render-delay

“render-delay” guint64 *

Additional render delay of the sink in nanoseconds

Flags : Read / Write

Default value : 0


send-duplicates

“send-duplicates” gboolean *

When a distination/port pair is added multiple times, send packets multiple times as well

Flags : Read / Write

Default value : true


socket

“socket” GSocket *

Socket to use for UDP sending. (NULL == allocate)

Flags : Read / Write


socket-v6

“socket-v6” GSocket *

Socket to use for UDPv6 sending. (NULL == allocate)

Flags : Read / Write


stats

“stats” GstStructure *

Sink Statistics

Flags : Read

Default value :

application/x-gst-base-sink-stats, average-rate=(double)0, dropped=(guint64)0, rendered=(guint64)0;

sync

“sync” gboolean *

Sync on the clock

Flags : Read / Write

Default value : true


throttle-time

“throttle-time” guint64 *

The time to keep between rendered buffers (0 = disabled)

Flags : Read / Write

Default value : 0


ts-offset

“ts-offset” gint64 *

Timestamp offset in nanoseconds

Flags : Read / Write

Default value : 0


ttl

“ttl” gint *

Used for setting the unicast TTL parameter

Flags : Read / Write

Default value : 64


ttl-mc

“ttl-mc” gint *

Used for setting the multicast TTL parameter

Flags : Read / Write

Default value : 1


used-socket

“used-socket” GSocket *

Socket currently in use for UDP sending. (NULL == no socket)

Flags : Read


used-socket-v6

“used-socket-v6” GSocket *

Socket currently in use for UDPv6 sending. (NULL == no socket)

Flags : Read


The results of the search are