From fe53552f410cf6f47c43d27900185dc79f3b66ef Mon Sep 17 00:00:00 2001 From: Olle Johansson Date: Tue, 5 Dec 2006 20:39:13 +0000 Subject: Doxygen updates git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@48277 65c4cc65-6c06-0410-ace0-fbb531ad65f3 --- main/rtp.c | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) (limited to 'main/rtp.c') diff --git a/main/rtp.c b/main/rtp.c index c629da006..7163f1601 100644 --- a/main/rtp.c +++ b/main/rtp.c @@ -3142,7 +3142,34 @@ static enum ast_bridge_result bridge_p2p_loop(struct ast_channel *c0, struct ast /*! \brief Bridge calls. If possible and allowed, initiate re-invite so the peers exchange media directly outside - of Asterisk. */ + of Asterisk. +*/ +/*! \page AstRTPbridge The Asterisk RTP bridge + The RTP bridge is called from the channel drivers that are using the RTP + subsystem in Asterisk - like SIP, H.323 and Jingle/Google Talk. + + This bridge aims to offload the Asterisk server by setting up + the media stream directly between the endpoints, keeping the + signalling in Asterisk. + + It checks with the channel driver, using a callback function, if + there are possibilities for a remote bridge. + + If this fails, the bridge hands off to the core bridge. Reasons + can be NAT support needed, DTMF features in audio needed by + the PBX for transfers or spying/monitoring on channels. + + If transcoding is needed - we can't do a remote bridge. + If only NAT support is needed, we're using Asterisk in + RTP proxy mode with the p2p RTP bridge, basically + forwarding incoming audio packets to the outbound + stream on a network level. + + References: + - ast_rtp_bridge() + - ast_channel_early_bridge() + - ast_channel_bridge() +*/ enum ast_bridge_result ast_rtp_bridge(struct ast_channel *c0, struct ast_channel *c1, int flags, struct ast_frame **fo, struct ast_channel **rc, int timeoutms) { struct ast_rtp *p0 = NULL, *p1 = NULL; /* Audio RTP Channels */ -- cgit v1.2.3