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
115
116
117
118
119
120
|
// Copyright 2007-2021 The Mumble Developers. All rights reserved.
// Use of this source code is governed by a BSD-style license
// that can be found in the LICENSE file at the root of the
// Mumble source tree or at <https://www.mumble.info/LICENSE>.
#ifndef MUMBLE_CHANNEL_H_
#define MUMBLE_CHANNEL_H_
#include <QtCore/QHash>
#include <QtCore/QList>
#include <QtCore/QObject>
#include <QtCore/QReadWriteLock>
#include <QtCore/QSet>
#include <QtCore/QString>
#ifdef MUMBLE
# include <atomic>
#endif
class User;
class Group;
class ChanACL;
class ClientUser;
class Channel : public QObject {
private:
Q_OBJECT
Q_DISABLE_COPY(Channel)
private:
QSet< Channel * > qsUnseen;
public:
static constexpr int ROOT_ID = 0;
int iId;
int iPosition;
bool bTemporary;
Channel *cParent;
QString qsName;
QString qsDesc;
QByteArray qbaDescHash;
QList< Channel * > qlChannels;
QList< User * > qlUsers;
QHash< QString, Group * > qhGroups;
QList< ChanACL * > qlACL;
#ifdef MUMBLE
/// A flag indicating whether this channel has enter restrictions (ACL denying ENTER) in place
std::atomic< bool > hasEnterRestrictions;
/// A flag indicating whether the local user is currently able to enter this channel. In theory this should
/// represent the correct access state (apart from the time it takes to synchronize ACL changes from the server
/// to the client), but in the end, it's the server who decides whether the user can enter. This flag is only
/// meant for UI purposes and should not be used influence actual behaviour.
std::atomic< bool > localUserCanEnter;
#endif
QSet< Channel * > qsPermLinks;
QHash< Channel *, int > qhLinks;
bool bInheritACL;
/// Maximum number of users allowed in the channel. If this
/// value is zero, the maximum number of users allowed in the
/// channel is given by the server's "usersperchannel"
/// setting.
unsigned int uiMaxUsers;
Channel(int id, const QString &name, QObject *p = nullptr);
~Channel();
#ifdef MUMBLE
unsigned int uiPermissions;
bool bFiltered;
static QHash< int, Channel * > c_qhChannels;
static QReadWriteLock c_qrwlChannels;
static Channel *get(int);
static Channel *add(int, const QString &);
static void remove(Channel *);
void addClientUser(ClientUser *p);
#endif
static bool lessThan(const Channel *, const Channel *);
size_t getLevel() const;
size_t getDepth() const;
QString getPath() const;
void addChannel(Channel *c);
void removeChannel(Channel *c);
void addUser(User *p);
void removeUser(User *p);
bool isLinked(Channel *c) const;
void link(Channel *c);
void unlink(Channel *c = nullptr);
QSet< Channel * > allLinks();
QSet< Channel * > allChildren();
operator QString() const;
signals:
/// Signal emitted whenever a user enters a channel.
///
/// @param newChannel A pointer to the Channel the user has just entered
/// @param prevChannel A pointer to the Channel the user is coming from or nullptr if
/// there is no such channel.
/// @param user A pointer to the User that has triggered this signal
void channelEntered(const Channel *newChannel, const Channel *prevChannel, const User *user);
/// Signal emitted whenever a user leaves a channel.
///
/// @param channel A pointer to the Channel the user has left
/// @param user A pointer to the User that has triggered this signal
void channelExited(const Channel *channel, const User *user);
};
#endif
|