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
|
// SPDX-FileCopyrightText: 2022 Cochise César <cochisecesar@zoho.com>
// SPDX-FileCopyrightText: 2022 Linus Jahn <lnj@kaidan.im>
//
// SPDX-License-Identifier: LGPL-2.1-or-later
#include "QXmppUserLocationManager.h"
#include "QXmppConstants_p.h"
#include "QXmppGeolocItem.h"
#include "QXmppPep_p.h"
using namespace QXmpp::Private;
static QXmppPubSubManager *pubSub(QXmppClient *client)
{
return client->findExtension<QXmppPubSubManager>();
}
///
/// \class QXmppUserLocationManager
///
/// The QXmppUserLocationManager implements \xep{0080, User Location}. You'll receive
/// location updates from all presence subscriptions. You can publish location
/// information on the user's account (publish()) and request location information
/// from specific accounts (request()).
///
/// The manager needs to be added to the client first and also requires the
/// QXmppPubSubManager.
/// \code
/// QXmppClient client;
/// auto *pubSubManager = client.addNewExtension<QXmppPubSubManager>();
/// auto *locationManager = client.addNewExtension<QXmppUserLocationManager>();
/// \endcode
///
/// \since QXmpp 1.5
///
/// \ingroup Managers
///
///
/// \typedef QXmppUserLocationManager::Item
///
/// Used pubsub item type.
///
///
/// \typedef QXmppUserLocationManager::GetResult
///
/// Contains the User Location information or an error.
///
///
/// \typedef QXmppUserLocationManager::PublishResult
///
/// Contains the ID of the published item on success or a stanza error.
///
///
/// \fn QXmppUserLocationManager::itemReceived()
///
/// Emitted whenever a \xep{0080, User Location} items event arrives.
///
QXmppUserLocationManager::QXmppUserLocationManager() = default;
QStringList QXmppUserLocationManager::discoveryFeatures() const
{
return {
ns_geoloc,
ns_geoloc_notify,
};
}
///
/// Request User Location information from an account.
///
/// \param jid The account JID to request.
///
auto QXmppUserLocationManager::request(const QString &jid)
-> QXmppTask<GetResult>
{
return Pep::request<Item>(pubSub(client()), jid, ns_geoloc, this);
}
///
/// Publishes User Location information on the user's account.
///
/// \param item The User Location item to be published.
///
auto QXmppUserLocationManager::publish(const QXmppGeolocItem &item)
-> QXmppTask<PublishResult>
{
return pubSub(client())->publishOwnPepItem(ns_geoloc, item);
}
/// \cond
bool QXmppUserLocationManager::handlePubSubEvent(const QDomElement &element, const QString &pubSubService, const QString &nodeName)
{
return Pep::handlePubSubEvent<Item>(element, pubSubService, nodeName, ns_geoloc, this, &QXmppUserLocationManager::itemReceived);
}
/// \endcond
|
