← Back to branch summary

~ubuntu-branches/ubuntu/precise/gst-plugins-bad0.10/precise-proposed

« back to all changes in this revision

Viewing changes to docs/plugins/html/gst-plugins-bad-plugins-gstrtpbin.html

Tags: upstream-0.10.5.3
Import upstream version 0.10.5.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/plugins/html/gst-plugins-bad-plugins-gstrtpbin.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>gstrtpbin</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.71.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GStreamer Bad Plugins 0.10 Plugins Reference Manual">
8
8
<link rel="up" href="ch01.html" title="gst-plugins-bad Elements">
9
 
<link rel="prev" href="gst-plugins-bad-plugins-rgvolume.html" title="rgvolume">
10
 
<link rel="next" href="gst-plugins-bad-plugins-gstrtpjitterbuffer.html" title="gstrtpjitterbuffer">
 
9
<link rel="prev" href="gst-plugins-bad-plugins-festival.html" title="festival">
 
10
<link rel="next" href="gst-plugins-bad-plugins-gstrtpclient.html" title="gstrtpclient">
11
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="gst-plugins-bad Elements">
14
14
<link rel="chapter" href="ch02.html" title="gst-plugins-bad Plugins">
 
15
<link rel="chapter" href="ch03.html" title="gst-plugins-bad Classes">
15
16
</head>
16
17
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
17
18
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
18
19
<tr valign="middle">
19
 
<td><a accesskey="p" href="gst-plugins-bad-plugins-rgvolume.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
20
<td><a accesskey="p" href="gst-plugins-bad-plugins-festival.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
20
21
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
21
22
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
22
23
<th width="100%" align="center">GStreamer Bad Plugins 0.10 Plugins Reference Manual</th>
23
 
<td><a accesskey="n" href="gst-plugins-bad-plugins-gstrtpjitterbuffer.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
24
<td><a accesskey="n" href="gst-plugins-bad-plugins-gstrtpclient.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
24
25
</tr>
25
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id320608" class="shortcut">Top</a>
26
 
                  &#160;|&#160;
27
 
                  <a href="#id355780" class="shortcut">Description</a>
28
 
                  &#160;|&#160;
29
 
                  <a href="#id354471" class="shortcut">Object Hierarchy</a>
30
 
                  &#160;|&#160;
31
 
                  <a href="#id354509" class="shortcut">Implemented Interfaces</a>
32
 
                  &#160;|&#160;
33
 
                  <a href="#id355721" class="shortcut">Properties</a>
34
 
                  &#160;|&#160;
35
 
                  <a href="#id355751" class="shortcut">Signals</a></nobr></td></tr>
 
26
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2560144" class="shortcut">Top</a>
 
27
                  &#160;|&#160;
 
28
                  <a href="#id2566600" class="shortcut">Description</a>
 
29
                  &#160;|&#160;
 
30
                  <a href="#id2560103" class="shortcut">Object Hierarchy</a>
 
31
                  &#160;|&#160;
 
32
                  <a href="#id2560070" class="shortcut">Implemented Interfaces</a>
 
33
                  &#160;|&#160;
 
34
                  <a href="#id2560054" class="shortcut">Properties</a>
 
35
                  &#160;|&#160;
 
36
                  <a href="#id2559971" class="shortcut">Signals</a></nobr></td></tr>
36
37
</table>
37
38
<div class="refentry" lang="en">
38
39
<a name="gst-plugins-bad-plugins-gstrtpbin"></a><div class="titlepage"></div>
39
40
<div class="refnamediv"><table width="100%"><tr>
40
41
<td valign="top">
41
42
<h2>
42
 
<a name="id320608"></a><span class="refentrytitle">gstrtpbin</span>
 
43
<a name="id2560144"></a><span class="refentrytitle">gstrtpbin</span>
43
44
</h2>
44
45
<p>gstrtpbin &#8212; handle media from one RTP bin</p>
45
46
</td>
47
48
</tr></table></div>
48
49
<div class="refsynopsisdiv">
49
50
<h2>Synopsis</h2>
50
 
<a name="GstRTPBin"></a><pre class="synopsis">
51
 
 
52
 
 
53
 
 
54
 
                    <a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRTPBin-struct">GstRTPBin</a>;
 
51
<a name="GstRtpBin"></a><pre class="synopsis">
 
52
 
 
53
 
 
54
 
 
55
                    <a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-struct">GstRtpBin</a>;
55
56
 
56
57
</pre>
57
58
</div>
58
59
<div class="refsect1" lang="en">
59
 
<a name="id354471"></a><h2>Object Hierarchy</h2>
 
60
<a name="id2560103"></a><h2>Object Hierarchy</h2>
60
61
<pre class="synopsis">
61
62
 
62
63
  GObject
63
 
   +----<a
64
 
href="/home/jan/.install/share/gtk-doc/html/gstreamer/GstObject.html"
65
 
>GstObject</a>
66
 
         +----<a
67
 
