The SimpleCallObserver class provides an easy way to track calls in an account and can be optionally filtered by a contact and/or call direction. More...

#include <TelepathyQt/SimpleCallObserver>

Inheritance diagram for Tp::SimpleCallObserver:

[legend]

Public Types
enum	CallDirection { CallDirectionIncoming, CallDirectionOutgoing, CallDirectionBoth }

Signals
void	callStarted (const Tp::CallChannelPtr &channel)

void	callEnded (const Tp::CallChannelPtr &channel, const QString &errorName, const QString &errorMessage)

void	streamedMediaCallStarted (const Tp::StreamedMediaChannelPtr &channel)

void	streamedMediaCallEnded (const Tp::StreamedMediaChannelPtr &channel, const QString &errorName, const QString &errorMessage)

Public Member Functions
virtual	~SimpleCallObserver ()

AccountPtr	account () const

QString	contactIdentifier () const

CallDirection	direction () const

QList< CallChannelPtr >	calls () const

QList< StreamedMediaChannelPtr >	streamedMediaCalls () const

Public Member Functions inherited from QObject
	QObject (QObject *parent)

virtual	~QObject ()

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

virtual const QMetaObject *	metaObject () const

QString	objectName () const

void	setObjectName (const QString &name)

bool	isWidgetType () const

bool	signalsBlocked () const

bool	blockSignals (bool block)

QThread *	thread () const

void	moveToThread (QThread *targetThread)

int	startTimer (int interval)

void	killTimer (int id)

T	findChild (const QString &name) const

