| wocky Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | Signals | ||||
WockyMuc; WockyMucClass; WockyMucPrivate; enum WockyMucStatusCode; enum WockyMucRole; enum WockyMucAffiliation; enum WockyMucFeature; enum WockyMucMsgType; enum WockyMucMsgState; enum WockyMucState; WockyMucMember; void wocky_muc_disco_info_async (WockyMuc *muc,GAsyncReadyCallback callback,GCancellable *cancel,gpointer data); gboolean wocky_muc_disco_info_finish (WockyMuc *muc,GAsyncResult *res,GError **error); WockyStanza * wocky_muc_create_presence (WockyMuc *muc,WockyStanzaSubType type,const gchar *status,const gchar *password); void wocky_muc_initiate_async (WockyMuc *muc,GAsyncReadyCallback callback,GCancellable *cancel,gpointer data); gboolean wocky_muc_initiate_finish (GObject *source,GAsyncResult *res,GError **error); void wocky_muc_join (WockyMuc *muc,GCancellable *cancel); const gchar * wocky_muc_jid (WockyMuc *muc); const gchar * wocky_muc_user (WockyMuc *muc); WockyMucRole wocky_muc_role (WockyMuc *muc); WockyMucAffiliation wocky_muc_affiliation (WockyMuc *muc); GHashTable * wocky_muc_members (WockyMuc *muc); WockyMucState wocky_muc_get_state (WockyMuc *muc);
"affiliation" WockyMucAffiliation : Read "category" gchar* : Read "description" gchar* : Read "jid" gchar* : Read / Write "muc-flags" gulong : Read "name" gchar* : Read "nickname" gchar* : Read "password" gchar* : Read / Write "porter" WockyPorter* : Read / Write / Construct Only "reserved-nick" gchar* : Read "role" guint : Read "room" gchar* : Read "service" gchar* : Read "status-message" gchar* : Read "type" gchar* : Read "user" gchar* : Read / Write / Construct Only
"error" : Run Last "fill-presence" : Run Last "joined" : Run Last "left" : Run Last "message" : Run Last "message-error" : Run Last "nick-change" : Run Last "own-presence" : Run Last "parted" : Run Last "permissions" : Run Last "presence" : Run Last
typedef enum {
WOCKY_MUC_CODE_UNKNOWN = 0,
WOCKY_MUC_CODE_ONYMOUS,
WOCKY_MUC_CODE_AF_CHANGE_OOB,
WOCKY_MUC_CODE_CFG_SHOW_UNAVAILABLE,
WOCKY_MUC_CODE_CFG_HIDE_UNAVAILABLE,
WOCKY_MUC_CODE_CFG_NONPRIVACY,
WOCKY_MUC_CODE_OWN_PRESENCE,
WOCKY_MUC_CODE_CFG_LOGGING_ENABLED,
WOCKY_MUC_CODE_CFG_LOGGING_DISABLED,
WOCKY_MUC_CODE_CFG_ONYMOUS,
WOCKY_MUC_CODE_CFG_SEMIONYMOUS,
WOCKY_MUC_CODE_CFG_ANONYMOUS,
WOCKY_MUC_CODE_NEW_ROOM,
WOCKY_MUC_CODE_NICK_CHANGE_FORCED,
WOCKY_MUC_CODE_BANNED,
WOCKY_MUC_CODE_NICK_CHANGE_USER,
WOCKY_MUC_CODE_KICKED,
WOCKY_MUC_CODE_KICKED_AFFILIATION,
WOCKY_MUC_CODE_KICKED_ROOM_PRIVATISED,
WOCKY_MUC_CODE_KICKED_SHUTDOWN,
} WockyMucStatusCode;
| Room entered is not anonymous | |
| Affiliation changed when not present | |
| Unavailable members visible | |
| Unavailable members invisible | |
| Non-privacy config change | |
| User's own presence | |
| Logging enabled | |
| Logging disabled | |
| Room is now non-anonymous | |
| Room is now semi-anonymous | |
| Room is now fully-anonymous | |
| Room created (eg by joining) | |
| Service enforced nick change | |
| User has been banned | |
| User's nick changed | |
| Kicked from the room | |
| Kicked (affiliation change) | |
| Kicked (room is now members-only) | |
| Kicked (shutdown) |
typedef enum {
WOCKY_MUC_ROLE_NONE = 0,
WOCKY_MUC_ROLE_VISITOR,
WOCKY_MUC_ROLE_PARTICIPANT,
WOCKY_MUC_ROLE_MODERATOR
} WockyMucRole;
typedef enum {
WOCKY_MUC_AFFILIATION_OUTCAST = -1,
WOCKY_MUC_AFFILIATION_NONE = 0,
WOCKY_MUC_AFFILIATION_MEMBER,
WOCKY_MUC_AFFILIATION_ADMIN,
WOCKY_MUC_AFFILIATION_OWNER,
} WockyMucAffiliation;
typedef enum {
WOCKY_MUC_MODERN = 1,
WOCKY_MUC_FORM_REGISTER = (1 << 1),
WOCKY_MUC_FORM_ROOMCONFIG = (1 << 2),
WOCKY_MUC_FORM_ROOMINFO = (1 << 3),
WOCKY_MUC_HIDDEN = (1 << 4),
WOCKY_MUC_MEMBERSONLY = (1 << 5),
WOCKY_MUC_MODERATED = (1 << 6),
WOCKY_MUC_NONANONYMOUS = (1 << 7),
WOCKY_MUC_OPEN = (1 << 8),
WOCKY_MUC_PASSWORDPROTECTED = (1 << 9),
WOCKY_MUC_PERSISTENT = (1 << 10),
WOCKY_MUC_PUBLIC = (1 << 11),
WOCKY_MUC_ROOMS = (1 << 12),
WOCKY_MUC_SEMIANONYMOUS = (1 << 13),
WOCKY_MUC_TEMPORARY = (1 << 14),
WOCKY_MUC_UNMODERATED = (1 << 15),
WOCKY_MUC_UNSECURED = (1 << 16),
WOCKY_MUC_OBSOLETE = (1 << 17),
} WockyMucFeature;
typedef enum {
WOCKY_MUC_MSG_NONE,
WOCKY_MUC_MSG_NORMAL,
WOCKY_MUC_MSG_ACTION,
WOCKY_MUC_MSG_NOTICE,
} WockyMucMsgType;
typedef enum {
WOCKY_MUC_MSG_STATE_NONE = -1,
WOCKY_MUC_MSG_STATE_ACTIVE,
WOCKY_MUC_MSG_STATE_TYPING,
WOCKY_MUC_MSG_STATE_INACTIVE,
WOCKY_MUC_MSG_STATE_PAUSED,
} WockyMucMsgState;
typedef enum {
WOCKY_MUC_CREATED = 0,
WOCKY_MUC_INITIATED,
WOCKY_MUC_AUTH,
WOCKY_MUC_JOINED,
WOCKY_MUC_ENDED,
} WockyMucState;
typedef struct {
gchar *from; /* room@service/nick */
gchar *jid; /* owner@domain/resource */
gchar *nick; /* nick */
WockyMucRole role;
WockyMucAffiliation affiliation;
gchar *status; /* user set status string */
WockyStanza *presence_stanza;
} WockyMucMember;
void wocky_muc_disco_info_async (WockyMuc *muc,GAsyncReadyCallback callback,GCancellable *cancel,gpointer data);
|
|
|
|
|
|
|
gboolean wocky_muc_disco_info_finish (WockyMuc *muc,GAsyncResult *res,GError **error);
|
|
|
|
|
|
Returns : |
WockyStanza * wocky_muc_create_presence (WockyMuc *muc,WockyStanzaSubType type,const gchar *status,const gchar *password);
|
|
|
|
|
|
|
|
Returns : |
void wocky_muc_initiate_async (WockyMuc *muc,GAsyncReadyCallback callback,GCancellable *cancel,gpointer data);
|
|
|
|
|
|
|
gboolean wocky_muc_initiate_finish (GObject *source,GAsyncResult *res,GError **error);
|
|
|
|
|
|
Returns : |
"affiliation" property"affiliation" WockyMucAffiliation : Read
The affiliation of the user with the MUC room.
Default value: WOCKY_MUC_AFFILIATION_NONE
"category" property"category" gchar* : Read
Category of the MUC, usually "conference".
Default value: NULL
"description" property"description" gchar* : Read
The long description oof the room.
Default value: NULL
"jid" property"jid" gchar* : Read / Write
Full room@service/nick JID of the MUC room.
Default value: NULL
"name" property"name" gchar* : Read
The human-readable name of the room (usually a short label).
Default value: NULL
"password" property"password" gchar* : Read / Write
User's MUC room password.
Default value: NULL
"porter" property"porter" WockyPorter* : Read / Write / Construct Only
The WockyPorter instance doing all the actual XMPP interaction.
"reserved-nick" property"reserved-nick" gchar* : Read
The user's reserved in-room nickname, if any.
Default value: NULL
"role" property"role" guint : Read
The role (WockyMucRole) of the user in the MUC room.
Allowed values: <= 3
Default value: 0
"service" property"service" gchar* : Read
The service (domain) part of the MUC JID.
Default value: NULL
"status-message" property"status-message" gchar* : Read
User's MUC status message.
Default value: NULL
"user" property"user" gchar* : Read / Write / Construct Only
Full JID of the user (node@domain/resource) who is connecting.
Default value: NULL
"error" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, WockyXmppError arg2, gchar *arg3, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
"fill-presence" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
user data set when the signal handler was connected. |
"joined" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, GHashTable *arg2, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
user data set when the signal handler was connected. |
"left" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, GHashTable *arg2, gpointer arg3, gchar *arg4, gchar *arg5, gchar *arg6, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
"message" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, WockyMucMsgType arg2, gchar *arg3, glong arg4, gpointer arg5, gchar *arg6, gchar *arg7, WockyMucMsgState arg8, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
"message-error" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, WockyMucMsgType arg2, gchar *arg3, glong arg4, gpointer arg5, gchar *arg6, WockyXmppError arg7, WockyXmppErrorType arg8, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
"nick-change" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, GHashTable *arg2, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
user data set when the signal handler was connected. |
"own-presence" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, GHashTable *arg2, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
user data set when the signal handler was connected. |
"parted" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, GHashTable *arg2, gchar *arg3, gchar *arg4, gchar *arg5, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
"permissions" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, GHashTable *arg2, gchar *arg3, gchar *arg4, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
|
|
user data set when the signal handler was connected. |
"presence" signalvoid user_function (WockyMuc *wockymuc, WockyStanza *arg1, GHashTable *arg2, gpointer arg3, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
|
|
|
|
user data set when the signal handler was connected. |