href="/home/jan/.install/share/gtk-doc/html/gstreamer/GstElement.html"
68
 
>GstElement</a>
69
 
               +----<a
70
 
href="/home/jan/.install/share/gtk-doc/html/gstreamer/GstBin.html"
71
 
>GstBin</a>
72
 
                     +----GstRTPBin
 
64
   +----GstObject
 
65
         +----GstElement
 
66
               +----GstBin
 
67
                     +----GstRtpBin
73
68
</pre>
74
69
</div>
75
70
<div class="refsect1" lang="en">
76
 
<a name="id354509"></a><h2>Implemented Interfaces</h2>
 
71
<a name="id2560070"></a><h2>Implemented Interfaces</h2>
77
72
<p>
78
 
GstRTPBin implements
79
 
 <a
80
 
href="/home/jan/.install/share/gtk-doc/html/gstreamer/GstChildProxy.html"
81
 
>GstChildProxy</a>.</p>
82
 
</div>
83
 
<div class="refsect1" lang="en">
84
 
<a name="id355721"></a><h2>Properties</h2>
85
 
<pre class="synopsis">
86
 
 
87
 
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRTPBin--latency">latency</a>"                  guint                 : Read / Write
88
 
</pre>
89
 
</div>
90
 
<div class="refsect1" lang="en">
91
 
<a name="id355751"></a><h2>Signals</h2>
92
 
<pre class="synopsis">
93
 
 
94
 
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRTPBin-clear-pt-map">clear-pt-map</a>"                                   : Action
95
 
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRTPBin-request-pt-map">request-pt-map</a>"                                 : Run Last
96
 
</pre>
97
 
</div>
98
 
<div class="refsect1" lang="en">
99
 
<a name="id355780"></a><h2>Description</h2>
 
73
GstRtpBin implements
 
74
 GstChildProxy.</p>
 
75
</div>
 
76
<div class="refsect1" lang="en">
 
77
<a name="id2560054"></a><h2>Properties</h2>
 
78
<pre class="synopsis">
 
79
 
 
80
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--latency">latency</a>"                  guint                 : Read / Write
 
81
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--sdes-cname">sdes-cname</a>"               gchar*                : Read / Write
 
82
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--sdes-email">sdes-email</a>"               gchar*                : Read / Write
 
83
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--sdes-location">sdes-location</a>"            gchar*                : Read / Write
 
84
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--sdes-name">sdes-name</a>"                gchar*                : Read / Write
 
85
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--sdes-note">sdes-note</a>"                gchar*                : Read / Write
 
86
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--sdes-phone">sdes-phone</a>"               gchar*                : Read / Write
 
87
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin--sdes-tool">sdes-tool</a>"                gchar*                : Read / Write
 
88
</pre>
 
89
</div>
 
90
<div class="refsect1" lang="en">
 
91
<a name="id2559971"></a><h2>Signals</h2>
 
92
<pre class="synopsis">
 
93
 
 
94
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-clear-pt-map">clear-pt-map</a>"                                   : Run Last / Action
 
95
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-bye-ssrc">on-bye-ssrc</a>"                                    : Run Last
 
96
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-bye-timeout">on-bye-timeout</a>"                                 : Run Last
 
97
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-new-ssrc">on-new-ssrc</a>"                                    : Run Last
 
98
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-ssrc-active">on-ssrc-active</a>"                                 : Run Last
 
99
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-ssrc-collision">on-ssrc-collision</a>"                              : Run Last
 
100
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-ssrc-sdes">on-ssrc-sdes</a>"                                   : Run Last
 
101
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-ssrc-validated">on-ssrc-validated</a>"                              : Run Last
 
102
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-on-timeout">on-timeout</a>"                                     : Run Last
 
103
  "<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin-request-pt-map">request-pt-map</a>"                                 : Run Last
 
104
</pre>
 
105
</div>
 
106
<div class="refsect1" lang="en">
 
107
<a name="id2566600"></a><h2>Description</h2>
100
108
<p>
101
109
</p>
102
110
<div class="refsect2" lang="en">
103
 
<a name="id355793"></a><p>
 
111
<a name="id2566603"></a><p>
104
112
RTP bin combines the functions of gstrtpsession, gstrtpssrcdemux, gstrtpjitterbuffer
105
113
and gstrtpptdemux in one element. It allows for multiple RTP sessions that will
106
114
be synchronized together using RTCP SR packets.
133
141
</p>
134
142
<p>
135
143
To use gstrtpbin as a sender, request a send_rtp_sink_%<code class="literal">d</code> pad, which will
136
 
automatically create a send_rtp_src_%<code class="literal">d</code> pad. The session number must be specified when
137
 
requesting the sink pad. The session manager will modify the
 
144
automatically create a send_rtp_src_%<code class="literal">d</code> pad. If the session number is not provided,
 