QList< T >	findChildren (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

void	setParent (QObject *parent)

void	installEventFilter (QObject *filterObj)

void	removeEventFilter (QObject *obj)

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

bool	disconnect (const char signal, const QObject receiver, const char *method)

bool	disconnect (const QObject receiver, const char method)

void	dumpObjectTree ()

void	dumpObjectInfo ()

bool	setProperty (const char *name, const QVariant &value)

QVariant	property (const char *name) const

QList< QByteArray >	dynamicPropertyNames () const

void	destroyed (QObject *obj)

QObject *	parent () const

bool	inherits (const char *className) const

void	deleteLater ()

	QObject (QObject parent, const char name)

void	insertChild (QObject *object)

void	removeChild (QObject *object)

bool	isA (const char *className) const

const char *	className () const

const char *	name () const

const char *	name (const char *defaultName) const

void	setName (const char *name)

Public Member Functions inherited from Tp::RefCounted
	RefCounted ()

virtual	~RefCounted ()

Static Public Member Functions
static SimpleCallObserverPtr	create (const AccountPtr &account, CallDirection direction=CallDirectionBoth)

static SimpleCallObserverPtr	create (const AccountPtr &account, const ContactPtr &contact, CallDirection direction=CallDirectionBoth)

static SimpleCallObserverPtr	create (const AccountPtr &account, const QString &contactIdentifier, CallDirection direction=CallDirectionBoth)

Static Public Member Functions inherited from QObject
QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

Additional Inherited Members
Protected Member Functions inherited from QObject
QObject *	sender () const

int	senderSignalIndex () const

int	receivers (const char *signal) const

virtual void	timerEvent (QTimerEvent *event)

virtual void	childEvent (QChildEvent *event)

virtual void	customEvent (QEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	disconnectNotify (const char *signal)

bool	checkConnectArgs (const char signal, const QObject object, const char *method)

Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Properties inherited from QObject
	objectName

Detailed Description

The SimpleCallObserver class provides an easy way to track calls in an account and can be optionally filtered by a contact and/or call direction.

Member Enumeration Documentation

§ CallDirection

enum Tp::SimpleCallObserver::CallDirection

Enumerator
CallDirectionIncoming
CallDirectionOutgoing
CallDirectionBoth

Constructor & Destructor Documentation

§ ~SimpleCallObserver()

Tp::SimpleCallObserver::~SimpleCallObserver ( )

virtual

Class destructor.

Member Function Documentation

§ create() [1/3]

SimpleCallObserverPtr Tp::SimpleCallObserver::create	(	const AccountPtr &	account,
		CallDirection	direction = `CallDirectionBoth`
	)

static

Create a new SimpleCallObserver object.

Events will be signalled for all calls in account that respect direction.

Parameters

account	The account used to listen to events.
direction	The direction of the calls used to filter events.

Returns: An SimpleCallObserverPtr object pointing to the newly created SimpleCallObserver object.

§ create() [2/3]

SimpleCallObserverPtr Tp::SimpleCallObserver::create	(	const AccountPtr &	account,
		const ContactPtr &	contact,
		CallDirection	direction = `CallDirectionBoth`
	)

static

Create a new SimpleCallObserver object.

Events will be signalled for all calls in account established with contact and that respect direction.

Parameters

account	The account used to listen to events.
contact	The contact used to filter events.
direction	The direction of the calls used to filter events.

Returns: An SimpleCallObserverPtr object pointing to the newly created SimpleCallObserver object.

§ create() [3/3]

SimpleCallObserverPtr Tp::SimpleCallObserver::create	(	const AccountPtr &	account,
		const QString &	contactIdentifier,
		CallDirection	direction = `CallDirectionBoth`
	)

static

Create a new SimpleCallObserver object.

Events will be signalled for all calls in account established with a contact identified by contactIdentifier and that respect direction.

Parameters

account	The account used to listen to events.
contactIdentifier	The identifier of the contact used to filter events.
direction	The direction of the calls used to filter events.

Returns: An SimpleCallObserverPtr object pointing to the newly created SimpleCallObserver object.

§ account()

AccountPtr Tp::SimpleCallObserver::account ( ) const

Return the account used to listen to events.

Returns: A pointer to the Account object.

§ contactIdentifier()

QString Tp::SimpleCallObserver::contactIdentifier ( ) const

Return the identifier of the contact used to filter events, or an empty string if none was provided at construction.

Returns: The identifier of the contact.

§ direction()

SimpleCallObserver::CallDirection Tp::SimpleCallObserver::direction ( ) const

Return the direction of the calls used to filter events.

Returns: The direction of the calls as SimpleCallObserver::CallDirection.

§ calls()

QList< CallChannelPtr > Tp::SimpleCallObserver::calls ( ) const

Return the list of calls currently being observed.

Returns: A list of pointers to CallChannel objects.

§ streamedMediaCalls()

QList< StreamedMediaChannelPtr > Tp::SimpleCallObserver::streamedMediaCalls ( ) const

Return the list of streamed media calls currently being observed.

Deprecated:: Use calls() instead. Modern clients shouldn't use StreamedMedia channels.

Returns: A list of pointers to StreamedMediaChannel objects.

§ callStarted

void Tp::SimpleCallObserver::callStarted ( const Tp::CallChannelPtr & channel )

signal

Emitted whenever a call that matches this observer's criteria is started.

Parameters

channel The channel representing the call that started.

§ callEnded

void Tp::SimpleCallObserver::callEnded	(	const Tp::CallChannelPtr &	channel,
		const QString &	errorName,
		const QString &	errorMessage
	)

signal

Emitted whenever a call that matches this observer's criteria has ended.

Parameters

channel	The channel representing the call that ended.
errorName	A D-Bus error name (a string in a subset of ASCII, prefixed with a reversed domain name).
errorMessage	A debugging message associated with the error.

§ streamedMediaCallStarted

void Tp::SimpleCallObserver::streamedMediaCallStarted ( const Tp::StreamedMediaChannelPtr & channel )

signal

Emitted whenever a streamed media call that matches this observer's criteria is started.

Parameters

channel The channel representing the streamed media call that started.

Deprecated:: Use callStarted() instead. Modern clients shouldn't use StreamedMedia channels.

§ streamedMediaCallEnded

void Tp::SimpleCallObserver::streamedMediaCallEnded	(	const Tp::StreamedMediaChannelPtr &	channel,
		const QString &	errorName,
		const QString &	errorMessage
	)

signal

Emitted whenever a streamed media call that matches this observer's criteria has ended.

Parameters

channel	The channel representing the streamed media call that ended.
errorName	A D-Bus error name (a string in a subset of ASCII, prefixed with a reversed domain name).
errorMessage	A debugging message associated with the error.

Deprecated:: Use callEnded() instead. Modern clients shouldn't use StreamedMedia channels.

Public Types

Signals

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

§ CallDirection

Constructor & Destructor Documentation

§ ~SimpleCallObserver()

Member Function Documentation

§ create() [1/3]

§ create() [2/3]

§ create() [3/3]

§ account()

§ contactIdentifier()

§ direction()

§ calls()

§ streamedMediaCalls()

§ callStarted

§ callEnded

§ streamedMediaCallStarted

§ streamedMediaCallEnded