org.jivesoftware.smackx.jingleold.nat

Class RTPBridge

java.lang.Object

org.jivesoftware.smack.packet.Stanza

org.jivesoftware.smack.packet.IQ

org.jivesoftware.smackx.jingleold.nat.RTPBridge

All Implemented Interfaces:

Element, Packet, TopLevelStreamElement

public class RTPBridge
extends IQ

RTPBridge IQ Stanza(/Packet) used to request and retrieve a RTPBridge Candidates that can be used for a Jingle Media Transmission between two parties that are behind NAT. This Jingle Bridge has all the needed information to establish a full UDP Channel (Send and Receive) between two parties. This transport method should be used only if other transport methods are not allowed. Or if you want a more reliable transport.

High Level Usage Example:

RTPBridge rtpBridge = RTPBridge.getRTPBridge(connection, sessionID);

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RTPBridge.Provider IQProvider for RTP Bridge packets.

Nested classes/interfaces inherited from class org.jivesoftware.smack.packet.IQ

IQ.IQChildElementXmlStringBuilder, IQ.Type

Field Summary

Fields

Modifier and Type	Field and Description
static String	ELEMENT_NAME Element name of the stanza(/packet) extension.
static String	NAME Element name of the stanza(/packet) extension.
static String	NAMESPACE Namespace of the stanza(/packet) extension.

Fields inherited from class org.jivesoftware.smack.packet.IQ

IQ_ELEMENT, QUERY_ELEMENT

Fields inherited from class org.jivesoftware.smack.packet.Stanza

DEFAULT_LANGUAGE, ITEM, language, TEXT

Constructor Summary

Constructors

Constructor and Description
RTPBridge() Creates a RTPBridge Stanza(/Packet) without Session ID
RTPBridge(org.jivesoftware.smackx.jingleold.nat.RTPBridge.BridgeAction action) Creates a RTPBridge Instance with defined Session ID
RTPBridge(String sid) Creates a RTPBridge Instance with defined Session ID
RTPBridge(String sid, org.jivesoftware.smackx.jingleold.nat.RTPBridge.BridgeAction bridgeAction) Creates a RTPBridge Instance with defined Session ID

Method Summary

Modifier and Type	Method and Description
String	getAttributes() Get the attributes string
String	getHostA() Get the Host A IP Address
String	getHostB() Get the Host B IP Address
String	getIp() Get the RTP Bridge IP
protected IQ.IQChildElementXmlStringBuilder	getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder str) Get the Child Element XML of the Packet
String	getName() Get the name of the Candidate
String	getPass() Get the RTP Agent Pass
int	getPortA() Get Side A receive port
int	getPortB() Get Side B receive port
static String	getPublicIP(XMPPConnection xmppConnection) Get Public Address from the Server.
static RTPBridge	getRTPBridge(XMPPConnection connection, String sessionID) Get a new RTPBridge Candidate from the server.
String	getSid() Get the Session ID of the Stanza(/Packet) (usually same as Jingle Session ID)
static RTPBridge	relaySession(XMPPConnection connection, String sessionID, String pass, TransportCandidate proxyCandidate, TransportCandidate localCandidate) Check if the server support RTPBridge Service.
static boolean	serviceAvailable(XMPPConnection connection) Check if the server support RTPBridge Service.
void	setHostA(String hostA) Set the Host A IP Address
void	setHostB(String hostB) Set the Host B IP Address
void	setIp(String ip) Set the RTP Bridge IP
void	setName(String name) Set the name of the Candidate
void	setPass(String pass) Set the RTP Agent Pass
void	setPortA(int portA) Set Side A receive port
void	setPortB(int portB) Set Side B receive port
void	setSid(String sid) Set the Session ID of the Stanza(/Packet) (usually same as Jingle Session ID)

Methods inherited from class org.jivesoftware.smack.packet.IQ

createErrorResponse, createResultIQ, getChildElementName, getChildElementNamespace, getChildElementXML, getType, isRequestIQ, setType, toXML

Methods inherited from class org.jivesoftware.smack.packet.Stanza

addCommonAttributes, addExtension, addExtensions, appendErrorIfExists, getDefaultLanguage, getError, getExtension, getExtension, getExtensions, getExtensions, getExtensionsXML, getFrom, getLanguage, getPacketID, getStanzaId, getTo, hasExtension, hasExtension, hasStanzaIdSet, overrideExtension, removeExtension, removeExtension, setError, setFrom, setLanguage, setPacketID, setStanzaId, setTo, toString

Methods inherited from class java.lang.Object

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

Field Detail