145
the pad from the lowest available session will be returned. The session manager will modify the
138
146
SSRC in the RTP packets to its own SSRC and wil forward the packets on the
139
147
send_rtp_src_%<code class="literal">d</code> pad after updating its internal state.
140
148
</p>
141
149
<p>
142
150
The session manager needs the clock-rate of the payload types it is handling
143
 
and will signal the GstRTPSession::request-pt-map signal when it needs such a
144
 
mapping. One can clear the cached values with the GstRTPSession::clear-pt-map
 
151
and will signal the GstRtpSession::request-pt-map signal when it needs such a
 
152
mapping. One can clear the cached values with the GstRtpSession::clear-pt-map
145
153
signal.
146
154
</p>
147
155
<h3>Example pipelines</h3>
154
162
<p>
155
163
Receive RTP data from port 5000 and send to the session 0 in gstrtpbin.
156
164
</p>
 
165
<p>
 
166
</p>
 
167
<pre class="programlisting">
 
168
gst-launch gstrtpbin name=rtpbin \
 
169
        v4l2src ! ffmpegcolorspace ! ffenc_h263 ! rtph263ppay ! rtpbin.send_rtp_sink_0 \
 
170
                  rtpbin.send_rtp_src_0 ! udpsink port=5000                            \
 
171
                  rtpbin.send_rtcp_src_0 ! udpsink port=5001 sync=false async=false    \
 
172
                  udpsrc port=5005 ! rtpbin.recv_rtcp_sink_0                           \
 
173
        audiotestsrc ! amrnbenc ! rtpamrpay ! rtpbin.send_rtp_sink_1                   \
 
174
                  rtpbin.send_rtp_src_1 ! udpsink port=5002                            \
 
175
                  rtpbin.send_rtcp_src_1 ! udpsink port=5003 sync=false async=false    \
 
176
                  udpsrc port=5007 ! rtpbin.recv_rtcp_sink_1
 
177
</pre>
 
178
<p>
 
179
Encode and payload H263 video captured from a v4l2src. Encode and payload AMR
 
180
audio generated from audiotestsrc. The video is sent to session 0 in rtpbin
 
181
and the audio is sent to session 1. Video packets are sent on UDP port 5000
 
182
and audio packets on port 5002. The video RTCP packets for session 0 are sent
 
183
on port 5001 and the audio RTCP packets for session 0 are sent on port 5003.
 
184
RTCP packets for session 0 are received on port 5005 and RTCP for session 1
 
185
is received on port 5007. Since RTCP packets from the sender should be sent
 
186
as soon as possible and do not participate in preroll, sync=false and 
 
187
async=false is configured on udpsink
 
188
</p>
 
189
<p>
 
190
</p>
 
191
<pre class="programlisting">
 
192
 gst-launch -v gstrtpbin name=rtpbin                                          \
 
193
    udpsrc caps="application/x-rtp,media=(string)video,clock-rate=(int)90000,encoding-name=(string)H263-1998" \
 
194
            port=5000 ! rtpbin.recv_rtp_sink_0                                \
 
195
        rtpbin. ! rtph263pdepay ! ffdec_h263 ! xvimagesink                    \
 
196
     udpsrc port=5001 ! rtpbin.recv_rtcp_sink_0                               \
 
197
     rtpbin.send_rtcp_src_0 ! udpsink port=5005 sync=false async=false        \
 
198
    udpsrc caps="application/x-rtp,media=(string)audio,clock-rate=(int)8000,encoding-name=(string)AMR,encoding-params=(string)1,octet-align=(string)1" \
 
199
            port=5002 ! rtpbin.recv_rtp_sink_1                                \
 
200
        rtpbin. ! rtpamrdepay ! amrnbdec ! alsasink                           \
 
201
     udpsrc port=5003 ! rtpbin.recv_rtcp_sink_1                               \
 
202
     rtpbin.send_rtcp_src_1 ! udpsink port=5007 sync=false async=false
 
203
</pre>
 
204
<p>
 
205
Receive H263 on port 5000, send it through rtpbin in session 0, depayload,
 
206
decode and display the video.
 
207
Receive AMR on port 5002, send it through rtpbin in session 1, depayload,
 
208
decode and play the audio.
 
209
Receive server RTCP packets for session 0 on port 5001 and RTCP packets for
 
210
session 1 on port 5003. These packets will be used for session management and
 
211
synchronisation.
 
212
Send RTCP reports for session 0 on port 5005 and RTCP reports for session 1
 
213
on port 5007.
 
214
</p>
157
215
</div>
158
216
<p>
159
217
</p>
160
218
<p>
161
 
Last reviewed on 2007-05-28 (0.10.5)</p>
 
219
Last reviewed on 2007-08-30 (0.10.6)</p>
162
220
<div class="refsect2" lang="en">
163
 
<a name="id340044"></a><h3>Element Information</h3>
 
221
<a name="id2594075"></a><h3>Element Information</h3>
164
222
<div class="variablelist"><table border="0">
165
223
<col align="left" valign="top">
166
224
<tbody>
172
230
</tr>
173
231
<tr>
174
232
<td><span class="term">author</span></td>
175
 
