Git init
[framework/multimedia/gst-plugins-good0.10.git] / docs / plugins / html / gst-plugins-good-plugins-gstrtpsession.html
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>gstrtpsession</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7 <link rel="home" href="index.html" title="GStreamer Good Plugins 0.10 Plugins Reference Manual">
8 <link rel="up" href="ch01.html" title="gst-plugins-good Elements">
9 <link rel="prev" href="gst-plugins-good-plugins-gstrtpptdemux.html" title="gstrtpptdemux">
10 <link rel="next" href="gst-plugins-good-plugins-gstrtpssrcdemux.html" title="gstrtpssrcdemux">
11 <meta name="generator" content="GTK-Doc V1.17 (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="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="gst-plugins-good-plugins-gstrtpptdemux.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GStreamer Good Plugins 0.10 Plugins Reference Manual</th>
21 <td><a accesskey="n" href="gst-plugins-good-plugins-gstrtpssrcdemux.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#gst-plugins-good-plugins-gstrtpsession.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#gst-plugins-good-plugins-gstrtpsession.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#gst-plugins-good-plugins-gstrtpsession.object-hierarchy" class="shortcut">Object Hierarchy</a>
29                    | 
30                   <a href="#gst-plugins-good-plugins-gstrtpsession.properties" class="shortcut">Properties</a>
31                    | 
32                   <a href="#gst-plugins-good-plugins-gstrtpsession.signals" class="shortcut">Signals</a>
33 </td></tr>
34 </table>
35 <div class="refentry">
36 <a name="gst-plugins-good-plugins-gstrtpsession"></a><div class="titlepage"></div>
37 <div class="refnamediv"><table width="100%"><tr>
38 <td valign="top">
39 <h2><span class="refentrytitle"><a name="gst-plugins-good-plugins-gstrtpsession.top_of_page"></a>gstrtpsession</span></h2>
40 <p>gstrtpsession — Implement an RTP session</p>
41 </td>
42 <td valign="top" align="right"></td>
43 </tr></table></div>
44 <div class="refsynopsisdiv">
45 <a name="gst-plugins-good-plugins-gstrtpsession.synopsis"></a><h2>Synopsis</h2>
46 <a name="GstRtpSession"></a><pre class="synopsis">struct              <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-struct" title="struct GstRtpSession">GstRtpSession</a>;
47 </pre>
48 </div>
49 <div class="refsect1">
50 <a name="gst-plugins-good-plugins-gstrtpsession.object-hierarchy"></a><h2>Object Hierarchy</h2>
51 <pre class="synopsis">
52   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
53    +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstObject.html">GstObject</a>
54          +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html">GstElement</a>
55                +----GstRtpSession
56 </pre>
57 </div>
58 <div class="refsect1">
59 <a name="gst-plugins-good-plugins-gstrtpsession.properties"></a><h2>Properties</h2>
60 <pre class="synopsis">
61   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--bandwidth" title='The "bandwidth" property'>bandwidth</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write
62   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--internal-session" title='The "internal-session" property'>internal-session</a>"         <span class="type">RTPSession</span>*           : Read
63   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--ntp-ns-base" title='The "ntp-ns-base" property'>ntp-ns-base</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a>               : Read / Write
64   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--num-active-sources" title='The "num-active-sources" property'>num-active-sources</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
65   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--num-sources" title='The "num-sources" property'>num-sources</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read
66   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--rtcp-fraction" title='The "rtcp-fraction" property'>rtcp-fraction</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write
67   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--sdes" title='The "sdes" property'>sdes</a>"                     <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstStructure.html#GstStructure"><span class="type">GstStructure</span></a>*         : Read / Write
68   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--rtcp-rr-bandwidth" title='The "rtcp-rr-bandwidth" property'>rtcp-rr-bandwidth</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
69   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--rtcp-rs-bandwidth" title='The "rtcp-rs-bandwidth" property'>rtcp-rs-bandwidth</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
70   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--use-pipeline-clock" title='The "use-pipeline-clock" property'>use-pipeline-clock</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
71   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession--rtcp-min-interval" title='The "rtcp-min-interval" property'>rtcp-min-interval</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a>               : Read / Write
72 </pre>
73 </div>
74 <div class="refsect1">
75 <a name="gst-plugins-good-plugins-gstrtpsession.signals"></a><h2>Signals</h2>
76 <pre class="synopsis">
77   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-clear-pt-map" title='The "clear-pt-map" signal'>clear-pt-map</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
78   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-bye-ssrc" title='The "on-bye-ssrc" signal'>on-bye-ssrc</a>"                                    : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
79   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-bye-timeout" title='The "on-bye-timeout" signal'>on-bye-timeout</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
80   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-new-ssrc" title='The "on-new-ssrc" signal'>on-new-ssrc</a>"                                    : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
81   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-sender-timeout" title='The "on-sender-timeout" signal'>on-sender-timeout</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
82   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-ssrc-active" title='The "on-ssrc-active" signal'>on-ssrc-active</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
83   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-ssrc-collision" title='The "on-ssrc-collision" signal'>on-ssrc-collision</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
84   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-ssrc-sdes" title='The "on-ssrc-sdes" signal'>on-ssrc-sdes</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
85   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-ssrc-validated" title='The "on-ssrc-validated" signal'>on-ssrc-validated</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
86   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-on-timeout" title='The "on-timeout" signal'>on-timeout</a>"                                     : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
87   "<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-request-pt-map" title='The "request-pt-map" signal'>request-pt-map</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
88 </pre>
89 </div>
90 <div class="refsect1">
91 <a name="gst-plugins-good-plugins-gstrtpsession.description"></a><h2>Description</h2>
92 <p>
93 The RTP session manager models one participant with a unique SSRC in an RTP
94 session. This session can be used to send and receive RTP and RTCP packets.
95 Based on what REQUEST pads are requested from the session manager, specific
96 functionality can be activated.
97 </p>
98 <p>
99 The session manager currently implements RFC 3550 including:
100 </p>
101 <div class="itemizedlist"><ul class="itemizedlist" type="disc">
102 <li class="listitem"><p>RTP packet validation based on consecutive sequence numbers.</p></li>
103 <li class="listitem"><p>Maintainance of the SSRC participant database.</p></li>
104 <li class="listitem"><p>Keeping per participant statistics based on received RTCP packets.</p></li>
105 <li class="listitem"><p>Scheduling of RR/SR RTCP packets.</p></li>
106 </ul></div>
107 <p>
108 </p>
109 <p>
110 The gstrtpsession will not demux packets based on SSRC or payload type, nor will
111 it correct for packet reordering and jitter. Use <span class="type">GstRtpsSrcDemux</span>,
112 <a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux"><span class="type">GstRtpPtDemux</span></a> and GstRtpJitterBuffer in addition to <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> to
113 perform these tasks. It is usually a good idea to use <a class="link" href="gst-plugins-good-plugins-gstrtpbin.html#GstRtpBin"><span class="type">GstRtpBin</span></a>, which
114 combines all these features in one element.
115 </p>
116 <p>
117 To use <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> as an RTP receiver, request a recv_rtp_sink pad, which will
118 automatically create recv_rtp_src pad. Data received on the recv_rtp_sink pad
119 will be processed in the session and after being validated forwarded on the
120 recv_rtp_src pad.
121 </p>
122 <p>
123 To also use <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> as an RTCP receiver, request a recv_rtcp_sink pad,
124 which will automatically create a sync_src pad. Packets received on the RTCP
125 pad will be used by the session manager to update the stats and database of
126 the other participants. SR packets will be forwarded on the sync_src pad
127 so that they can be used to perform inter-stream synchronisation when needed.
128 </p>
129 <p>
130 If you want the session manager to generate and send RTCP packets, request
131 the send_rtcp_src pad. Packet pushed on this pad contain SR/RR RTCP reports
132 that should be sent to all participants in the session.
133 </p>
134 <p>
135 To use <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> as a sender, request a send_rtp_sink pad, which will
136 automatically create a send_rtp_src pad. The session manager will modify the
137 SSRC in the RTP packets to its own SSRC and wil forward the packets on the
138 send_rtp_src pad after updating its internal state.
139 </p>
140 <p>
141 The session manager needs the clock-rate of the payload types it is handling
142 and will signal the <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-request-pt-map" title='The "request-pt-map" signal'><span class="type">"request-pt-map"</span></a> signal when it needs such a
143 mapping. One can clear the cached values with the <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-clear-pt-map" title='The "clear-pt-map" signal'><span class="type">"clear-pt-map"</span></a>
144 signal.
145 </p>
146 <p>
147 </p>
148 <div class="refsect2">
149 <a name="idp12870320"></a><h3>Example pipelines</h3>
150 <div class="informalexample">
151   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
152     <tbody>
153       <tr>
154         <td class="listing_lines" align="right"><pre>1</pre></td>
155         <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch udpsrc port<span class="gtkdoc opt">=</span><span class="number">5000</span> caps<span class="gtkdoc opt">=</span><span class="string">&quot;application/x-rtp, ...&quot;</span> <span class="gtkdoc opt">! .</span>recv_rtp_sink gstrtpsession <span class="gtkdoc opt">.</span>recv_rtp_src <span class="gtkdoc opt">!</span> rtptheoradepay <span class="gtkdoc opt">!</span> theoradec <span class="gtkdoc opt">!</span> xvimagesink</pre></td>
156       </tr>
157     </tbody>
158   </table>
159 </div>
160  Receive theora RTP packets from port 5000 and send them to the depayloader,
161 decoder and display. Note that the application/x-rtp caps on udpsrc should be
162 configured based on some negotiation process such as RTSP for this pipeline
163 to work correctly.
164 <div class="informalexample">
165   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
166     <tbody>
167       <tr>
168         <td class="listing_lines" align="right"><pre>1
169 2
170 3</pre></td>
171         <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch udpsrc port<span class="gtkdoc opt">=</span><span class="number">5000</span> caps<span class="gtkdoc opt">=</span><span class="string">&quot;application/x-rtp, ...&quot;</span> <span class="gtkdoc opt">! .</span>recv_rtp_sink gstrtpsession name<span class="gtkdoc opt">=</span>session \
172        <span class="gtkdoc opt">.</span>recv_rtp_src <span class="gtkdoc opt">!</span> rtptheoradepay <span class="gtkdoc opt">!</span> theoradec <span class="gtkdoc opt">!</span> xvimagesink \
173     udpsrc port<span class="gtkdoc opt">=</span><span class="number">5001</span> caps<span class="gtkdoc opt">=</span><span class="string">&quot;application/x-rtcp&quot;</span> <span class="gtkdoc opt">!</span> session<span class="gtkdoc opt">.</span>recv_rtcp_sink</pre></td>
174       </tr>
175     </tbody>
176   </table>
177 </div>
178  Receive theora RTP packets from port 5000 and send them to the depayloader,
179 decoder and display. Receive RTCP packets from port 5001 and process them in
180 the session manager.
181 Note that the application/x-rtp caps on udpsrc should be
182 configured based on some negotiation process such as RTSP for this pipeline
183 to work correctly.
184 <div class="informalexample">
185   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
186     <tbody>
187       <tr>
188         <td class="listing_lines" align="right"><pre>1</pre></td>
189         <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch videotestsrc <span class="gtkdoc opt">!</span> theoraenc <span class="gtkdoc opt">!</span> rtptheorapay <span class="gtkdoc opt">! .</span>send_rtp_sink gstrtpsession <span class="gtkdoc opt">.</span>send_rtp_src <span class="gtkdoc opt">!</span> udpsink port<span class="gtkdoc opt">=</span><span class="number">5000</span></pre></td>
190       </tr>
191     </tbody>
192   </table>
193 </div>
194  Send theora RTP packets through the session manager and out on UDP port
195 5000.
196 <div class="informalexample">
197   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
198     <tbody>
199       <tr>
200         <td class="listing_lines" align="right"><pre>1
201 2</pre></td>
202         <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch videotestsrc <span class="gtkdoc opt">!</span> theoraenc <span class="gtkdoc opt">!</span> rtptheorapay <span class="gtkdoc opt">! .</span>send_rtp_sink gstrtpsession name<span class="gtkdoc opt">=</span>session <span class="gtkdoc opt">.</span>send_rtp_src \
203     <span class="gtkdoc opt">!</span> udpsink port<span class="gtkdoc opt">=</span><span class="number">5000</span>  session<span class="gtkdoc opt">.</span>send_rtcp_src <span class="gtkdoc opt">!</span> udpsink port<span class="gtkdoc opt">=</span><span class="number">5001</span></pre></td>
204       </tr>
205     </tbody>
206   </table>
207 </div>
208  Send theora RTP packets through the session manager and out on UDP port
209 5000. Send RTCP packets on port 5001. Note that this pipeline will not preroll
210 correctly because the second udpsink will not preroll correctly (no RTCP
211 packets are sent in the PAUSED state). Applications should manually set and
212 keep (see <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html#gst-element-set-locked-state"><code class="function">gst_element_set_locked_state()</code></a>) the RTCP udpsink to the PLAYING state.
213 </div>
214 <p>
215 </p>
216 <p>
217 Last reviewed on 2007-05-28 (0.10.5)
218 </p>
219 <div class="refsynopsisdiv">
220 <h2>Synopsis</h2>
221 <div class="refsect2">
222 <a name="idp16437600"></a><h3>Element Information</h3>
223 <div class="variablelist"><table border="0">
224 <col align="left" valign="top">
225 <tbody>
226 <tr>
227 <td><p><span class="term">plugin</span></p></td>
228 <td>
229             <a class="link" href="gst-plugins-good-plugins-plugin-gstrtpmanager.html#plugin-gstrtpmanager">gstrtpmanager</a>
230           </td>
231 </tr>
232 <tr>
233 <td><p><span class="term">author</span></p></td>
234 <td>Wim Taymans &lt;wim.taymans@gmail.com&gt;</td>
235 </tr>
236 <tr>
237 <td><p><span class="term">class</span></p></td>
238 <td>Filter/Network/RTP</td>
239 </tr>
240 </tbody>
241 </table></div>
242 </div>
243 <hr>
244 <div class="refsect2">
245 <a name="idp16445056"></a><h3>Element Pads</h3>
246 <div class="variablelist"><table border="0">
247 <col align="left" valign="top">
248 <tbody>
249 <tr>
250 <td><p><span class="term">name</span></p></td>
251 <td>recv_rtcp_sink</td>
252 </tr>
253 <tr>
254 <td><p><span class="term">direction</span></p></td>
255 <td>sink</td>
256 </tr>
257 <tr>
258 <td><p><span class="term">presence</span></p></td>
259 <td>request</td>
260 </tr>
261 <tr>
262 <td><p><span class="term">details</span></p></td>
263 <td>application/x-rtcp</td>
264 </tr>
265 </tbody>
266 </table></div>
267 <div class="variablelist"><table border="0">
268 <col align="left" valign="top">
269 <tbody>
270 <tr>
271 <td><p><span class="term">name</span></p></td>
272 <td>recv_rtp_sink</td>
273 </tr>
274 <tr>
275 <td><p><span class="term">direction</span></p></td>
276 <td>sink</td>
277 </tr>
278 <tr>
279 <td><p><span class="term">presence</span></p></td>
280 <td>request</td>
281 </tr>
282 <tr>
283 <td><p><span class="term">details</span></p></td>
284 <td>application/x-rtp</td>
285 </tr>
286 </tbody>
287 </table></div>
288 <div class="variablelist"><table border="0">
289 <col align="left" valign="top">
290 <tbody>
291 <tr>
292 <td><p><span class="term">name</span></p></td>
293 <td>send_rtp_sink</td>
294 </tr>
295 <tr>
296 <td><p><span class="term">direction</span></p></td>
297 <td>sink</td>
298 </tr>
299 <tr>
300 <td><p><span class="term">presence</span></p></td>
301 <td>request</td>
302 </tr>
303 <tr>
304 <td><p><span class="term">details</span></p></td>
305 <td>application/x-rtp</td>
306 </tr>
307 </tbody>
308 </table></div>
309 <div class="variablelist"><table border="0">
310 <col align="left" valign="top">
311 <tbody>
312 <tr>
313 <td><p><span class="term">name</span></p></td>
314 <td>recv_rtp_src</td>
315 </tr>
316 <tr>
317 <td><p><span class="term">direction</span></p></td>
318 <td>source</td>
319 </tr>
320 <tr>
321 <td><p><span class="term">presence</span></p></td>
322 <td>sometimes</td>
323 </tr>
324 <tr>
325 <td><p><span class="term">details</span></p></td>
326 <td>application/x-rtp</td>
327 </tr>
328 </tbody>
329 </table></div>
330 <div class="variablelist"><table border="0">
331 <col align="left" valign="top">
332 <tbody>
333 <tr>
334 <td><p><span class="term">name</span></p></td>
335 <td>send_rtp_src</td>
336 </tr>
337 <tr>
338 <td><p><span class="term">direction</span></p></td>
339 <td>source</td>
340 </tr>
341 <tr>
342 <td><p><span class="term">presence</span></p></td>
343 <td>sometimes</td>
344 </tr>
345 <tr>
346 <td><p><span class="term">details</span></p></td>
347 <td>application/x-rtp</td>
348 </tr>
349 </tbody>
350 </table></div>
351 <div class="variablelist"><table border="0">
352 <col align="left" valign="top">
353 <tbody>
354 <tr>
355 <td><p><span class="term">name</span></p></td>
356 <td>sync_src</td>
357 </tr>
358 <tr>
359 <td><p><span class="term">direction</span></p></td>
360 <td>source</td>
361 </tr>
362 <tr>
363 <td><p><span class="term">presence</span></p></td>
364 <td>sometimes</td>
365 </tr>
366 <tr>
367 <td><p><span class="term">details</span></p></td>
368 <td>application/x-rtcp</td>
369 </tr>
370 </tbody>
371 </table></div>
372 <div class="variablelist"><table border="0">
373 <col align="left" valign="top">
374 <tbody>
375 <tr>
376 <td><p><span class="term">name</span></p></td>
377 <td>send_rtcp_src</td>
378 </tr>
379 <tr>
380 <td><p><span class="term">direction</span></p></td>
381 <td>source</td>
382 </tr>
383 <tr>
384 <td><p><span class="term">presence</span></p></td>
385 <td>request</td>
386 </tr>
387 <tr>
388 <td><p><span class="term">details</span></p></td>
389 <td>application/x-rtcp</td>
390 </tr>
391 </tbody>
392 </table></div>
393 </div>
394 </div>
395 <p>
396 </p>
397 </div>
398 <div class="refsect1">
399 <a name="gst-plugins-good-plugins-gstrtpsession.details"></a><h2>Details</h2>
400 <div class="refsect2">
401 <a name="GstRtpSession-struct"></a><h3>struct GstRtpSession</h3>
402 <pre class="programlisting">struct GstRtpSession;</pre>
403 <p>
404 </p>
405 </div>
406 </div>
407 <div class="refsect1">
408 <a name="gst-plugins-good-plugins-gstrtpsession.property-details"></a><h2>Property Details</h2>
409 <div class="refsect2">
410 <a name="GstRtpSession--bandwidth"></a><h3>The <code class="literal">"bandwidth"</code> property</h3>
411 <pre class="programlisting">  "bandwidth"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write</pre>
412 <p>The bandwidth of the session in bytes per second (0 for auto-discover).</p>
413 <p>Allowed values: &gt;= 0</p>
414 <p>Default value: 64000</p>
415 </div>
416 <hr>
417 <div class="refsect2">
418 <a name="GstRtpSession--internal-session"></a><h3>The <code class="literal">"internal-session"</code> property</h3>
419 <pre class="programlisting">  "internal-session"         <span class="type">RTPSession</span>*           : Read</pre>
420 <p>The internal RTPSession object.</p>
421 </div>
422 <hr>
423 <div class="refsect2">
424 <a name="GstRtpSession--ntp-ns-base"></a><h3>The <code class="literal">"ntp-ns-base"</code> property</h3>
425 <pre class="programlisting">  "ntp-ns-base"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a>               : Read / Write</pre>
426 <p>The NTP base time corresponding to running_time 0 (deprecated).</p>
427 <p>Default value: 0</p>
428 </div>
429 <hr>
430 <div class="refsect2">
431 <a name="GstRtpSession--num-active-sources"></a><h3>The <code class="literal">"num-active-sources"</code> property</h3>
432 <pre class="programlisting">  "num-active-sources"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
433 <p>The number of active sources in the session.</p>
434 <p>Default value: 0</p>
435 </div>
436 <hr>
437 <div class="refsect2">
438 <a name="GstRtpSession--num-sources"></a><h3>The <code class="literal">"num-sources"</code> property</h3>
439 <pre class="programlisting">  "num-sources"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read</pre>
440 <p>The number of sources in the session.</p>
441 <p>Default value: 0</p>
442 </div>
443 <hr>
444 <div class="refsect2">
445 <a name="GstRtpSession--rtcp-fraction"></a><h3>The <code class="literal">"rtcp-fraction"</code> property</h3>
446 <pre class="programlisting">  "rtcp-fraction"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>               : Read / Write</pre>
447 <p>The RTCP bandwidth of the session in bytes per second (or as a real fraction of the RTP bandwidth if &lt; 1.0).</p>
448 <p>Allowed values: &gt;= 0</p>
449 <p>Default value: 3200</p>
450 </div>
451 <hr>
452 <div class="refsect2">
453 <a name="GstRtpSession--sdes"></a><h3>The <code class="literal">"sdes"</code> property</h3>
454 <pre class="programlisting">  "sdes"                     <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstStructure.html#GstStructure"><span class="type">GstStructure</span></a>*         : Read / Write</pre>
455 <p>The SDES items of this session.</p>
456 </div>
457 <hr>
458 <div class="refsect2">
459 <a name="GstRtpSession--rtcp-rr-bandwidth"></a><h3>The <code class="literal">"rtcp-rr-bandwidth"</code> property</h3>
460 <pre class="programlisting">  "rtcp-rr-bandwidth"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
461 <p>The RTCP bandwidth used for receivers in bytes per second (-1 = default).</p>
462 <p>Allowed values: &gt;= G_MAXULONG</p>
463 <p>Default value: -1</p>
464 </div>
465 <hr>
466 <div class="refsect2">
467 <a name="GstRtpSession--rtcp-rs-bandwidth"></a><h3>The <code class="literal">"rtcp-rs-bandwidth"</code> property</h3>
468 <pre class="programlisting">  "rtcp-rs-bandwidth"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
469 <p>The RTCP bandwidth used for senders in bytes per second (-1 = default).</p>
470 <p>Allowed values: &gt;= G_MAXULONG</p>
471 <p>Default value: -1</p>
472 </div>
473 <hr>
474 <div class="refsect2">
475 <a name="GstRtpSession--use-pipeline-clock"></a><h3>The <code class="literal">"use-pipeline-clock"</code> property</h3>
476 <pre class="programlisting">  "use-pipeline-clock"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
477 <p>Use the pipeline clock to set the NTP time in the RTCP SR messages.</p>
478 <p>Default value: FALSE</p>
479 </div>
480 <hr>
481 <div class="refsect2">
482 <a name="GstRtpSession--rtcp-min-interval"></a><h3>The <code class="literal">"rtcp-min-interval"</code> property</h3>
483 <pre class="programlisting">  "rtcp-min-interval"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a>               : Read / Write</pre>
484 <p>Minimum interval between Regular RTCP packet (in ns).</p>
485 <p>Default value: 5000000000</p>
486 </div>
487 </div>
488 <div class="refsect1">
489 <a name="gst-plugins-good-plugins-gstrtpsession.signal-details"></a><h2>Signal Details</h2>
490 <div class="refsect2">
491 <a name="GstRtpSession-clear-pt-map"></a><h3>The <code class="literal">"clear-pt-map"</code> signal</h3>
492 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *sess,
493                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
494 <p>
495 Clear the cached pt-maps requested with <a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession-request-pt-map" title='The "request-pt-map" signal'><span class="type">"request-pt-map"</span></a>.
496 </p>
497 <div class="variablelist"><table border="0">
498 <col align="left" valign="top">
499 <tbody>
500 <tr>
501 <td><p><span class="term"><em class="parameter"><code>sess</code></em> :</span></p></td>
502 <td>the object which received the signal</td>
503 </tr>
504 <tr>
505 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
506 <td>user data set when the signal handler was connected.</td>
507 </tr>
508 </tbody>
509 </table></div>
510 </div>
511 <hr>
512 <div class="refsect2">
513 <a name="GstRtpSession-on-bye-ssrc"></a><h3>The <code class="literal">"on-bye-ssrc"</code> signal</h3>
514 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *sess,
515                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          ssrc,
516                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
517 <p>
518 Notify of an SSRC that became inactive because of a BYE packet.
519 </p>
520 <div class="variablelist"><table border="0">
521 <col align="left" valign="top">
522 <tbody>
523 <tr>
524 <td><p><span class="term"><em class="parameter"><code>sess</code></em> :</span></p></td>
525 <td>the object which received the signal</td>
526 </tr>
527 <tr>
528 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
529 <td>the SSRC</td>
530 </tr>
531 <tr>
532 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
533 <td>user data set when the signal handler was connected.</td>
534 </tr>
535 </tbody>
536 </table></div>
537 </div>
538 <hr>
539 <div class="refsect2">
540 <a name="GstRtpSession-on-bye-timeout"></a><h3>The <code class="literal">"on-bye-timeout"</code> signal</h3>
541 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *sess,
542                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          ssrc,
543                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
544 <p>
545 Notify of an SSRC that has timed out because of BYE
546 </p>
547 <div class="variablelist"><table border="0">
548 <col align="left" valign="top">
549 <tbody>
550 <tr>
551 <td><p><span class="term"><em class="parameter"><code>sess</code></em> :</span></p></td>
552 <td>the object which received the signal</td>
553 </tr>
554 <tr>
555 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
556 <td>the SSRC</td>
557 </tr>
558 <tr>
559 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
560 <td>user data set when the signal handler was connected.</td>
561 </tr>
562 </tbody>
563 </table></div>
564 </div>
565 <hr>
566 <div class="refsect2">
567 <a name="GstRtpSession-on-new-ssrc"></a><h3>The <code class="literal">"on-new-ssrc"</code> signal</h3>
568 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *sess,
569                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          ssrc,
570                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
571 <p>
572 Notify of a new SSRC that entered <em class="parameter"><code>session</code></em>.
573 </p>
574 <div class="variablelist"><table border="0">
575 <col align="left" valign="top">
576 <tbody>
577 <tr>
578 <td><p><span class="term"><em class="parameter"><code>sess</code></em> :</span></p></td>
579 <td>the object which received the signal</td>
580 </tr>
581 <tr>
582 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
583 <td>the SSRC</td>
584 </tr>
585 <tr>
586 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></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">
594 <a name="GstRtpSession-on-sender-timeout"></a><h3>The <code class="literal">"on-sender-timeout"</code> signal</h3>
595 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *sess,
596                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          ssrc,
597                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
598 <p>
599 Notify of a sender SSRC that has timed out and became a receiver
600 </p>
601 <div class="variablelist"><table border="0">
602 <col align="left" valign="top">
603 <tbody>
604 <tr>
605 <td><p><span class="term"><em class="parameter"><code>sess</code></em> :</span></p></td>
606 <td>the object which received the signal</td>
607 </tr>
608 <tr>
609 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
610 <td>the SSRC</td>
611 </tr>
612 <tr>
613 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
614 <td>user data set when the signal handler was connected.</td>
615 </tr>
616 </tbody>
617 </table></div>
618 </div>
619 <hr>
620 <div class="refsect2">
621 <a name="GstRtpSession-on-ssrc-active"></a><h3>The <code class="literal">"on-ssrc-active"</code> signal</h3>
622 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *gstrtpsession,
623                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          arg1,
624                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
625 <p>
626 </p>
627 <div class="variablelist"><table border="0">
628 <col align="left" valign="top">
629 <tbody>
630 <tr>
631 <td><p><span class="term"><em class="parameter"><code>gstrtpsession</code></em> :</span></p></td>
632 <td>the object which received the signal.</td>
633 </tr>
634 <tr>
635 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
636 <td>user data set when the signal handler was connected.</td>
637 </tr>
638 </tbody>
639 </table></div>
640 </div>
641 <hr>
642 <div class="refsect2">
643 <a name="GstRtpSession-on-ssrc-collision"></a><h3>The <code class="literal">"on-ssrc-collision"</code> signal</h3>
644 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *gstrtpsession,
645                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          arg1,
646                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
647 <p>
648 </p>
649 <div class="variablelist"><table border="0">
650 <col align="left" valign="top">
651 <tbody>
652 <tr>
653 <td><p><span class="term"><em class="parameter"><code>gstrtpsession</code></em> :</span></p></td>
654 <td>the object which received the signal.</td>
655 </tr>
656 <tr>
657 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
658 <td>user data set when the signal handler was connected.</td>
659 </tr>
660 </tbody>
661 </table></div>
662 </div>
663 <hr>
664 <div class="refsect2">
665 <a name="GstRtpSession-on-ssrc-sdes"></a><h3>The <code class="literal">"on-ssrc-sdes"</code> signal</h3>
666 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *session,
667                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          src,
668                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
669 <p>
670 Notify that a new SDES was received for SSRC.
671 </p>
672 <div class="variablelist"><table border="0">
673 <col align="left" valign="top">
674 <tbody>
675 <tr>
676 <td><p><span class="term"><em class="parameter"><code>session</code></em> :</span></p></td>
677 <td>the object which received the signal</td>
678 </tr>
679 <tr>
680 <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
681 <td>the SSRC</td>
682 </tr>
683 <tr>
684 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
685 <td>user data set when the signal handler was connected.</td>
686 </tr>
687 </tbody>
688 </table></div>
689 </div>
690 <hr>
691 <div class="refsect2">
692 <a name="GstRtpSession-on-ssrc-validated"></a><h3>The <code class="literal">"on-ssrc-validated"</code> signal</h3>
693 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *gstrtpsession,
694                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          arg1,
695                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
696 <p>
697 </p>
698 <div class="variablelist"><table border="0">
699 <col align="left" valign="top">
700 <tbody>
701 <tr>
702 <td><p><span class="term"><em class="parameter"><code>gstrtpsession</code></em> :</span></p></td>
703 <td>the object which received the signal.</td>
704 </tr>
705 <tr>
706 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
707 <td>user data set when the signal handler was connected.</td>
708 </tr>
709 </tbody>
710 </table></div>
711 </div>
712 <hr>
713 <div class="refsect2">
714 <a name="GstRtpSession-on-timeout"></a><h3>The <code class="literal">"on-timeout"</code> signal</h3>
715 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *sess,
716                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          ssrc,
717                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
718 <p>
719 Notify of an SSRC that has timed out
720 </p>
721 <div class="variablelist"><table border="0">
722 <col align="left" valign="top">
723 <tbody>
724 <tr>
725 <td><p><span class="term"><em class="parameter"><code>sess</code></em> :</span></p></td>
726 <td>the object which received the signal</td>
727 </tr>
728 <tr>
729 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
730 <td>the SSRC</td>
731 </tr>
732 <tr>
733 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
734 <td>user data set when the signal handler was connected.</td>
735 </tr>
736 </tbody>
737 </table></div>
738 </div>
739 <hr>
740 <div class="refsect2">
741 <a name="GstRtpSession-request-pt-map"></a><h3>The <code class="literal">"request-pt-map"</code> signal</h3>
742 <pre class="programlisting"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a>*            user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpsession.html#GstRtpSession"><span class="type">GstRtpSession</span></a> *sess,
743                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          pt,
744                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
745 <p>
746 Request the payload type as <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> for <em class="parameter"><code>pt</code></em>.
747 </p>
748 <div class="variablelist"><table border="0">
749 <col align="left" valign="top">
750 <tbody>
751 <tr>
752 <td><p><span class="term"><em class="parameter"><code>sess</code></em> :</span></p></td>
753 <td>the object which received the signal</td>
754 </tr>
755 <tr>
756 <td><p><span class="term"><em class="parameter"><code>pt</code></em> :</span></p></td>
757 <td>the pt</td>
758 </tr>
759 <tr>
760 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
761 <td>user data set when the signal handler was connected.</td>
762 </tr>
763 </tbody>
764 </table></div>
765 </div>
766 </div>
767 <div class="refsect1">
768 <a name="gst-plugins-good-plugins-gstrtpsession.see-also"></a><h2>See Also</h2>
769 gstrtpjitterbuffer, gstrtpbin, gstrtpptdemux, gstrtpssrcdemux
770 </div>
771 </div>
772 <div class="footer">
773 <hr>
774           Generated by GTK-Doc V1.17</div>
775 </body>
776 </html>