NAME

public static final String NAME

Element name of the stanza(/packet) extension.

See Also:

Constant Field Values

ELEMENT_NAME

public static final String ELEMENT_NAME

Element name of the stanza(/packet) extension.

See Also:

Constant Field Values

NAMESPACE

public static final String NAMESPACE

Namespace of the stanza(/packet) extension.

See Also:

Constant Field Values

Constructor Detail

RTPBridge

public RTPBridge(String sid)

Creates a RTPBridge Instance with defined Session ID

Parameters:

sid -

RTPBridge

public RTPBridge(org.jivesoftware.smackx.jingleold.nat.RTPBridge.BridgeAction action)

Creates a RTPBridge Instance with defined Session ID

Parameters:

action -

RTPBridge

public RTPBridge(String sid,
                 org.jivesoftware.smackx.jingleold.nat.RTPBridge.BridgeAction bridgeAction)

Creates a RTPBridge Instance with defined Session ID

Parameters:

sid -

bridgeAction -

RTPBridge

public RTPBridge()

Creates a RTPBridge Stanza(/Packet) without Session ID

Method Detail

getAttributes

public String getAttributes()

Get the attributes string

getSid

public String getSid()

Get the Session ID of the Stanza(/Packet) (usually same as Jingle Session ID)

Returns:

the session ID

setSid

public void setSid(String sid)

Set the Session ID of the Stanza(/Packet) (usually same as Jingle Session ID)

Parameters:

sid -

getHostA

public String getHostA()

Get the Host A IP Address

Returns:

the Host A IP Address

setHostA

public void setHostA(String hostA)

Set the Host A IP Address

Parameters:

hostA -

getHostB

public String getHostB()

Get the Host B IP Address

Returns:

the Host B IP Address

setHostB

public void setHostB(String hostB)

Set the Host B IP Address

Parameters:

hostB -

getPortA

public int getPortA()

Get Side A receive port

Returns:

the side A receive prot

setPortA

public void setPortA(int portA)

Set Side A receive port

Parameters:

portA -

getPortB

public int getPortB()

Get Side B receive port

Returns:

the side B receive port

setPortB

public void setPortB(int portB)

Set Side B receive port

Parameters:

portB -

getIp

public String getIp()

Get the RTP Bridge IP

Returns:

the RTP Bridge IP

setIp

public void setIp(String ip)

Set the RTP Bridge IP

Parameters:

ip -

getPass

public String getPass()

Get the RTP Agent Pass

Returns:

the RTP Agent Pass

setPass

public void setPass(String pass)

Set the RTP Agent Pass

Parameters:

pass -

getName

public String getName()

Get the name of the Candidate

Returns:

the name of the Candidate

setName

public void setName(String name)

Set the name of the Candidate

Parameters:

name -

getIQChildElementBuilder

protected IQ.IQChildElementXmlStringBuilder getIQChildElementBuilder(IQ.IQChildElementXmlStringBuilder str)

Get the Child Element XML of the Packet

Specified by:

getIQChildElementBuilder in class IQ

Parameters:

str - a pre-created builder which already has the child element and the 'xmlns' attribute set.

Returns:

the Child Element XML of the Packet

getRTPBridge

public static RTPBridge getRTPBridge(XMPPConnection connection,
                                     String sessionID)
                              throws SmackException.NotConnectedException

Get a new RTPBridge Candidate from the server. If a error occurs or the server don't support RTPBridge Service, null is returned.

Parameters:

connection -

sessionID -

Returns:

the new RTPBridge

Throws:

SmackException.NotConnectedException

serviceAvailable

public static boolean serviceAvailable(XMPPConnection connection)
                                throws SmackException.NoResponseException,
                                       XMPPException.XMPPErrorException,
                                       SmackException.NotConnectedException

Check if the server support RTPBridge Service.

Parameters:

connection -

Returns:

true if the server supports the RTPBridge service

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException

relaySession

public static RTPBridge relaySession(XMPPConnection connection,
                                     String sessionID,
                                     String pass,
                                     TransportCandidate proxyCandidate,
                                     TransportCandidate localCandidate)
                              throws SmackException.NotConnectedException

Check if the server support RTPBridge Service.

Parameters:

connection -

Returns:

the RTPBridge

Throws:

SmackException.NotConnectedException

getPublicIP

public static String getPublicIP(XMPPConnection xmppConnection)
                          throws SmackException.NotConnectedException

Get Public Address from the Server.

Parameters:

xmppConnection -

Returns:

public IP String or null if not found

Throws:

SmackException.NotConnectedException