<td>Wim Taymans &lt;wim@fluendo.com&gt;</td>
 
233
<td>Wim Taymans &lt;wim.taymans@gmail.com&gt;</td>
176
234
</tr>
177
235
<tr>
178
236
<td><span class="term">class</span></td>
180
238
</tr>
181
239
</tbody>
182
240
</table></div>
183
 
</div>
184
 
<p>
185
 
 
186
 
</p>
187
 
</div>
188
 
<div class="refsect1" lang="en">
189
 
<a name="id340112"></a><h2>Details</h2>
190
 
<div class="refsect2" lang="en">
191
 
<a name="id340123"></a><h3>
192
 
<a name="GstRTPBin-struct"></a>GstRTPBin</h3>
193
 
<a class="indexterm" name="id340135"></a><pre class="programlisting">typedef struct _GstRTPBin GstRTPBin;</pre>
194
 
<p>
195
 
 
196
 
</p>
197
 
</div>
198
 
</div>
199
 
<div class="refsect1" lang="en">
200
 
<a name="id340151"></a><h2>Property Details</h2>
201
 
<div class="refsect2" lang="en">
202
 
<a name="id340162"></a><h3>
203
 
<a name="GstRTPBin--latency"></a>The "<code class="literal">latency</code>" property</h3>
204
 
<a class="indexterm" name="id340176"></a><pre class="programlisting">  "latency"                  guint                 : Read / Write</pre>
 
241
<h3>Element Pads</h3>
 
242
<div class="variablelist"><table border="0">
 
243
<col align="left" valign="top">
 
244
<tbody>
 
245
<tr>
 
246
<td><span class="term">name</span></td>
 
247
<td>send_rtp_src_%d</td>
 
248
</tr>
 
249
<tr>
 
250
<td><span class="term">direction</span></td>
 
251
<td>source</td>
 
252
</tr>
 
253
<tr>
 
254
<td><span class="term">presence</span></td>
 
255
<td>sometimes</td>
 
256
</tr>
 
257
<tr>
 
258
<td><span class="term">details</span></td>
 
259
<td>application/x-rtp</td>
 
260
</tr>
 
261
</tbody>
 
262
</table></div>
 
263
<div class="variablelist"><table border="0">
 
264
<col align="left" valign="top">
 
265
<tbody>
 
266
<tr>
 
267
<td><span class="term">name</span></td>
 
268
<td>send_rtcp_src_%d</td>
 
269
</tr>
 
270
<tr>
 
271
<td><span class="term">direction</span></td>
 
272
<td>source</td>
 
273
</tr>
 
274
<tr>
 
275
<td><span class="term">presence</span></td>
 
276
<td>request</td>
 
277
</tr>
 
278
<tr>
 
279
<td><span class="term">details</span></td>
 
280
<td>application/x-rtcp</td>
 
281
</tr>
 
282
</tbody>
 
283
</table></div>
 
284
<div class="variablelist"><table border="0">
 
285
<col align="left" valign="top">
 
286
<tbody>
 
287
<tr>
 
288
<td><span class="term">name</span></td>
 
289
<td>recv_rtp_src_%d_%d_%d</td>
 
290
</tr>
 
291
<tr>
 
292
<td><span class="term">direction</span></td>
 
293
<td>source</td>
 
294
</tr>
 
295
<tr>
 
296
<td><span class="term">presence</span></td>
 
297
<td>sometimes</td>
 
298
</tr>
 
299
<tr>
 
300
<td><span class="term">details</span></td>
 
301
<td>application/x-rtp</td>
 
302
</tr>
 
303
</tbody>
 
304
</table></div>
 
305
<div class="variablelist"><table border="0">
 
306
<col align="left" valign="top">
 
307
<tbody>
 
308
<tr>
 
309
<td><span class="term">name</span></td>
 
310
<td>send_rtp_sink_%d</td>
 
311
</tr>
 
312
<tr>
 
313
<td><span class="term">direction</span></td>
 
314
<td>sink</td>
 
315
</tr>
 
316
<tr>
 
317
<td><span class="term">presence</span></td>
 
318
<td>request</td>
 
319
</tr>
 
320
<tr>
 
321
<td><span class="term">details</span></td>
 
322
<td>application/x-rtp</td>
 
323
</tr>
 
324
</tbody>
 
325
</table></div>
 
326
<div class="variablelist"><table border="0">
 
327
<col align="left" valign="top">
 
328
<tbody>
 
329
<tr>
 
330
<td><span class="term">name</span></td>
 
331
<td>recv_rtcp_sink_%d</td>
 
332
</tr>
 
333
<tr>
 
334
<td><span class="term">direction</span></td>
 
335
<td>sink</td>
 
336
</tr>
 
337
<tr>
 
338
<td><span class="term">presence</span></td>
 
339
<td>request</td>
 
340
</tr>
 
341
<tr>
 
342
<td><span class="term">details</span></td>
 
343
<td>application/x-rtcp</td>
 
