1 /* -*- Mode: C; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2; -*- */
3 * Copyright (C) 2007-2009 Collabora Ltd.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 * Authors: Xavier Claessens <xclaesse@gmail.com>
25 #include <geocode-glib/geocode-glib.h>
28 #include "empathy-utils.h"
29 #include "empathy-enum-types.h"
31 #define DEBUG_FLAG EMPATHY_DEBUG_CONTACT
32 #include "empathy-debug.h"
34 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyContact)
36 TpContact *tp_contact;
38 FolksPersona *persona;
42 EmpathyAvatar *avatar;
43 TpConnectionPresenceType presence;
45 EmpathyCapabilities capabilities;
47 /* Location is composed of string keys and GValues.
48 * Example: a "city" key would have "Helsinki" as string GValue,
49 * a "latitude" would have 65.0 as double GValue.
51 * This is a super set of the location stored in TpContact as we can try add
52 * more fields by searching the address using geoclue.
59 static void contact_finalize (GObject *object);
60 static void contact_get_property (GObject *object, guint param_id,
61 GValue *value, GParamSpec *pspec);
62 static void contact_set_property (GObject *object, guint param_id,
63 const GValue *value, GParamSpec *pspec);
66 static void update_geocode (EmpathyContact *contact);
69 static void empathy_contact_set_location (EmpathyContact *contact,
70 GHashTable *location);
72 static void contact_set_client_types (EmpathyContact *contact,
73 const gchar * const *types);
75 static void set_capabilities_from_tp_caps (EmpathyContact *self,
76 TpCapabilities *caps);
78 static void contact_set_avatar (EmpathyContact *contact,
79 EmpathyAvatar *avatar);
80 static void contact_set_avatar_from_tp_contact (EmpathyContact *contact);
81 static gboolean contact_load_avatar_cache (EmpathyContact *contact,
84 G_DEFINE_TYPE (EmpathyContact, empathy_contact, G_TYPE_OBJECT);
97 PROP_PRESENCE_MESSAGE,
110 static guint signals[LAST_SIGNAL];
112 /* TpContact* -> EmpathyContact*, both borrowed ref */
113 static GHashTable *contacts_table = NULL;
116 tp_contact_notify_cb (TpContact *tp_contact,
120 EmpathyContactPriv *priv = GET_PRIV (contact);
122 /* Forward property notifications */
123 if (!tp_strdiff (param->name, "alias"))
124 g_object_notify (contact, "alias");
125 else if (!tp_strdiff (param->name, "presence-type")) {
126 TpConnectionPresenceType presence;
128 presence = empathy_contact_get_presence (EMPATHY_CONTACT (contact));
129 g_signal_emit (contact, signals[PRESENCE_CHANGED], 0, presence,
131 priv->presence = presence;
132 g_object_notify (contact, "presence");
134 else if (!tp_strdiff (param->name, "identifier"))
135 g_object_notify (contact, "id");
136 else if (!tp_strdiff (param->name, "handle"))
137 g_object_notify (contact, "handle");
138 else if (!tp_strdiff (param->name, "location"))
140 GHashTable *location;
142 location = tp_contact_get_location (tp_contact);
143 /* This will start a geoclue search to find the address if needed */
144 empathy_contact_set_location (EMPATHY_CONTACT (contact), location);
146 else if (!tp_strdiff (param->name, "capabilities"))
148 set_capabilities_from_tp_caps (EMPATHY_CONTACT (contact),
149 tp_contact_get_capabilities (tp_contact));
151 else if (!tp_strdiff (param->name, "avatar-file"))
153 contact_set_avatar_from_tp_contact (EMPATHY_CONTACT (contact));
155 else if (!tp_strdiff (param->name, "client-types"))
157 contact_set_client_types (EMPATHY_CONTACT (contact),
158 tp_contact_get_client_types (tp_contact));
163 folks_persona_notify_cb (FolksPersona *folks_persona,
167 if (!tp_strdiff (param->name, "presence-message"))
168 g_object_notify (contact, "presence-message");
172 contact_dispose (GObject *object)
174 EmpathyContactPriv *priv = GET_PRIV (object);
176 if (priv->tp_contact != NULL)
178 g_signal_handlers_disconnect_by_func (priv->tp_contact,
179 tp_contact_notify_cb, object);
181 tp_clear_object (&priv->tp_contact);
184 g_object_unref (priv->account);
185 priv->account = NULL;
189 g_signal_handlers_disconnect_by_func (priv->persona,
190 folks_persona_notify_cb, object);
191 g_object_unref (priv->persona);
193 priv->persona = NULL;
195 if (priv->avatar != NULL)
197 empathy_avatar_unref (priv->avatar);
201 if (priv->location != NULL)
203 g_hash_table_unref (priv->location);
204 priv->location = NULL;
207 G_OBJECT_CLASS (empathy_contact_parent_class)->dispose (object);
211 contact_constructed (GObject *object)
213 EmpathyContact *contact = (EmpathyContact *) object;
214 EmpathyContactPriv *priv = GET_PRIV (contact);
215 GHashTable *location;
216 TpContact *self_contact;
217 const gchar * const *client_types;
219 if (priv->tp_contact == NULL)
222 priv->presence = empathy_contact_get_presence (contact);
224 location = tp_contact_get_location (priv->tp_contact);
225 if (location != NULL)
226 empathy_contact_set_location (contact, location);
228 client_types = tp_contact_get_client_types (priv->tp_contact);
229 if (client_types != NULL)
230 contact_set_client_types (contact, client_types);
232 set_capabilities_from_tp_caps (contact,
233 tp_contact_get_capabilities (priv->tp_contact));
235 contact_set_avatar_from_tp_contact (contact);
237 /* Set is-user property. Note that it could still be the handle is
238 * different from the connection's self handle, in the case the handle
239 * comes from a group interface. */
240 self_contact = tp_connection_get_self_contact (
241 tp_contact_get_connection (priv->tp_contact));
242 empathy_contact_set_is_user (contact, self_contact == priv->tp_contact);
244 g_signal_connect (priv->tp_contact, "notify",
245 G_CALLBACK (tp_contact_notify_cb), contact);
249 empathy_contact_class_init (EmpathyContactClass *class)
251 GObjectClass *object_class;
253 object_class = G_OBJECT_CLASS (class);
255 object_class->finalize = contact_finalize;
256 object_class->dispose = contact_dispose;
257 object_class->get_property = contact_get_property;
258 object_class->set_property = contact_set_property;
259 object_class->constructed = contact_constructed;
261 g_object_class_install_property (object_class,
263 g_param_spec_object ("tp-contact",
265 "The TpContact associated with the contact",
267 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
269 g_object_class_install_property (object_class,
271 g_param_spec_object ("account",
273 "The account associated with the contact",
275 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
277 g_object_class_install_property (object_class,
279 g_param_spec_object ("persona",
281 "The FolksPersona associated with the contact",
283 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
285 g_object_class_install_property (object_class,
287 g_param_spec_string ("id",
289 "String identifying contact",
291 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
293 g_object_class_install_property (object_class,
295 g_param_spec_string ("alias",
297 "An alias for the contact",
299 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
301 g_object_class_install_property (object_class,
303 g_param_spec_string ("logged-alias",
305 "The alias the user had when a message was logged, "
306 "only set when using empathy_contact_from_tpl_contact()",
308 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
310 g_object_class_install_property (object_class,
312 g_param_spec_boxed ("avatar",
316 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
318 g_object_class_install_property (object_class,
320 g_param_spec_uint ("presence",
322 "Presence of contact",
323 TP_CONNECTION_PRESENCE_TYPE_UNSET,
324 NUM_TP_CONNECTION_PRESENCE_TYPES,
325 TP_CONNECTION_PRESENCE_TYPE_UNSET,
326 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
328 g_object_class_install_property (object_class,
329 PROP_PRESENCE_MESSAGE,
330 g_param_spec_string ("presence-message",
331 "Contact presence message",
332 "Presence message of contact",
334 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
336 g_object_class_install_property (object_class,
338 g_param_spec_uint ("handle",
340 "The handle of the contact",
344 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
346 g_object_class_install_property (object_class,
348 g_param_spec_flags ("capabilities",
349 "Contact Capabilities",
350 "Capabilities of the contact",
351 EMPATHY_TYPE_CAPABILITIES,
352 EMPATHY_CAPABILITIES_UNKNOWN,
353 G_PARAM_CONSTRUCT | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
355 g_object_class_install_property (object_class,
357 g_param_spec_boolean ("is-user",
359 "Is contact the user",
361 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
364 g_object_class_install_property (object_class,
366 g_param_spec_boxed ("location",
368 "Physical location of the contact",
370 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
372 g_object_class_install_property (object_class,
374 g_param_spec_boxed ("client-types",
375 "Contact client types",
376 "Client types of the contact",
378 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
380 signals[PRESENCE_CHANGED] =
381 g_signal_new ("presence-changed",
382 G_TYPE_FROM_CLASS (class),
386 g_cclosure_marshal_generic,
391 g_type_class_add_private (object_class, sizeof (EmpathyContactPriv));
395 empathy_contact_init (EmpathyContact *contact)
397 EmpathyContactPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (contact,
398 EMPATHY_TYPE_CONTACT, EmpathyContactPriv);
400 contact->priv = priv;
402 priv->location = NULL;
403 priv->client_types = NULL;
408 contact_finalize (GObject *object)
410 EmpathyContactPriv *priv;
412 priv = GET_PRIV (object);
414 DEBUG ("finalize: %p", object);
416 g_clear_object (&priv->groups);
417 g_free (priv->alias);
418 g_free (priv->logged_alias);
420 g_strfreev (priv->client_types);
422 G_OBJECT_CLASS (empathy_contact_parent_class)->finalize (object);
426 empathy_contact_set_capabilities (EmpathyContact *contact,
427 EmpathyCapabilities capabilities)
429 EmpathyContactPriv *priv;
431 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
433 priv = GET_PRIV (contact);
435 if (priv->capabilities == capabilities)
438 priv->capabilities = capabilities;
440 g_object_notify (G_OBJECT (contact), "capabilities");
444 empathy_contact_set_id (EmpathyContact *contact,
447 EmpathyContactPriv *priv;
449 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
450 g_return_if_fail (id != NULL);
452 priv = GET_PRIV (contact);
454 /* We temporally ref the contact because it could be destroyed
455 * during the signal emition */
456 g_object_ref (contact);
457 if (tp_strdiff (id, priv->id))
460 priv->id = g_strdup (id);
462 g_object_notify (G_OBJECT (contact), "id");
463 if (EMP_STR_EMPTY (priv->alias))
464 g_object_notify (G_OBJECT (contact), "alias");
467 g_object_unref (contact);
471 empathy_contact_set_presence (EmpathyContact *contact,
472 TpConnectionPresenceType presence)
474 EmpathyContactPriv *priv;
475 TpConnectionPresenceType old_presence;
477 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
479 priv = GET_PRIV (contact);
481 if (presence == priv->presence)
484 old_presence = priv->presence;
485 priv->presence = presence;
487 g_signal_emit (contact, signals[PRESENCE_CHANGED], 0, presence, old_presence);
489 g_object_notify (G_OBJECT (contact), "presence");
493 empathy_contact_set_presence_message (EmpathyContact *contact,
494 const gchar *message)
496 EmpathyContactPriv *priv = GET_PRIV (contact);
498 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
500 if (priv->persona != NULL)
502 folks_presence_details_set_presence_message (
503 FOLKS_PRESENCE_DETAILS (priv->persona), message);
508 empathy_contact_set_handle (EmpathyContact *contact,
511 EmpathyContactPriv *priv;
513 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
515 priv = GET_PRIV (contact);
517 g_object_ref (contact);
518 if (handle != priv->handle)
520 priv->handle = handle;
521 g_object_notify (G_OBJECT (contact), "handle");
523 g_object_unref (contact);
527 contact_get_property (GObject *object,
532 EmpathyContact *contact = EMPATHY_CONTACT (object);
536 case PROP_TP_CONTACT:
537 g_value_set_object (value, empathy_contact_get_tp_contact (contact));
540 g_value_set_object (value, empathy_contact_get_account (contact));
543 g_value_set_object (value, empathy_contact_get_persona (contact));
546 g_value_set_string (value, empathy_contact_get_id (contact));
549 g_value_set_string (value, empathy_contact_get_alias (contact));
551 case PROP_LOGGED_ALIAS:
552 g_value_set_string (value, empathy_contact_get_logged_alias (contact));
555 g_value_set_boxed (value, empathy_contact_get_avatar (contact));
558 g_value_set_uint (value, empathy_contact_get_presence (contact));
560 case PROP_PRESENCE_MESSAGE:
561 g_value_set_string (value, empathy_contact_get_presence_message (contact));
564 g_value_set_uint (value, empathy_contact_get_handle (contact));
566 case PROP_CAPABILITIES:
567 g_value_set_flags (value, empathy_contact_get_capabilities (contact));
570 g_value_set_boolean (value, empathy_contact_is_user (contact));
573 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
579 contact_set_property (GObject *object,
584 EmpathyContact *contact = EMPATHY_CONTACT (object);
585 EmpathyContactPriv *priv = GET_PRIV (object);
589 case PROP_TP_CONTACT:
590 priv->tp_contact = g_value_dup_object (value);
593 g_assert (priv->account == NULL);
594 priv->account = g_value_dup_object (value);
597 empathy_contact_set_persona (contact, g_value_get_object (value));
600 empathy_contact_set_id (contact, g_value_get_string (value));
603 empathy_contact_set_alias (contact, g_value_get_string (value));
605 case PROP_LOGGED_ALIAS:
606 g_assert (priv->logged_alias == NULL);
607 priv->logged_alias = g_value_dup_string (value);
610 empathy_contact_set_presence (contact, g_value_get_uint (value));
612 case PROP_PRESENCE_MESSAGE:
613 empathy_contact_set_presence_message (contact, g_value_get_string (value));
616 empathy_contact_set_handle (contact, g_value_get_uint (value));
618 case PROP_CAPABILITIES:
619 empathy_contact_set_capabilities (contact, g_value_get_flags (value));
622 empathy_contact_set_is_user (contact, g_value_get_boolean (value));
625 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
631 remove_tp_contact (gpointer data,
634 g_hash_table_remove (contacts_table, data);
637 static EmpathyContact *
638 empathy_contact_new (TpContact *tp_contact)
640 EmpathyContact *retval;
642 g_return_val_if_fail (TP_IS_CONTACT (tp_contact), NULL);
644 retval = g_object_new (EMPATHY_TYPE_CONTACT,
645 "tp-contact", tp_contact,
648 g_object_weak_ref (G_OBJECT (retval), remove_tp_contact, tp_contact);
660 contact_is_tpl_entity (gpointer key,
664 EmpathyContact *contact = value;
665 FindContactData *data = user_data;
666 TpAccount *account = empathy_contact_get_account (contact);
667 const gchar *path = NULL;
670 path = tp_proxy_get_object_path (account);
672 return !tp_strdiff (empathy_contact_get_id (contact),
673 tpl_entity_get_identifier (data->entity)) &&
674 !tp_strdiff (tp_proxy_get_object_path (data->account), path);
678 get_contacts_cb (GObject *source,
679 GAsyncResult *result,
682 TpWeakRef *wr = user_data;
683 EmpathyContactPriv *priv;
684 EmpathyContact *self;
686 self = tp_weak_ref_dup_object (wr);
690 priv = GET_PRIV (self);
692 g_return_if_fail (priv->tp_contact == NULL);
694 priv->tp_contact = tp_connection_dup_contact_by_id_finish (
695 TP_CONNECTION (source), result, NULL);
696 if (priv->tp_contact == NULL)
699 g_object_notify (G_OBJECT (self), "tp-contact");
701 /* Update capabilities now that we have a TpContact */
702 set_capabilities_from_tp_caps (self,
703 tp_contact_get_capabilities (priv->tp_contact));
706 g_clear_object (&self);
707 tp_weak_ref_destroy (wr);
711 empathy_contact_from_tpl_contact (TpAccount *account,
712 TplEntity *tpl_entity)
714 EmpathyContact *retval;
716 EmpathyContact *existing_contact = NULL;
718 g_return_val_if_fail (TPL_IS_ENTITY (tpl_entity), NULL);
720 if (contacts_table != NULL)
722 FindContactData data;
724 data.entity = tpl_entity;
725 data.account = account;
727 existing_contact = g_hash_table_find (contacts_table,
728 contact_is_tpl_entity, &data);
731 if (existing_contact != NULL)
733 retval = g_object_new (EMPATHY_TYPE_CONTACT,
734 "tp-contact", empathy_contact_get_tp_contact (existing_contact),
735 "logged-alias", tpl_entity_get_alias (tpl_entity),
743 is_user = (TPL_ENTITY_SELF == tpl_entity_get_entity_type (tpl_entity));
745 id = tpl_entity_get_identifier (tpl_entity);
747 retval = g_object_new (EMPATHY_TYPE_CONTACT,
749 "alias", tpl_entity_get_alias (tpl_entity),
754 /* Try to get a TpContact associated to have at least contact
755 * capabilities if possible. This is useful for CM supporting calling
756 * offline contacts for example. */
757 conn = tp_account_get_connection (account);
760 TpContactFeature features[] = { TP_CONTACT_FEATURE_CAPABILITIES };
761 conn = tp_account_get_connection (account);
763 tp_connection_dup_contact_by_id_async (conn, id,
764 G_N_ELEMENTS (features), features, get_contacts_cb,
765 tp_weak_ref_new (retval, NULL, NULL));
769 if (!EMP_STR_EMPTY (tpl_entity_get_avatar_token (tpl_entity)))
770 contact_load_avatar_cache (retval,
771 tpl_entity_get_avatar_token (tpl_entity));
777 empathy_contact_get_tp_contact (EmpathyContact *contact)
779 EmpathyContactPriv *priv;
781 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
783 priv = GET_PRIV (contact);
785 return priv->tp_contact;
789 empathy_contact_get_id (EmpathyContact *contact)
791 EmpathyContactPriv *priv;
793 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
795 priv = GET_PRIV (contact);
797 if (priv->tp_contact != NULL)
798 return tp_contact_get_identifier (priv->tp_contact);
804 empathy_contact_get_alias (EmpathyContact *contact)
806 EmpathyContactPriv *priv;
807 const gchar *alias = NULL;
809 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
811 priv = GET_PRIV (contact);
813 if (!EMP_STR_EMPTY (priv->alias))
815 else if (priv->tp_contact != NULL)
816 alias = tp_contact_get_alias (priv->tp_contact);
818 if (!EMP_STR_EMPTY (alias))
821 return empathy_contact_get_id (contact);
825 empathy_contact_get_logged_alias (EmpathyContact *contact)
827 EmpathyContactPriv *priv;
829 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
831 priv = GET_PRIV (contact);
833 if (priv->logged_alias != NULL)
834 return priv->logged_alias;
836 return empathy_contact_get_alias (contact);
840 empathy_contact_set_alias (EmpathyContact *contact,
843 EmpathyContactPriv *priv;
844 FolksPersona *persona;
846 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
848 priv = GET_PRIV (contact);
850 g_object_ref (contact);
852 /* Set the alias on the persona if possible */
853 persona = empathy_contact_get_persona (contact);
854 if (persona != NULL && FOLKS_IS_ALIAS_DETAILS (persona))
856 DEBUG ("Setting alias for contact %s to %s",
857 empathy_contact_get_id (contact), alias);
859 folks_alias_details_set_alias (FOLKS_ALIAS_DETAILS (persona), alias);
862 if (tp_strdiff (alias, priv->alias))
864 g_free (priv->alias);
865 priv->alias = g_strdup (alias);
866 g_object_notify (G_OBJECT (contact), "alias");
869 g_object_unref (contact);
873 groups_change_group_cb (GObject *source,
874 GAsyncResult *result,
877 FolksGroupDetails *group_details = FOLKS_GROUP_DETAILS (source);
878 GError *error = NULL;
880 folks_group_details_change_group_finish (group_details, result, &error);
883 g_warning ("failed to change group: %s", error->message);
884 g_clear_error (&error);
889 empathy_contact_change_group (EmpathyContact *contact, const gchar *group,
892 EmpathyContactPriv *priv;
893 FolksPersona *persona;
895 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
896 g_return_if_fail (group != NULL);
898 priv = GET_PRIV (contact);
900 /* Normally pass through the changes to the persona */
901 persona = empathy_contact_get_persona (contact);
904 if (FOLKS_IS_GROUP_DETAILS (persona))
905 folks_group_details_change_group (FOLKS_GROUP_DETAILS (persona), group,
906 is_member, groups_change_group_cb, contact);
910 /* If the persona doesn't exist yet, we have to cache the changes until it
912 if (priv->groups == NULL)
914 priv->groups = gee_hash_set_new (G_TYPE_STRING, (GBoxedCopyFunc) g_strdup,
915 g_free, NULL, NULL, NULL, NULL, NULL, NULL);
918 gee_collection_add (GEE_COLLECTION (priv->groups), group);
922 empathy_contact_get_avatar (EmpathyContact *contact)
924 EmpathyContactPriv *priv;
926 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
928 priv = GET_PRIV (contact);
934 contact_set_avatar (EmpathyContact *contact,
935 EmpathyAvatar *avatar)
937 EmpathyContactPriv *priv;
939 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
941 priv = GET_PRIV (contact);
943 if (priv->avatar == avatar)
948 empathy_avatar_unref (priv->avatar);
953 priv->avatar = empathy_avatar_ref (avatar);
955 g_object_notify (G_OBJECT (contact), "avatar");
959 empathy_contact_get_account (EmpathyContact *contact)
961 EmpathyContactPriv *priv;
963 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
965 priv = GET_PRIV (contact);
967 if (priv->account == NULL && priv->tp_contact != NULL)
969 TpConnection *connection;
971 /* FIXME: This assume the account manager already exists */
972 connection = tp_contact_get_connection (priv->tp_contact);
974 g_object_ref (tp_connection_get_account (connection));
977 return priv->account;
981 empathy_contact_get_persona (EmpathyContact *contact)
983 EmpathyContactPriv *priv;
985 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
987 priv = GET_PRIV (contact);
989 if (priv->persona == NULL && priv->tp_contact != NULL)
993 persona = tpf_persona_dup_for_contact (priv->tp_contact);
996 empathy_contact_set_persona (contact, (FolksPersona *) persona);
997 g_object_unref (persona);
1001 return priv->persona;
1005 empathy_contact_set_persona (EmpathyContact *contact,
1006 FolksPersona *persona)
1008 EmpathyContactPriv *priv;
1010 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
1011 g_return_if_fail (TPF_IS_PERSONA (persona));
1013 priv = GET_PRIV (contact);
1015 if (persona == priv->persona)
1018 if (priv->persona != NULL)
1020 g_signal_handlers_disconnect_by_func (priv->persona,
1021 folks_persona_notify_cb, contact);
1022 g_object_unref (priv->persona);
1024 priv->persona = g_object_ref (persona);
1026 g_signal_connect (priv->persona, "notify",
1027 G_CALLBACK (folks_persona_notify_cb), contact);
1029 g_object_notify (G_OBJECT (contact), "persona");
1031 /* Set the persona's alias, since ours could've been set using
1032 * empathy_contact_set_alias() before we had a persona; this happens when
1033 * adding a contact. */
1034 if (priv->alias != NULL)
1035 empathy_contact_set_alias (contact, priv->alias);
1037 /* Set the persona's groups */
1038 if (priv->groups != NULL)
1040 folks_group_details_set_groups (FOLKS_GROUP_DETAILS (persona),
1041 GEE_SET (priv->groups));
1042 g_object_unref (priv->groups);
1043 priv->groups = NULL;
1048 empathy_contact_get_connection (EmpathyContact *contact)
1050 EmpathyContactPriv *priv;
1052 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
1054 priv = GET_PRIV (contact);
1056 if (priv->tp_contact != NULL)
1057 return tp_contact_get_connection (priv->tp_contact);
1062 TpConnectionPresenceType
1063 empathy_contact_get_presence (EmpathyContact *contact)
1065 EmpathyContactPriv *priv;
1067 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact),
1068 TP_CONNECTION_PRESENCE_TYPE_UNSET);
1070 priv = GET_PRIV (contact);
1072 if (priv->tp_contact != NULL)
1073 return tp_contact_get_presence_type (priv->tp_contact);
1075 return priv->presence;
1079 empathy_contact_get_presence_message (EmpathyContact *contact)
1081 EmpathyContactPriv *priv;
1083 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
1085 priv = GET_PRIV (contact);
1087 if (priv->persona != NULL)
1088 return folks_presence_details_get_presence_message (
1089 FOLKS_PRESENCE_DETAILS (priv->persona));
1091 if (priv->tp_contact != NULL)
1092 return tp_contact_get_presence_message (priv->tp_contact);
1098 empathy_contact_get_handle (EmpathyContact *contact)
1100 EmpathyContactPriv *priv;
1102 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
1104 priv = GET_PRIV (contact);
1106 if (priv->tp_contact != NULL)
1107 return tp_contact_get_handle (priv->tp_contact);
1109 return priv->handle;
1113 empathy_contact_get_capabilities (EmpathyContact *contact)
1115 EmpathyContactPriv *priv;
1117 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
1119 priv = GET_PRIV (contact);
1121 return priv->capabilities;
1125 empathy_contact_is_user (EmpathyContact *contact)
1127 EmpathyContactPriv *priv;
1129 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1131 priv = GET_PRIV (contact);
1133 return priv->is_user;
1137 empathy_contact_set_is_user (EmpathyContact *contact,
1140 EmpathyContactPriv *priv;
1142 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
1144 priv = GET_PRIV (contact);
1146 if (priv->is_user == is_user)
1149 priv->is_user = is_user;
1151 g_object_notify (G_OBJECT (contact), "is-user");
1155 empathy_contact_is_online (EmpathyContact *contact)
1157 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1159 switch (empathy_contact_get_presence (contact))
1161 case TP_CONNECTION_PRESENCE_TYPE_OFFLINE:
1162 case TP_CONNECTION_PRESENCE_TYPE_UNKNOWN:
1163 case TP_CONNECTION_PRESENCE_TYPE_ERROR:
1165 /* Contacts without presence are considered online so we can display IRC
1166 * contacts in rooms. */
1167 case TP_CONNECTION_PRESENCE_TYPE_UNSET:
1168 case TP_CONNECTION_PRESENCE_TYPE_AVAILABLE:
1169 case TP_CONNECTION_PRESENCE_TYPE_AWAY:
1170 case TP_CONNECTION_PRESENCE_TYPE_EXTENDED_AWAY:
1171 case TP_CONNECTION_PRESENCE_TYPE_HIDDEN:
1172 case TP_CONNECTION_PRESENCE_TYPE_BUSY:
1179 empathy_contact_get_status (EmpathyContact *contact)
1181 const gchar *message;
1183 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
1185 message = empathy_contact_get_presence_message (contact);
1186 if (!EMP_STR_EMPTY (message))
1189 return empathy_presence_get_default_message (
1190 empathy_contact_get_presence (contact));
1194 empathy_contact_can_sms (EmpathyContact *contact)
1196 EmpathyContactPriv *priv;
1198 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1200 priv = GET_PRIV (contact);
1202 return priv->capabilities & EMPATHY_CAPABILITIES_SMS;
1206 empathy_contact_can_voip (EmpathyContact *contact)
1208 EmpathyContactPriv *priv;
1210 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1212 priv = GET_PRIV (contact);
1214 return priv->capabilities & (EMPATHY_CAPABILITIES_AUDIO |
1215 EMPATHY_CAPABILITIES_VIDEO);
1219 empathy_contact_can_voip_audio (EmpathyContact *contact)
1221 EmpathyContactPriv *priv;
1223 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1225 priv = GET_PRIV (contact);
1227 return priv->capabilities & EMPATHY_CAPABILITIES_AUDIO;
1231 empathy_contact_can_voip_video (EmpathyContact *contact)
1233 EmpathyContactPriv *priv;
1235 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1237 priv = GET_PRIV (contact);
1239 return priv->capabilities & EMPATHY_CAPABILITIES_VIDEO;
1243 empathy_contact_can_send_files (EmpathyContact *contact)
1245 EmpathyContactPriv *priv;
1247 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1249 priv = GET_PRIV (contact);
1251 return priv->capabilities & EMPATHY_CAPABILITIES_FT;
1255 empathy_contact_can_use_rfb_stream_tube (EmpathyContact *contact)
1257 EmpathyContactPriv *priv;
1259 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1261 priv = GET_PRIV (contact);
1263 return priv->capabilities & EMPATHY_CAPABILITIES_RFB_STREAM_TUBE;
1267 contact_has_log (EmpathyContact *contact)
1269 TplLogManager *manager;
1273 manager = tpl_log_manager_dup_singleton ();
1274 entity = tpl_entity_new (empathy_contact_get_id (contact),
1275 TPL_ENTITY_CONTACT, NULL, NULL);
1277 have_log = tpl_log_manager_exists (manager,
1278 empathy_contact_get_account (contact), entity, TPL_EVENT_MASK_TEXT);
1280 g_object_unref (entity);
1281 g_object_unref (manager);
1287 empathy_contact_can_do_action (EmpathyContact *self,
1288 EmpathyActionType action_type)
1290 gboolean sensitivity = FALSE;
1292 switch (action_type)
1294 case EMPATHY_ACTION_CHAT:
1297 case EMPATHY_ACTION_SMS:
1298 sensitivity = empathy_contact_can_sms (self);
1300 case EMPATHY_ACTION_AUDIO_CALL:
1301 sensitivity = empathy_contact_can_voip_audio (self);
1303 case EMPATHY_ACTION_VIDEO_CALL:
1304 sensitivity = empathy_contact_can_voip_video (self);
1306 case EMPATHY_ACTION_VIEW_LOGS:
1307 sensitivity = contact_has_log (self);
1309 case EMPATHY_ACTION_SEND_FILE:
1310 sensitivity = empathy_contact_can_send_files (self);
1312 case EMPATHY_ACTION_SHARE_MY_DESKTOP:
1313 sensitivity = empathy_contact_can_use_rfb_stream_tube (self);
1316 g_assert_not_reached ();
1319 return (sensitivity ? TRUE : FALSE);
1323 contact_get_avatar_filename (EmpathyContact *contact,
1329 gchar *token_escaped;
1331 if (EMP_STR_EMPTY (empathy_contact_get_id (contact)))
1334 token_escaped = tp_escape_as_identifier (token);
1335 account = empathy_contact_get_account (contact);
1337 avatar_path = g_build_filename (g_get_user_cache_dir (),
1340 tp_account_get_cm_name (account),
1341 tp_account_get_protocol_name (account),
1343 g_mkdir_with_parents (avatar_path, 0700);
1345 avatar_file = g_build_filename (avatar_path, token_escaped, NULL);
1347 g_free (token_escaped);
1348 g_free (avatar_path);
1354 contact_load_avatar_cache (EmpathyContact *contact,
1357 EmpathyAvatar *avatar = NULL;
1361 GError *error = NULL;
1363 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1364 g_return_val_if_fail (!EMP_STR_EMPTY (token), FALSE);
1366 /* Load the avatar from file if it exists */
1367 filename = contact_get_avatar_filename (contact, token);
1368 if (filename && g_file_test (filename, G_FILE_TEST_EXISTS))
1370 if (!g_file_get_contents (filename, &data, &len, &error))
1372 DEBUG ("Failed to load avatar from cache: %s",
1373 error ? error->message : "No error given");
1374 g_clear_error (&error);
1380 DEBUG ("Avatar loaded from %s", filename);
1381 avatar = empathy_avatar_new ((guchar *) data, len, NULL, filename);
1382 contact_set_avatar (contact, avatar);
1383 empathy_avatar_unref (avatar);
1389 return data != NULL;
1393 empathy_avatar_get_type (void)
1395 static GType type_id = 0;
1399 type_id = g_boxed_type_register_static ("EmpathyAvatar",
1400 (GBoxedCopyFunc) empathy_avatar_ref,
1401 (GBoxedFreeFunc) empathy_avatar_unref);
1408 * empathy_avatar_new:
1409 * @data: the avatar data
1410 * @len: the size of avatar data
1411 * @format: the mime type of the avatar image
1412 * @filename: the filename where the avatar is stored in cache
1414 * Create a #EmpathyAvatar from the provided data.
1416 * Returns: a new #EmpathyAvatar
1419 empathy_avatar_new (const guchar *data,
1421 const gchar *format,
1422 const gchar *filename)
1424 EmpathyAvatar *avatar;
1426 avatar = g_slice_new0 (EmpathyAvatar);
1427 avatar->data = g_memdup (data, len);
1429 avatar->format = g_strdup (format);
1430 avatar->filename = g_strdup (filename);
1431 avatar->refcount = 1;
1437 empathy_avatar_unref (EmpathyAvatar *avatar)
1439 g_return_if_fail (avatar != NULL);
1442 if (avatar->refcount == 0)
1444 g_free (avatar->data);
1445 g_free (avatar->format);
1446 g_free (avatar->filename);
1447 g_slice_free (EmpathyAvatar, avatar);
1452 empathy_avatar_ref (EmpathyAvatar *avatar)
1454 g_return_val_if_fail (avatar != NULL, NULL);
1462 * empathy_avatar_save_to_file:
1463 * @avatar: the avatar
1464 * @filename: name of a file to write avatar to
1465 * @error: return location for a GError, or NULL
1467 * Save the avatar to a file named filename
1469 * Returns: %TRUE on success, %FALSE if an error occurred
1472 empathy_avatar_save_to_file (EmpathyAvatar *self,
1473 const gchar *filename,
1476 return g_file_set_contents (filename, (const gchar *) self->data, self->len,
1481 * empathy_contact_get_location:
1482 * @contact: an #EmpathyContact
1484 * Returns the user's location if available. The keys are defined in
1485 * empathy-location.h. If the contact doesn't have location
1486 * information, the GHashTable will be empthy. Use #g_hash_table_unref when
1487 * you are done with the #GHashTable.
1489 * It is composed of string keys and GValues. Keys are
1490 * defined in empathy-location.h such as #EMPATHY_LOCATION_COUNTRY.
1491 * Example: a "city" key would have "Helsinki" as string GValue,
1492 * a "latitude" would have 65.0 as double GValue.
1494 * Returns: a #GHashTable of location values
1497 empathy_contact_get_location (EmpathyContact *contact)
1499 EmpathyContactPriv *priv;
1501 g_return_val_if_fail (EMPATHY_CONTACT (contact), NULL);
1503 priv = GET_PRIV (contact);
1505 return priv->location;
1509 * empathy_contact_set_location:
1510 * @contact: an #EmpathyContact
1511 * @location: a #GHashTable of the location
1513 * Sets the user's location based on the location #GHashTable passed.
1514 * It is composed of string keys and GValues. Keys are
1515 * defined in empathy-location.h such as #EMPATHY_LOCATION_COUNTRY.
1516 * Example: a "city" key would have "Helsinki" as string GValue,
1517 * a "latitude" would have 65.0 as double GValue.
1520 empathy_contact_set_location (EmpathyContact *contact,
1521 GHashTable *location)
1523 EmpathyContactPriv *priv;
1525 g_return_if_fail (EMPATHY_CONTACT (contact));
1526 g_return_if_fail (location != NULL);
1528 priv = GET_PRIV (contact);
1530 if (priv->location != NULL)
1531 g_hash_table_unref (priv->location);
1533 priv->location = g_hash_table_ref (location);
1535 update_geocode (contact);
1537 g_object_notify (G_OBJECT (contact), "location");
1540 const gchar * const *
1541 empathy_contact_get_client_types (EmpathyContact *contact)
1543 EmpathyContactPriv *priv;
1545 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
1547 priv = GET_PRIV (contact);
1549 return (const gchar * const *) priv->client_types;
1553 contact_set_client_types (EmpathyContact *contact,
1554 const gchar * const *client_types)
1556 EmpathyContactPriv *priv = GET_PRIV (contact);
1558 if (priv->client_types != NULL)
1559 g_strfreev (priv->client_types);
1561 priv->client_types = g_strdupv ((gchar **) client_types);
1562 g_object_notify (G_OBJECT (contact), "client-types");
1566 * empathy_contact_equal:
1567 * @contact1: an #EmpathyContact
1568 * @contact2: an #EmpathyContact
1570 * Returns FALSE if one of the contacts is NULL but the other is not.
1571 * Otherwise returns TRUE if both pointer are equal or if they bith
1572 * refer to the same id.
1573 * It's only necessary to call this function if your contact objects
1574 * come from logs where contacts are created dynamically and comparing
1575 * pointers is not enough.
1578 empathy_contact_equal (gconstpointer contact1,
1579 gconstpointer contact2)
1586 if ((contact1 == NULL) != (contact2 == NULL)) {
1589 if (contact1 == contact2) {
1592 c1 = EMPATHY_CONTACT (contact1);
1593 c2 = EMPATHY_CONTACT (contact2);
1594 id1 = empathy_contact_get_id (c1);
1595 id2 = empathy_contact_get_id (c2);
1596 if (!tp_strdiff (id1, id2)) {
1603 /* This callback is called by geocode-glib when it found a position
1604 * for the given address. A position is necessary for a contact
1605 * to show up on the map
1608 geocode_cb (GObject *source,
1609 GAsyncResult *result,
1612 EmpathyContact *contact = user_data;
1613 EmpathyContactPriv *priv = GET_PRIV (contact);
1614 GError *error = NULL;
1616 GeocodeLocation *loc;
1617 GHashTable *new_location;
1618 GHashTable *resolved = NULL;
1619 gdouble latitude, longitude;
1621 if (priv->location == NULL)
1624 res = geocode_forward_search_finish (GEOCODE_FORWARD (source), result,
1629 DEBUG ("Failed to resolve geocode: %s", error->message);
1630 g_error_free (error);
1636 new_location = tp_asv_new (
1637 EMPATHY_LOCATION_LAT, G_TYPE_DOUBLE, loc->latitude,
1638 EMPATHY_LOCATION_LON, G_TYPE_DOUBLE, loc->longitude,
1641 DEBUG ("\t - Latitude: %f", loc->latitude);
1642 DEBUG ("\t - Longitude: %f", loc->longitude);
1644 g_list_free_full (res, (GDestroyNotify) geocode_location_free);
1646 /* Copy remaning fields. LAT and LON were not defined so we won't overwrite
1647 * the values we just set. */
1648 tp_g_hash_table_update (new_location, priv->location,
1649 (GBoxedCopyFunc) g_strdup, (GBoxedCopyFunc) tp_g_value_slice_dup);
1651 /* Don't change the accuracy as we used an address to get this position */
1652 g_hash_table_unref (priv->location);
1653 priv->location = new_location;
1654 g_object_notify ((GObject *) contact, "location");
1657 tp_clear_pointer (&resolved, g_hash_table_unref);
1658 g_object_unref (contact);
1662 update_geocode (EmpathyContact *contact)
1664 GeocodeForward *geocode;
1665 GHashTable *location;
1667 location = empathy_contact_get_location (contact);
1668 if (location == NULL ||
1669 g_hash_table_size (location) == 0)
1672 /* No need to search for position if contact published it */
1673 if (g_hash_table_lookup (location, EMPATHY_LOCATION_LAT) != NULL ||
1674 g_hash_table_lookup (location, EMPATHY_LOCATION_LON) != NULL)
1677 geocode = geocode_forward_new_for_params (location);
1678 if (geocode == NULL)
1681 geocode_forward_search_async (geocode, NULL, geocode_cb,
1682 g_object_ref (contact));
1684 g_object_unref (geocode);
1688 static EmpathyCapabilities
1689 tp_caps_to_capabilities (TpCapabilities *caps)
1691 EmpathyCapabilities capabilities = 0;
1693 if (tp_capabilities_supports_file_transfer (caps))
1694 capabilities |= EMPATHY_CAPABILITIES_FT;
1696 if (tp_capabilities_supports_stream_tubes (caps, TP_HANDLE_TYPE_CONTACT,
1698 capabilities |= EMPATHY_CAPABILITIES_RFB_STREAM_TUBE;
1700 if (tp_capabilities_supports_audio_video_call (caps, TP_HANDLE_TYPE_CONTACT))
1702 capabilities |= EMPATHY_CAPABILITIES_AUDIO;
1703 capabilities |= EMPATHY_CAPABILITIES_VIDEO;
1705 else if (tp_capabilities_supports_audio_call (caps, TP_HANDLE_TYPE_CONTACT))
1707 capabilities |= EMPATHY_CAPABILITIES_AUDIO;
1710 if (tp_capabilities_supports_sms (caps))
1711 capabilities |= EMPATHY_CAPABILITIES_SMS;
1713 return capabilities;
1717 set_capabilities_from_tp_caps (EmpathyContact *self,
1718 TpCapabilities *caps)
1720 EmpathyCapabilities capabilities;
1725 capabilities = tp_caps_to_capabilities (caps);
1726 empathy_contact_set_capabilities (self, capabilities);
1730 contact_set_avatar_from_tp_contact (EmpathyContact *contact)
1732 EmpathyContactPriv *priv = GET_PRIV (contact);
1736 mime = tp_contact_get_avatar_mime_type (priv->tp_contact);
1737 file = tp_contact_get_avatar_file (priv->tp_contact);
1741 EmpathyAvatar *avatar;
1745 GError *error = NULL;
1747 if (!g_file_load_contents (file, NULL, &data, &len, NULL, &error))
1749 DEBUG ("Failed to load avatar: %s", error->message);
1751 g_error_free (error);
1752 contact_set_avatar (contact, NULL);
1756 path = g_file_get_path (file);
1758 avatar = empathy_avatar_new ((guchar *) data, len, mime, path);
1760 contact_set_avatar (contact, avatar);
1761 empathy_avatar_unref (avatar);
1767 contact_set_avatar (contact, NULL);
1772 empathy_contact_dup_from_tp_contact (TpContact *tp_contact)
1774 EmpathyContact *contact = NULL;
1776 g_return_val_if_fail (TP_IS_CONTACT (tp_contact), NULL);
1778 if (contacts_table == NULL)
1779 contacts_table = g_hash_table_new (g_direct_hash, g_direct_equal);
1781 contact = g_hash_table_lookup (contacts_table, tp_contact);
1783 if (contact == NULL)
1785 contact = empathy_contact_new (tp_contact);
1787 /* The hash table does not keep any ref.
1788 * contact keeps a ref to tp_contact, and is removed from the table in
1789 * contact_dispose() */
1790 g_hash_table_insert (contacts_table, tp_contact, contact);
1794 g_object_ref (contact);
1801 presence_cmp_func (EmpathyContact *a,
1804 FolksPresenceDetails *presence_a, *presence_b;
1806 presence_a = FOLKS_PRESENCE_DETAILS (empathy_contact_get_persona (a));
1807 presence_b = FOLKS_PRESENCE_DETAILS (empathy_contact_get_persona (b));
1809 /* We negate the result because we're sorting in reverse order (i.e. such that
1810 * the Personas with the highest presence are at the beginning of the list. */
1811 return -folks_presence_details_typecmp (
1812 folks_presence_details_get_presence_type (presence_a),
1813 folks_presence_details_get_presence_type (presence_b));
1817 voip_cmp_func (EmpathyContact *a,
1820 gboolean has_audio_a, has_audio_b;
1821 gboolean has_video_a, has_video_b;
1823 has_audio_a = empathy_contact_can_voip_audio (a);
1824 has_audio_b = empathy_contact_can_voip_audio (b);
1825 has_video_a = empathy_contact_can_voip_video (a);
1826 has_video_b = empathy_contact_can_voip_video (b);
1828 /* First check video */
1829 if (has_video_a == has_video_b)
1831 /* Use audio to to break tie */
1832 if (has_audio_a == has_audio_b)
1834 else if (has_audio_a)
1839 else if (has_video_a)
1846 ft_cmp_func (EmpathyContact *a,
1849 gboolean can_send_files_a, can_send_files_b;
1851 can_send_files_a = empathy_contact_can_send_files (a);
1852 can_send_files_b = empathy_contact_can_send_files (b);
1854 if (can_send_files_a == can_send_files_b)
1856 else if (can_send_files_a)
1863 rfb_stream_tube_cmp_func (EmpathyContact *a,
1866 gboolean rfb_a, rfb_b;
1868 rfb_a = empathy_contact_can_use_rfb_stream_tube (a);
1869 rfb_b = empathy_contact_can_use_rfb_stream_tube (b);
1879 /* Sort by presence as with presence_cmp_func(), but if the two contacts have
1880 * the same presence, prefer the one which can do both audio *and* video calls,
1881 * over the one which can only do one of the two. */
1883 voip_sort_func (EmpathyContact *a, EmpathyContact *b)
1885 gint presence_sort = presence_cmp_func (a, b);
1887 if (presence_sort != 0)
1888 return presence_sort;
1890 return voip_cmp_func (a, b);
1893 /* Sort by presence as with presence_cmp_func() and then break ties using the
1894 * most "capable" individual. So users will be able to pick more actions on
1895 * the contact in the "Contact" menu of the chat window. */
1897 chat_sort_func (EmpathyContact *a,
1902 result = presence_cmp_func (a, b);
1906 /* Prefer individual supporting file transfer */
1907 result = ft_cmp_func (a, b);
1911 /* Check audio/video capabilities */
1912 result = voip_cmp_func (a, b);
1916 /* Check 'Share my destop' feature */
1917 return rfb_stream_tube_cmp_func (a, b);
1921 get_sort_func_for_action (EmpathyActionType action_type)
1923 switch (action_type)
1925 case EMPATHY_ACTION_AUDIO_CALL:
1926 case EMPATHY_ACTION_VIDEO_CALL:
1927 return (GCompareFunc) voip_sort_func;
1928 case EMPATHY_ACTION_CHAT:
1929 return (GCompareFunc) chat_sort_func;
1930 case EMPATHY_ACTION_VIEW_LOGS:
1931 case EMPATHY_ACTION_SEND_FILE:
1932 case EMPATHY_ACTION_SHARE_MY_DESKTOP:
1934 return (GCompareFunc) presence_cmp_func;
1939 * empathy_contact_dup_best_for_action:
1940 * @individual: a #FolksIndividual
1941 * @action_type: the type of action to be performed on the contact
1943 * Chooses a #FolksPersona from the given @individual which is best-suited for
1944 * the given @action_type. "Best-suited" is determined by choosing the persona
1945 * with the highest presence out of all the personas which can perform the given
1946 * @action_type (e.g. are capable of video calling).
1948 * Return value: an #EmpathyContact for the best persona, or %NULL;
1949 * unref with g_object_unref()
1952 empathy_contact_dup_best_for_action (FolksIndividual *individual,
1953 EmpathyActionType action_type)
1958 EmpathyContact *best_contact = NULL;
1960 /* Build a list of EmpathyContacts that we can sort */
1961 personas = folks_individual_get_personas (individual);
1964 iter = gee_iterable_iterator (GEE_ITERABLE (personas));
1965 while (gee_iterator_next (iter))
1967 FolksPersona *persona = gee_iterator_get (iter);
1968 TpContact *tp_contact;
1969 EmpathyContact *contact = NULL;
1971 if (!empathy_folks_persona_is_interesting (persona))
1974 tp_contact = tpf_persona_get_contact (TPF_PERSONA (persona));
1975 if (tp_contact == NULL)
1978 contact = empathy_contact_dup_from_tp_contact (tp_contact);
1979 empathy_contact_set_persona (contact, FOLKS_PERSONA (persona));
1981 /* Only choose the contact if they're actually capable of the specified
1983 if (empathy_contact_can_do_action (contact, action_type))
1984 contacts = g_list_prepend (contacts, g_object_ref (contact));
1987 g_clear_object (&contact);
1988 g_clear_object (&persona);
1990 g_clear_object (&iter);
1992 /* Sort the contacts by some heuristic based on the action type, then take
1993 * the top contact. */
1994 if (contacts != NULL)
1996 contacts = g_list_sort (contacts, get_sort_func_for_action (action_type));
1997 best_contact = g_object_ref (contacts->data);
2000 g_list_foreach (contacts, (GFunc) g_object_unref, NULL);
2001 g_list_free (contacts);
2003 return best_contact;
2006 #define declare_contact_cb(name) \
2008 contact_##name##_cb (GObject *source, \
2009 GAsyncResult *result, \
2010 gpointer user_data) \
2012 TpContact *contact = (TpContact *) source; \
2013 GError *error = NULL; \
2015 if (!tp_contact_##name##_finish (contact, result, &error)) \
2017 DEBUG ("Failed to ##name## on %s\n", \
2018 tp_contact_get_identifier (contact)); \
2019 g_error_free (error); \
2023 declare_contact_cb (request_subscription)
2024 declare_contact_cb (authorize_publication)
2025 declare_contact_cb (unblock)
2028 empathy_contact_add_to_contact_list (EmpathyContact *self,
2029 const gchar *message)
2031 EmpathyContactPriv *priv = GET_PRIV (self);
2033 g_return_if_fail (priv->tp_contact != NULL);
2035 tp_contact_request_subscription_async (priv->tp_contact, message,
2036 contact_request_subscription_cb, NULL);
2038 tp_contact_authorize_publication_async (priv->tp_contact,
2039 contact_authorize_publication_cb, NULL);
2041 tp_contact_unblock_async (priv->tp_contact, contact_unblock_cb, NULL);
2044 declare_contact_cb (remove)
2047 empathy_contact_remove_from_contact_list (EmpathyContact *self)
2049 EmpathyContactPriv *priv = GET_PRIV (self);
2051 g_return_if_fail (priv->tp_contact != NULL);
2053 tp_contact_remove_async (priv->tp_contact, contact_remove_cb, NULL);