org.mjsip.rtp

Class RtcpProvider

java.lang.Object

org.mjsip.rtp.RtcpProvider

All Implemented Interfaces:

UdpProviderListener

public class RtcpProvider
extends java.lang.Object
implements UdpProviderListener

RtcpProvider implements the RTCP service for receiving and sending RTP control (RTCP) packets.

Constructor Summary

Constructors

Constructor and Description
RtcpProvider(UdpSocket udp_socket, RtcpProviderListener listener) Creates a new RTCP (receiver only, or symmetric RTCP).
RtcpProvider(UdpSocket udp_socket, SocketAddress remote_dest_soaddr, RtcpProviderListener listener) Creates a new RTCP (sender and receiver).

Method Summary

Modifier and Type	Method and Description
SocketAddress	getRemoteSourceSoAddress() Gets the remote source socket address.
boolean	getSymmetricRtcpMode() Whether outgoing RTCP packets are sent to the same address where the incoming RTCP packets come from (symmetric RTCP mode).
UdpProvider	getUdpProvider() Gets the UDP provider.
void	halt() Stops running.
void	onReceivedPacket(UdpProvider udp, UdpPacket udp_packet) From UdpProviderListener.
void	onServiceTerminated(UdpProvider udp, java.lang.Exception error) From UdpProviderListener.
void	send(RtcpCompoundPacket rcomp_packet) Sends a RTCP compound packet from this socket.
void	send(RtcpPacket rtcp_packet) Sends a RTCP packet from this socket.
void	setRemoteDestSoAddress(SocketAddress remote_dest_soaddr) Changes the remote destination socket address.
void	setSymmetricRtcpMode(boolean symmetric_rtcp) Sets symmetric RTCP mode.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RtcpProvider

public RtcpProvider(UdpSocket udp_socket,
                    RtcpProviderListener listener)

Creates a new RTCP (receiver only, or symmetric RTCP).

Parameters:

udp_socket - the local UDP socket used for receiving RTCP packets

listener - the RTCP provider listener

RtcpProvider

public RtcpProvider(UdpSocket udp_socket,
                    SocketAddress remote_dest_soaddr,
                    RtcpProviderListener listener)

Creates a new RTCP (sender and receiver).

Parameters:

udp_socket - the local UDP socket used for sending and receiving RTCP packets

remote_dest_soaddr - the remote UDP socket address where RTCP packet are sent to

listener - the RTCP provider listener

Method Detail

setSymmetricRtcpMode

public void setSymmetricRtcpMode(boolean symmetric_rtcp)

Sets symmetric RTCP mode. In symmetric RTCP mode outgoing RTCP packets are sent to the source address of incoming RTCP packets.

Parameters:

symmetric_rtcp - whether working in symmetric RTCP mode

getSymmetricRtcpMode

public boolean getSymmetricRtcpMode()

Whether outgoing RTCP packets are sent to the same address where the incoming RTCP packets come from (symmetric RTCP mode).

Returns:

true if symmetric RTCP mode is on

setRemoteDestSoAddress

public void setRemoteDestSoAddress(SocketAddress remote_dest_soaddr)

Changes the remote destination socket address.

Parameters:

remote_dest_soaddr - the remote UDP socket address where RTCP packet are sent to

getUdpProvider

public UdpProvider getUdpProvider()

Gets the UDP provider.

Returns:

the local UDP provider

getRemoteSourceSoAddress

public SocketAddress getRemoteSourceSoAddress()

Gets the remote source socket address.

Returns:

the remote UDP socket address where RTCP packet are sent from

send

public void send(RtcpCompoundPacket rcomp_packet)
          throws java.io.IOException

Sends a RTCP compound packet from this socket.

Parameters:

rcomp_packet - RTCP compound packet to be sent

Throws:

java.io.IOException

send

public void send(RtcpPacket rtcp_packet)
          throws java.io.IOException

Sends a RTCP packet from this socket.

Parameters:

rtcp_packet - RTCP packet to be sent

Throws:

java.io.IOException

halt

public void halt()

Stops running.

onReceivedPacket

public void onReceivedPacket(UdpProvider udp,
                             UdpPacket udp_packet)

From UdpProviderListener. When a new UDP datagram is received.

Specified by:

onReceivedPacket in interface UdpProviderListener

onServiceTerminated

public void onServiceTerminated(UdpProvider udp,
                                java.lang.Exception error)

From UdpProviderListener. When UdpProvider terminates.

Specified by:

onServiceTerminated in interface UdpProviderListener