344
</tr>
 
345
</tbody>
 
346
</table></div>
 
347
<div class="variablelist"><table border="0">
 
348
<col align="left" valign="top">
 
349
<tbody>
 
350
<tr>
 
351
<td><span class="term">name</span></td>
 
352
<td>recv_rtp_sink_%d</td>
 
353
</tr>
 
354
<tr>
 
355
<td><span class="term">direction</span></td>
 
356
<td>sink</td>
 
357
</tr>
 
358
<tr>
 
359
<td><span class="term">presence</span></td>
 
360
<td>request</td>
 
361
</tr>
 
362
<tr>
 
363
<td><span class="term">details</span></td>
 
364
<td>application/x-rtp</td>
 
365
</tr>
 
366
</tbody>
 
367
</table></div>
 
368
</div>
 
369
<p>
 
370
 
 
371
</p>
 
372
</div>
 
373
<div class="refsect1" lang="en">
 
374
<a name="id2626800"></a><h2>Details</h2>
 
375
<div class="refsect2" lang="en">
 
376
<a name="id2626810"></a><h3>
 
377
<a name="GstRtpBin-struct"></a>GstRtpBin</h3>
 
378
<a class="indexterm" name="id2626823"></a><pre class="programlisting">typedef struct _GstRtpBin GstRtpBin;</pre>
 
379
<p>
 
380
 
 
381
</p>
 
382
</div>
 
383
</div>
 
384
<div class="refsect1" lang="en">
 
385
<a name="id2626839"></a><h2>Property Details</h2>
 
386
<div class="refsect2" lang="en">
 
387
<a name="id2626850"></a><h3>
 
388
<a name="GstRtpBin--latency"></a>The "<code class="literal">latency</code>" property</h3>
 
389
<a class="indexterm" name="id2626865"></a><pre class="programlisting">  "latency"                  guint                 : Read / Write</pre>
205
390
<p>Default amount of ms to buffer in the jitterbuffers.</p>
206
391
<p>Default value: 200</p>
207
392
</div>
 
393
<hr>
 
394
<div class="refsect2" lang="en">
 
395
<a name="id2626892"></a><h3>
 
396
<a name="GstRtpBin--sdes-cname"></a>The "<code class="literal">sdes-cname</code>" property</h3>
 
397
<a class="indexterm" name="id2626906"></a><pre class="programlisting">  "sdes-cname"               gchar*                : Read / Write</pre>
 
398
<p>The CNAME to put in SDES messages of this session.</p>
 
399
<p>Default value: NULL</p>
 
400
</div>
 
401
<hr>
 
402
<div class="refsect2" lang="en">
 
403
<a name="id2626932"></a><h3>
 
404
<a name="GstRtpBin--sdes-email"></a>The "<code class="literal">sdes-email</code>" property</h3>
 
405
<a class="indexterm" name="id2626946"></a><pre class="programlisting">  "sdes-email"               gchar*                : Read / Write</pre>
 
406
<p>The EMAIL to put in SDES messages of this session.</p>
 
407
<p>Default value: NULL</p>
 
408
</div>
 
409
<hr>
 
410
<div class="refsect2" lang="en">
 
411
<a name="id2626973"></a><h3>
 
412
<a name="GstRtpBin--sdes-location"></a>The "<code class="literal">sdes-location</code>" property</h3>
 
413
<a class="indexterm" name="id2626987"></a><pre class="programlisting">  "sdes-location"            gchar*                : Read / Write</pre>
 
414
<p>The LOCATION to put in SDES messages of this session.</p>
 
415
<p>Default value: NULL</p>
 
416
</div>
 
417
<hr>
 
418
<div class="refsect2" lang="en">
 
419
<a name="id2627014"></a><h3>
 
420
<a name="GstRtpBin--sdes-name"></a>The "<code class="literal">sdes-name</code>" property</h3>
 
421
<a class="indexterm" name="id2627028"></a><pre class="programlisting">  "sdes-name"                gchar*                : Read / Write</pre>
 
422
<p>The NAME to put in SDES messages of this session.</p>
 
423
<p>Default value: NULL</p>
 
424
</div>
 
425
<hr>
 
426
<div class="refsect2" lang="en">
 
427
<a name="id2627055"></a><h3>
 
428
<a name="GstRtpBin--sdes-note"></a>The "<code class="literal">sdes-note</code>" property</h3>
 
429
<a class="indexterm" name="id2627068"></a><pre class="programlisting">  "sdes-note"                gchar*                : Read / Write</pre>
 
430
<p>The NOTE to put in SDES messages of this session.</p>
 
431
<p>Default value: NULL</p>
 
432
</div>
 
433
<hr>
 
434
<div class="refsect2" lang="en">
 
435
<a name="id2627096"></a><h3>
 
436
<a name="GstRtpBin--sdes-phone"></a>The "<code class="literal">sdes-phone</code>" property</h3>
 
