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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
/*
* gabble-presence.h - Headers for Gabble's per-contact presence structure
* Copyright (C) 2005 Collabora Ltd.
* Copyright (C) 2005 Nokia Corporation
*
* 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.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef __GABBLE_PRESENCE_H__
#define __GABBLE_PRESENCE_H__
#include <glib-object.h>
#include "gabble/capabilities.h"
#include "connection.h"
#include "types.h"
G_BEGIN_DECLS
#define GABBLE_TYPE_PRESENCE gabble_presence_get_type ()
#define GABBLE_PRESENCE(obj) \
(G_TYPE_CHECK_INSTANCE_CAST ((obj), \
GABBLE_TYPE_PRESENCE, GabblePresence))
#define GABBLE_PRESENCE_CLASS(klass) \
(G_TYPE_CHECK_CLASS_CAST ((klass), \
GABBLE_TYPE_PRESENCE, GabblePresenceClass))
#define GABBLE_IS_PRESENCE(obj) \
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), \
GABBLE_TYPE_PRESENCE))
#define GABBLE_IS_PRESENCE_CLASS(klass) \
(G_TYPE_CHECK_CLASS_TYPE ((klass), \
GABBLE_TYPE_PRESENCE))
#define GABBLE_PRESENCE_GET_CLASS(obj) \
(G_TYPE_INSTANCE_GET_CLASS ((obj), \
GABBLE_TYPE_PRESENCE, GabblePresenceClass))
typedef struct _GabblePresencePrivate GabblePresencePrivate;
struct _GabblePresence {
GObject parent;
GabblePresenceId status;
gchar *status_message;
gchar *nickname;
gchar *avatar_sha1;
guint client_types;
gboolean keep_unavailable;
GabblePresencePrivate *priv;
};
typedef enum
{
GABBLE_CLIENT_TYPE_BOT = 1 << 0,
GABBLE_CLIENT_TYPE_CONSOLE = 1 << 1,
GABBLE_CLIENT_TYPE_GAME = 1 << 2,
GABBLE_CLIENT_TYPE_HANDHELD = 1 << 3,
GABBLE_CLIENT_TYPE_PC = 1 << 4,
GABBLE_CLIENT_TYPE_PHONE = 1 << 5,
GABBLE_CLIENT_TYPE_WEB = 1 << 6,
GABBLE_CLIENT_TYPE_SMS = 1 << 7,
} GabbleClientType;
typedef struct _GabblePresenceClass GabblePresenceClass;
struct _GabblePresenceClass {
GObjectClass parent_class;
};
GType gabble_presence_get_type (void);
GabblePresence* gabble_presence_new (void);
gboolean gabble_presence_update (GabblePresence *presence,
const gchar *resource, GabblePresenceId status,
const gchar *status_message, gint8 priority,
gboolean *update_client_types,
time_t now);
void gabble_presence_set_capabilities (GabblePresence *presence,
const gchar *resource,
const GabbleCapabilitySet *cap_set,
const GPtrArray *data_forms,
guint serial);
gboolean gabble_presence_has_cap (GabblePresence *presence, const gchar *ns);
GabbleCapabilitySet *gabble_presence_dup_caps (GabblePresence *presence);
const GabbleCapabilitySet *gabble_presence_peek_caps (GabblePresence *presence);
GPtrArray *gabble_presence_peek_data_forms (GabblePresence *presence);
gboolean gabble_presence_has_resources (GabblePresence *self);
const gchar *gabble_presence_pick_resource_by_caps (GabblePresence *presence,
GabbleClientType preferred_client_type,
GabbleCapabilitySetPredicate predicate,
gconstpointer user_data);
gboolean gabble_presence_resource_has_caps (GabblePresence *presence,
const gchar *resource, GabbleCapabilitySetPredicate predicate,
gconstpointer user_data);
WockyStanza *gabble_presence_as_message (GabblePresence *presence,
const gchar *to);
void gabble_presence_add_status_and_vcard (GabblePresence *presence,
WockyStanza *stanza);
gchar *gabble_presence_dump (GabblePresence *presence);
gboolean gabble_presence_added_to_view (GabblePresence *presence);
gboolean gabble_presence_removed_from_view (GabblePresence *presence);
/* Data-driven feature fallback */
typedef struct {
gboolean considered;
gconstpointer check_data;
gconstpointer result;
} GabbleFeatureFallback;
gconstpointer gabble_presence_resource_pick_best_feature (
GabblePresence *presence,
const gchar *resource,
const GabbleFeatureFallback *table,
GabbleCapabilitySetPredicate predicate);
gconstpointer
gabble_presence_pick_best_feature (GabblePresence *presence,
const GabbleFeatureFallback *table,
GabbleCapabilitySetPredicate predicate);
gboolean gabble_presence_update_client_types (GabblePresence *presence,
const gchar *resource,
guint client_types);
gchar **gabble_presence_get_client_types_array (GabblePresence *presence,
const gchar **resource_name);
G_END_DECLS
#endif /* __GABBLE_PRESENCE_H__ */
|
