QXmppIceConnection Class Reference

The QXmppIceConnection class represents a set of UDP sockets capable of performing Interactive Connectivity Establishment (RFC 5245). More...

#include <QXmppStun.h>

Inheritance diagram for QXmppIceConnection:

Collaboration diagram for QXmppIceConnection:

Public Types
enum	GatheringState { NewGatheringState , BusyGatheringState , CompleteGatheringState }

Public Slots
void	close ()
void	connectToHost ()

Signals
void	connected ()
	This signal is emitted once ICE negotiation succeeds.
void	disconnected ()
	This signal is emitted when ICE negotiation fails.
void	gatheringStateChanged ()
	This signal is emitted when the gathering state of local candidates changes.
void	localCandidatesChanged ()
	This signal is emitted when the list of local candidates changes.
Signals inherited from QXmppLoggable
void	setGauge (const QString &gauge, double value)
	Sets the given gauge to value.
void	logMessage (QXmppLogger::MessageType type, const QString &msg)
	This signal is emitted to send logging messages.
void	updateCounter (const QString &counter, qint64 amount=1)
	Updates the given counter by amount.

Public Member Functions
	QXmppIceConnection (QObject *parent=nullptr)
QXmppIceComponent *	component (int component)
void	addComponent (int component)
void	setIceControlling (bool controlling)
QList< QXmppJingleCandidate >	localCandidates () const
QString	localUser () const
QString	localPassword () const
void	addRemoteCandidate (const QXmppJingleCandidate &candidate)
void	setRemoteUser (const QString &user)
void	setRemotePassword (const QString &password)
void	setStunServers (const QList< QPair< QHostAddress, quint16 > > &servers)
void	setStunServer (const QHostAddress &host, quint16 port=3478)
void	setTurnServer (const QHostAddress &host, quint16 port=3478)
void	setTurnUser (const QString &user)
void	setTurnPassword (const QString &password)
bool	bind (const QList< QHostAddress > &addresses)
bool	isConnected () const
GatheringState	gatheringState () const
Public Member Functions inherited from QXmppLoggable
	QXmppLoggable (QObject *parent=nullptr)

Properties
QXmppIceConnection::GatheringState	gatheringState

Additional Inherited Members
Protected Member Functions inherited from QXmppLoggable
void	debug (const QString &message)
void	info (const QString &message)
void	warning (const QString &message)
void	logReceived (const QString &message)
void	logSent (const QString &message)

Detailed Description

The QXmppIceConnection class represents a set of UDP sockets capable of performing Interactive Connectivity Establishment (RFC 5245).

A typical example is:

QXmppIceConnection *connection = new QXmppIceConnection();
connection->setIceControlling(true);
connection->addComponent(1);
 
// if needed, set STUN / TURN configuration
// connection->setStunServer(..);
// connection->setTurnServer(..);
 
// start listening
connection->bind(QXmppIceComponent::discoverAddresses());
 
// receive remote information: user, password, candidates
// ...
 
// set remote information and start connecting
connection->setRemoteUser("foo");
connection->setRemoteUser("bar");
connection->addRemoteCandidate(..);
connection->connectToHost();

Member Enumeration Documentation

GatheringState

enum QXmppIceConnection::GatheringState

This enum describes the gathering state of the ICE connection.

Since

QXmpp 0.9.3

Constructor & Destructor Documentation

QXmppIceConnection()

QXmppIceConnection::QXmppIceConnection

(

QObject *

parent = nullptr

)

Constructs a new ICE connection.

Parameters

parent

Member Function Documentation

addComponent()

void QXmppIceConnection::addComponent

(

int

component

)

Adds a component to this ICE connection, for instance 1 for RTP or 2 for RTCP.

Parameters

component

addRemoteCandidate()

void QXmppIceConnection::addRemoteCandidate

(

const QXmppJingleCandidate &

candidate

)

Adds a candidate for one of the remote components.

Parameters

candidate

bind()

bool QXmppIceConnection::bind

(

const QList< QHostAddress > &

addresses

)

Binds the local sockets to the specified addresses.

Parameters

addresses

The addresses on which to listen.

close

void QXmppIceConnection::close ( )

slot

Closes the ICE connection.

component()

QXmppIceComponent * QXmppIceConnection::component

(

int

component

)

Returns the given component of this ICE connection.

Parameters

component

connectToHost

void QXmppIceConnection::connectToHost ( )

slot

Starts ICE connectivity checks.

gatheringState()

QXmppIceConnection::GatheringState QXmppIceConnection::gatheringState

(

)

const

Returns the ICE gathering state, that is the discovery of local candidates.

Since

QXmpp 0.9.3

gatheringStateChanged

void QXmppIceConnection::gatheringStateChanged ( )

signal

This signal is emitted when the gathering state of local candidates changes.

Since

QXmpp 0.9.3

isConnected()

bool QXmppIceConnection::isConnected

(

)

const

Returns true if ICE negotiation completed, false otherwise.

localCandidates()

QList< QXmppJingleCandidate > QXmppIceConnection::localCandidates

(

)

const

Returns the list of local HOST CANDIDATES candidates by iterating over the available network interfaces.

localPassword()

QString QXmppIceConnection::localPassword

(

)

const

Returns the local password.

localUser()

QString QXmppIceConnection::localUser

(

)

const

Returns the local user fragment.

setIceControlling()

void QXmppIceConnection::setIceControlling

(

bool

controlling

)

Sets whether the local party has the ICE controlling role.

note This must be called only once, immediately after creating the connection.

setRemotePassword()

void QXmppIceConnection::setRemotePassword

(

const QString &

password

)

Sets the remote password.

Parameters

password

setRemoteUser()

void QXmppIceConnection::setRemoteUser

(

const QString &

user

)

Sets the remote user fragment.

Parameters

user

setStunServer()

void QXmppIceConnection::setStunServer	(	const QHostAddress &	host,
		quint16	port = 3478
	)

Sets a single STUN server to use to determine server-reflexive addresses and ports.

Note

This may only be called prior to calling bind().

Parameters

host	The address of the STUN server.
port	The port of the STUN server.

setStunServers()

void QXmppIceConnection::setStunServers

(

const QList< QPair< QHostAddress, quint16 > > &

servers

)

Sets multiple STUN servers to use to determine server-reflexive addresses and ports.

Note

This may only be called prior to calling bind().

Parameters

servers

List of the STUN servers.

Since

QXmpp 1.3

setTurnPassword()

void QXmppIceConnection::setTurnPassword

(

const QString &

password

)

Sets the password used for authentication with the TURN server.

Note

This may only be called prior to calling bind().

Parameters

password

setTurnServer()

void QXmppIceConnection::setTurnServer	(	const QHostAddress &	host,
		quint16	port = 3478
	)

Sets the TURN server to use to relay packets in double-NAT configurations.

Note

This may only be called prior to calling bind().

Parameters

host	The address of the TURN server.
port	The port of the TURN server.

setTurnUser()

void QXmppIceConnection::setTurnUser

(

const QString &

user

)

Sets the user used for authentication with the TURN server.

Note

This may only be called prior to calling bind().

Parameters

user

Property Documentation

gatheringState

QXmppIceConnection::GatheringState QXmppIceConnection::gatheringState

read

The ICE gathering state, that is the discovery of local candidates

Since

QXmpp 0.9.3

---

The documentation for this class was generated from the following files:

• QXmppStun.h
• QXmppStun.cpp