437
<a class="indexterm" name="id2627109"></a><pre class="programlisting">  "sdes-phone"               gchar*                : Read / Write</pre>
 
438
<p>The PHONE to put in SDES messages of this session.</p>
 
439
<p>Default value: NULL</p>
 
440
</div>
 
441
<hr>
 
442
<div class="refsect2" lang="en">
 
443
<a name="id2627136"></a><h3>
 
444
<a name="GstRtpBin--sdes-tool"></a>The "<code class="literal">sdes-tool</code>" property</h3>
 
445
<a class="indexterm" name="id2627150"></a><pre class="programlisting">  "sdes-tool"                gchar*                : Read / Write</pre>
 
446
<p>The TOOL to put in SDES messages of this session.</p>
 
447
<p>Default value: NULL</p>
 
448
</div>
208
449
</div>
209
450
<div class="refsect1" lang="en">
210
 
<a name="id340203"></a><h2>Signal Details</h2>
 
451
<a name="id2627178"></a><h2>Signal Details</h2>
211
452
<div class="refsect2" lang="en">
212
 
<a name="id340213"></a><h3>
213
 
<a name="GstRTPBin-clear-pt-map"></a>The "clear-pt-map" signal</h3>
214
 
<a class="indexterm" name="id340222"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRTPBin">GstRTPBin</a> *rtpbin,
215
 
                                                        gpointer   user_data)      : Action</pre>
 
453
<a name="id2627189"></a><h3>
 
454
<a name="GstRtpBin-clear-pt-map"></a>The "clear-pt-map" signal</h3>
 
455
<a class="indexterm" name="id2627197"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
456
                                                        gpointer   user_data)      : Run Last / Action</pre>
216
457
<p>
217
458
Clear all previously cached pt-mapping obtained with
218
 
GstRTPBin::request-pt-map.</p>
219
 
<p>
220
 
 
221
 
</p>
222
 
<div class="variablelist"><table border="0">
223
 
<col align="left" valign="top">
224
 
<tbody>
225
 
<tr>
226
 
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
227
 
<td> the object which received the signal
228
 
</td>
229
 
</tr>
230
 
<tr>
231
 
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
232
 
<td>user data set when the signal handler was connected.</td>
233
 
</tr>
234
 
</tbody>
235
 
</table></div>
236
 
</div>
237
 
<hr>
238
 
<div class="refsect2" lang="en">
239
 
<a name="id358423"></a><h3>
240
 
<a name="GstRTPBin-request-pt-map"></a>The "request-pt-map" signal</h3>
241
 
<a class="indexterm" name="id358432"></a><pre class="programlisting"><a
242
 
href="/home/jan/.install/share/gtk-doc/html/gstreamer/gstreamer-GstCaps.html#GstCaps"
243
 
>GstCaps</a>*            user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRTPBin">GstRTPBin</a> *rtpbin,
 
459
GstRtpBin::request-pt-map.</p>
 
460
<p>
 
461
 
 
462
</p>
 
463
<div class="variablelist"><table border="0">
 
464
<col align="left" valign="top">
 
465
<tbody>
 
466
<tr>
 
467
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
468
<td> the object which received the signal
 
469
</td>
 
470
</tr>
 
471
<tr>
 
472
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
473
<td>user data set when the signal handler was connected.</td>
 
474
</tr>
 
475
</tbody>
 
476
</table></div>
 
477
</div>
 
478
<hr>
 
479
<div class="refsect2" lang="en">
 
480
<a name="id2627268"></a><h3>
 
481
<a name="GstRtpBin-on-bye-ssrc"></a>The "on-bye-ssrc" signal</h3>
 
482
<a class="indexterm" name="id2627275"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
483
                                                        guint      session,
 
484
                                                        guint      ssrc,
 
485
                                                        gpointer   user_data)      : Run Last</pre>
 
486
<p>
 
487
Notify of an SSRC that became inactive because of a BYE packet.</p>
 
488
<p>
 
489
 
 
490
</p>
 
491
<div class="variablelist"><table border="0">
 
492
<col align="left" valign="top">
 
493
<tbody>
 
494
<tr>
 
495
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
496
<td> the object which received the signal
 
497
</td>
 
498
</tr>
 
499
<tr>
 
500
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
501
<td> the session
 
502
</td>
 
503
</tr>
 
504
<tr>
 
505
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
506
<td> the SSRC 
 
507
</td>
 
508
</tr>
 
509
<tr>
 
510
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
511
<td>user data set when the signal handler was connected.</td>
 
512
</tr>
 
513
</tbody>
 
514
</table></div>
 
515
</div>
 
516
<hr>
 
517
<div class="refsect2" lang="en">
 
518
<a name="id2627389"></a><h3>
 
519
<a name="GstRtpBin-on-bye-timeout"></a>The "on-bye-timeout" signal</h3>
 
520
<a class="indexterm" name="id2627397"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
521
                                                        guint      session,
 
522
                                                        guint      ssrc,
 
523
                                                        gpointer   user_data)      : Run Last</pre>
 
