blob: be91b047b3c79904127a01c215fe464597c9c215 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
/*
* Copyright (C) 2008-2021 The QXmpp developers
*
* Author:
* Jeremy Lainé
*
* Source:
* https://github.com/qxmpp-project/qxmpp
*
* This file is a part of QXmpp library.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
*/
#ifndef QXMPPCALLMANAGER_H
#define QXMPPCALLMANAGER_H
#include "QXmppCall.h"
#include "QXmppClientExtension.h"
#include "QXmppLogger.h"
#include <QIODevice>
#include <QMetaType>
#include <QObject>
class QHostAddress;
class QXmppCallManagerPrivate;
class QXmppIq;
class QXmppJingleCandidate;
class QXmppJingleIq;
class QXmppJinglePayloadType;
class QXmppPresence;
/// \brief The QXmppCallManager class provides support for making and
/// receiving voice calls.
///
/// Session initiation is performed as described by \xep{0166}: Jingle,
/// \xep{0167}: Jingle RTP Sessions and \xep{0176}: Jingle ICE-UDP Transport
/// Method.
///
/// The data stream is connected using Interactive Connectivity Establishment
/// (RFC 5245) and data is transferred using Real Time Protocol (RFC 3550)
/// packets.
///
/// To make use of this manager, you need to instantiate it and load it into
/// the QXmppClient instance as follows:
///
/// \code
/// QXmppCallManager *manager = new QXmppCallManager;
/// client->addExtension(manager);
/// \endcode
///
/// \ingroup Managers
class QXMPP_EXPORT QXmppCallManager : public QXmppClientExtension
{
Q_OBJECT
public:
QXmppCallManager();
~QXmppCallManager() override;
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);
/// \cond
QStringList discoveryFeatures() const override;
bool handleStanza(const QDomElement &element) override;
/// \endcond
Q_SIGNALS:
/// This signal is emitted when a new incoming call is received.
///
/// To accept the call, invoke the call's QXmppCall::accept() method.
/// To refuse the call, invoke the call's QXmppCall::hangup() method.
void callReceived(QXmppCall *call);
/// This signal is emitted when a call (incoming or outgoing) is started.
void callStarted(QXmppCall *call);
public Q_SLOTS:
QXmppCall *call(const QString &jid);
protected:
/// \cond
void setClient(QXmppClient *client) override;
/// \endcond
private Q_SLOTS:
void _q_callDestroyed(QObject *object);
void _q_disconnected();
void _q_iqReceived(const QXmppIq &iq);
void _q_jingleIqReceived(const QXmppJingleIq &iq);
void _q_presenceReceived(const QXmppPresence &presence);
private:
QXmppCallManagerPrivate *d;
friend class QXmppCall;
friend class QXmppCallPrivate;
friend class QXmppCallManagerPrivate;
};
#endif
|
