ristsrc

ristsrc

Properties

gchar * address Read / Write
gchar * cname Read / Write
gdouble max-rtcp-bandwidth Read / Write / Construct
guint max-rtx-retries Read / Write / Construct
guint min-rtcp-interval Read / Write / Construct
gchar * multicast-iface Read / Write
gboolean multicast-loopback Read / Write / Construct
gint multicast-ttl Read / Write / Construct
guint port Read / Write / Construct
guint receiver-buffer Read / Write / Construct
guint reorder-section Read / Write / Construct
GstStructure * stats Read
guint stats-update-interval Read / Write / Construct

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstBin
                    ╰── GstRistSrc

Implemented Interfaces

GstRistSrc implements GstChildProxy and GstURIHandler.

Description

This element implements RIST TR-06-1 Simple Profile receiver. The stream produced by this element will be RTP payloaded. This element also implement the URI scheme rist:// allowing to render RIST streams in GStreamer based media players. The RIST uri handler also allow setting propertied through the URI query.

Example launch line

1
2
gst-launch-1.0 ristsrc address=0.0.0.0 port=5004 ! rtpmp2depay ! udpsink
gst-play-1.0 "rist://0.0.0.0:5004?receiver-buffer=700"

Synopsis

Element Information

plugin

rist

author

Nicolas Dufresne <nicolas.dufresne@collabora.com

class

Source/Network

Element Pads

name

src

direction

source

presence

always

details

application/x-rtp

Functions

Types and Values

GstRistSrc

typedef struct _GstRistSrc GstRistSrc;

Property Details

The “address” property

  “address”                  gchar *

Address to receive packets from (can be IPv4 or IPv6).

Flags: Read / Write

Default value: "0.0.0.0"


The “cname” property

  “cname”                    gchar *

Set the CNAME in the SDES block of the receiver report.

Flags: Read / Write

Default value: NULL


The “max-rtcp-bandwidth” property

  “max-rtcp-bandwidth”       gdouble

The maximum bandwidth used for RTCP in fraction of RTP bandwdith.

Flags: Read / Write / Construct

Allowed values: [0,0.05]

Default value: 0.05


The “max-rtx-retries” property

  “max-rtx-retries”          guint

The maximum number of retransmission requests for a lost packet.

Flags: Read / Write / Construct

Default value: 7


The “min-rtcp-interval” property

  “min-rtcp-interval”        guint

The minimum interval in ms between two successive RTCP packets.

Flags: Read / Write / Construct

Allowed values: <= 100

Default value: 100


The “multicast-iface” property

  “multicast-iface”          gchar *

The multicast interface to use to send packets.

Flags: Read / Write

Default value: NULL


The “multicast-loopback” property

  “multicast-loopback”       gboolean

When enabled, the packet will be received locally.

Flags: Read / Write / Construct

Default value: FALSE


The “multicast-ttl” property

  “multicast-ttl”            gint

The multicast time-to-live parameter.

Flags: Read / Write / Construct

Allowed values: [0,255]

Default value: 1


The “port” property

  “port”                     guint

The port to listen for RTP packets, RTCP port is derived from it, this port must be an even number.

Flags: Read / Write / Construct

Allowed values: [2,65534]

Default value: 5004


The “receiver-buffer” property

  “receiver-buffer”          guint

Buffering duration in ms.

Flags: Read / Write / Construct

Default value: 1000


The “reorder-section” property

  “reorder-section”          guint

Time to wait before sending retransmission request in ms.

Flags: Read / Write / Construct

Default value: 70


The “stats” property

  “stats”                    GstStructure *

Statistic in a GstStructure named 'rist/x-receiver-stats'.

Flags: Read


The “stats-update-interval” property

  “stats-update-interval”    guint

The interval between 'stats' update notification (0 disabled).

Flags: Read / Write / Construct

Default value: 0

See Also

ristsink