524
<p>
 
525
Notify of an SSRC that has timed out because of BYE</p>
 
526
<p>
 
527
 
 
528
</p>
 
529
<div class="variablelist"><table border="0">
 
530
<col align="left" valign="top">
 
531
<tbody>
 
532
<tr>
 
533
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
534
<td> the object which received the signal
 
535
</td>
 
536
</tr>
 
537
<tr>
 
538
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
539
<td> the session
 
540
</td>
 
541
</tr>
 
542
<tr>
 
543
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
544
<td> the SSRC 
 
545
</td>
 
546
</tr>
 
547
<tr>
 
548
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
549
<td>user data set when the signal handler was connected.</td>
 
550
</tr>
 
551
</tbody>
 
552
</table></div>
 
553
</div>
 
554
<hr>
 
555
<div class="refsect2" lang="en">
 
556
<a name="id2627511"></a><h3>
 
557
<a name="GstRtpBin-on-new-ssrc"></a>The "on-new-ssrc" signal</h3>
 
558
<a class="indexterm" name="id2627518"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
559
                                                        guint      session,
 
560
                                                        guint      ssrc,
 
561
                                                        gpointer   user_data)      : Run Last</pre>
 
562
<p>
 
563
Notify of a new SSRC that entered <em class="parameter"><code>session</code></em>.</p>
 
564
<p>
 
565
 
 
566
</p>
 
567
<div class="variablelist"><table border="0">
 
568
<col align="left" valign="top">
 
569
<tbody>
 
570
<tr>
 
571
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
572
<td> the object which received the signal
 
573
</td>
 
574
</tr>
 
575
<tr>
 
576
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
577
<td> the session
 
578
</td>
 
579
</tr>
 
580
<tr>
 
581
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
582
<td> the SSRC 
 
583
</td>
 
584
</tr>
 
585
<tr>
 
586
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
587
<td>user data set when the signal handler was connected.</td>
 
588
</tr>
 
589
</tbody>
 
590
</table></div>
 
591
</div>
 
592
<hr>
 
593
<div class="refsect2" lang="en">
 
594
<a name="id2627638"></a><h3>
 
595
<a name="GstRtpBin-on-ssrc-active"></a>The "on-ssrc-active" signal</h3>
 
596
<a class="indexterm" name="id2627645"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
597
                                                        guint      session,
 
598
                                                        guint      ssrc,
 
599
                                                        gpointer   user_data)      : Run Last</pre>
 
600
<p>
 
601
Notify of a SSRC that is active, i.e., sending RTCP.</p>
 
602
<p>
 
603
 
 
604
</p>
 
605
<div class="variablelist"><table border="0">
 
606
<col align="left" valign="top">
 
607
<tbody>
 
608
<tr>
 
609
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
610
<td> the object which received the signal
 
611
</td>
 
612
</tr>
 
613
<tr>
 
614
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
615
<td> the session
 
616
</td>
 
617
</tr>
 
618
<tr>
 
619
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
620
<td> the SSRC
 
621
</td>
 
622
</tr>
 
623
<tr>
 
624
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
625
<td>user data set when the signal handler was connected.</td>
 
626
</tr>
 
627
</tbody>
 
628
</table></div>
 
629
</div>
 
630
<hr>
 
631
<div class="refsect2" lang="en">
 
632
<a name="id2627760"></a><h3>
 
633
<a name="GstRtpBin-on-ssrc-collision"></a>The "on-ssrc-collision" signal</h3>
 
634
<a class="indexterm" name="id2627768"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
635
                                                        guint      session,
 
636
                                                        guint      ssrc,
 
637
                                                        gpointer   user_data)      : Run Last</pre>
 
638
<p>
 
639
Notify when we have an SSRC collision</p>
 
640
<p>
 
641
 
 
642
</p>
 
643
<div class="variablelist"><table border="0">
 
644
<col align="left" valign="top">
 
645
<tbody>
 
646
<tr>
 
647
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
648
<td> the object which received the signal
 
649
</td>
 
650
</tr>
 
651
<tr>
 
652
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
653
<td> the session
 
654
</td>
 
655
</tr>
 
656
<tr>
 
657
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
658
<td> the SSRC 
 
659
</td>
 
660
</tr>
 
661
<tr>
 
662
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
663
<td>user data set when the signal handler was connected.</td>
 
664
</tr>
 
665
</tbody>
 
666
</table></div>
 
667
</div>
 
668
<hr>
 
669
<div class="refsect2" lang="en">
 
670
<a name="id2627883"></a><h3>
 
671
<a name="GstRtpBin-on-ssrc-sdes"></a>The "on-ssrc-sdes" signal</h3>
 
672
<a class="indexterm" name="id2627891"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
673
                                                        guint      session,
 
674
                                                        guint      ssrc,
 
675
                                                        gpointer   user_data)      : Run Last</pre>
 
676
<p>
 
677
Notify of a SSRC that is active, i.e., sending RTCP.</p>
 
678
<p>
 
679
 
 
680
</p>
 
681
<div class="variablelist"><table border="0">
 
682
<col align="left" valign="top">
 
683
<tbody>
 
684
<tr>
 
685
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
686
<td> the object which received the signal
 
687
</td>
 
688
</tr>
 
689
<tr>
 
690
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
691
<td> the session
 
692
</td>
 
693
</tr>
 
694
<tr>
 
695
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
696
<td> the SSRC
 
697
</td>
 
698
</tr>
 
699
<tr>
 
700
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
701
<td>user data set when the signal handler was connected.</td>
 
702
</tr>
 
703
</tbody>
 
704
</table></div>
 
705
</div>
 
706
<hr>
 
707
<div class="refsect2" lang="en">
 
708
<a name="id2628006"></a><h3>
 
709
<a name="GstRtpBin-on-ssrc-validated"></a>The "on-ssrc-validated" signal</h3>
 
710
<a class="indexterm" name="id2628014"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
711
                                                        guint      session,
 
712
                                                        guint      ssrc,
 
713
                                                        gpointer   user_data)      : Run Last</pre>
 
714
<p>
 
715
Notify of a new SSRC that became validated.</p>
 
716
<p>
 
717
 
 
718
</p>
 
719
<div class="variablelist"><table border="0">
 
720
<col align="left" valign="top">
 
721
<tbody>
 
722
<tr>
 
723
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
724
<td> the object which received the signal
 
725
</td>
 
726
</tr>
 
727
<tr>
 
728
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
729
<td> the session
 
730
</td>
 
731
</tr>
 
732
<tr>
 
733
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
734
<td> the SSRC 
 
735
</td>
 
736
</tr>
 
737
<tr>
 
738
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
739
<td>user data set when the signal handler was connected.</td>
 
740
</tr>
 
741
</tbody>
 
742
</table></div>
 
743
</div>
 
744
<hr>
 
745
<div class="refsect2" lang="en">
 
746
<a name="id2628129"></a><h3>
 
747
<a name="GstRtpBin-on-timeout"></a>The "on-timeout" signal</h3>
 
748
<a class="indexterm" name="id2628137"></a><pre class="programlisting">void                user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
 
749
                                                        guint      session,
 
750
                                                        guint      ssrc,
 
751
                                                        gpointer   user_data)      : Run Last</pre>
 
752
<p>
 
753
Notify of an SSRC that has timed out</p>
 
754
<p>
 
755
 
 
756
</p>
 
757
<div class="variablelist"><table border="0">
 
758
<col align="left" valign="top">
 
759
<tbody>
 
760
<tr>
 
761
<td><span class="term"><em class="parameter"><code>rtpbin</code></em>&#160;:</span></td>
 
762
<td> the object which received the signal
 
763
</td>
 
764
</tr>
 
765
<tr>
 
766
<td><span class="term"><em class="parameter"><code>session</code></em>&#160;:</span></td>
 
767
<td> the session
 
768
</td>
 
769
</tr>
 
770
<tr>
 
771
<td><span class="term"><em class="parameter"><code>ssrc</code></em>&#160;:</span></td>
 
772
<td> the SSRC 
 
773
</td>
 
774
</tr>
 
775
<tr>
 
776
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
777
<td>user data set when the signal handler was connected.</td>
 
778
</tr>
 
779
</tbody>
 
780
</table></div>
 
781
</div>
 
782
<hr>
 
783
<div class="refsect2" lang="en">
 
784
<a name="id2628251"></a><h3>
 
785
<a name="GstRtpBin-request-pt-map"></a>The "request-pt-map" signal</h3>
 
786
<a class="indexterm" name="id2628259"></a><pre class="programlisting">GstCaps*            user_function                      (<a href="gst-plugins-bad-plugins-gstrtpbin.html#GstRtpBin">GstRtpBin</a> *rtpbin,
244
787
                                                        guint      session,
245
788
                                                        guint      pt,
246
789
                                                        gpointer   user_data)      : Run Last</pre>
247
790
<p>
248
 
Request the payload type as <a
249
 
href="/home/jan/.install/share/gtk-doc/html/gstreamer/gstreamer-GstCaps.html#GstCaps"
250
 
><span class="type">GstCaps</span></a> for <em class="parameter"><code>pt</code></em> in <em class="parameter"><code>session</code></em>.</p>
 
791
Request the payload type as <span class="type">GstCaps</span> for <em class="parameter"><code>pt</code></em> in <em class="parameter"><code>session</code></em>.</p>
251
792
<p>
252
793
 
253
794
</p>
278
819
</div>
279
820
</div>
280
821
<div class="refsect1" lang="en">
281
 
<a name="id358561"></a><h2>See Also</h2>
 
822
<a name="id2628394"></a><h2>See Also</h2>
282
823
gstrtpjitterbuffer, gstrtpsession, gstrtpptdemux, gstrtpssrcdemux
283
824
</div>
284
825
</div>