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>
26 #include <glib/gi18n-lib.h>
28 #include <telepathy-glib/account-manager.h>
29 #include <telepathy-glib/interfaces.h>
30 #include <telepathy-glib/util.h>
32 #include <telepathy-logger/log-manager.h>
34 #include <folks/folks.h>
35 #include <folks/folks-telepathy.h>
38 #include <geocode-glib/geocode-glib.h>
41 #include "empathy-contact.h"
42 #include "empathy-camera-monitor.h"
43 #include "empathy-individual-manager.h"
44 #include "empathy-utils.h"
45 #include "empathy-enum-types.h"
46 #include "empathy-location.h"
48 #define DEBUG_FLAG EMPATHY_DEBUG_CONTACT
49 #include "empathy-debug.h"
51 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyContact)
53 TpContact *tp_contact;
55 FolksPersona *persona;
59 EmpathyAvatar *avatar;
60 TpConnectionPresenceType presence;
62 EmpathyCapabilities capabilities;
65 /* Location is composed of string keys and GValues.
66 * Example: a "city" key would have "Helsinki" as string GValue,
67 * a "latitude" would have 65.0 as double GValue.
69 * This is a super set of the location stored in TpContact as we can try add
70 * more fields by searching the address using geoclue.
77 static void contact_finalize (GObject *object);
78 static void contact_get_property (GObject *object, guint param_id,
79 GValue *value, GParamSpec *pspec);
80 static void contact_set_property (GObject *object, guint param_id,
81 const GValue *value, GParamSpec *pspec);
84 static void update_geocode (EmpathyContact *contact);
87 static void empathy_contact_set_location (EmpathyContact *contact,
88 GHashTable *location);
90 static void contact_set_client_types (EmpathyContact *contact,
91 const gchar * const *types);
93 static void set_capabilities_from_tp_caps (EmpathyContact *self,
94 TpCapabilities *caps);
96 static void contact_set_avatar (EmpathyContact *contact,
97 EmpathyAvatar *avatar);
98 static void contact_set_avatar_from_tp_contact (EmpathyContact *contact);
99 static gboolean contact_load_avatar_cache (EmpathyContact *contact,
102 G_DEFINE_TYPE (EmpathyContact, empathy_contact, G_TYPE_OBJECT);
115 PROP_PRESENCE_MESSAGE,
128 static guint signals[LAST_SIGNAL];
130 /* TpContact* -> EmpathyContact*, both borrowed ref */
131 static GHashTable *contacts_table = NULL;
134 tp_contact_notify_cb (TpContact *tp_contact,
138 EmpathyContactPriv *priv = GET_PRIV (contact);
140 /* Forward property notifications */
141 if (!tp_strdiff (param->name, "alias"))
142 g_object_notify (contact, "alias");
143 else if (!tp_strdiff (param->name, "presence-type")) {
144 TpConnectionPresenceType presence;
146 presence = empathy_contact_get_presence (EMPATHY_CONTACT (contact));
147 g_signal_emit (contact, signals[PRESENCE_CHANGED], 0, presence,
149 priv->presence = presence;
150 g_object_notify (contact, "presence");
152 else if (!tp_strdiff (param->name, "identifier"))
153 g_object_notify (contact, "id");
154 else if (!tp_strdiff (param->name, "handle"))
155 g_object_notify (contact, "handle");
156 else if (!tp_strdiff (param->name, "location"))
158 GHashTable *location;
160 location = tp_contact_get_location (tp_contact);
161 /* This will start a geoclue search to find the address if needed */
162 empathy_contact_set_location (EMPATHY_CONTACT (contact), location);
164 else if (!tp_strdiff (param->name, "capabilities"))
166 set_capabilities_from_tp_caps (EMPATHY_CONTACT (contact),
167 tp_contact_get_capabilities (tp_contact));
169 else if (!tp_strdiff (param->name, "avatar-file"))
171 contact_set_avatar_from_tp_contact (EMPATHY_CONTACT (contact));
173 else if (!tp_strdiff (param->name, "client-types"))
175 contact_set_client_types (EMPATHY_CONTACT (contact),
176 tp_contact_get_client_types (tp_contact));
181 folks_persona_notify_cb (FolksPersona *folks_persona,
185 if (!tp_strdiff (param->name, "presence-message"))
186 g_object_notify (contact, "presence-message");
190 contact_dispose (GObject *object)
192 EmpathyContactPriv *priv = GET_PRIV (object);
194 if (priv->tp_contact != NULL)
196 g_signal_handlers_disconnect_by_func (priv->tp_contact,
197 tp_contact_notify_cb, object);
199 tp_clear_object (&priv->tp_contact);
202 g_object_unref (priv->account);
203 priv->account = NULL;
207 g_signal_handlers_disconnect_by_func (priv->persona,
208 folks_persona_notify_cb, object);
209 g_object_unref (priv->persona);
211 priv->persona = NULL;
213 if (priv->avatar != NULL)
215 empathy_avatar_unref (priv->avatar);
219 if (priv->location != NULL)
221 g_hash_table_unref (priv->location);
222 priv->location = NULL;
225 G_OBJECT_CLASS (empathy_contact_parent_class)->dispose (object);
229 contact_constructed (GObject *object)
231 EmpathyContact *contact = (EmpathyContact *) object;
232 EmpathyContactPriv *priv = GET_PRIV (contact);
233 GHashTable *location;
234 TpHandle self_handle;
236 const gchar * const *client_types;
238 if (priv->tp_contact == NULL)
241 priv->presence = empathy_contact_get_presence (contact);
243 location = tp_contact_get_location (priv->tp_contact);
244 if (location != NULL)
245 empathy_contact_set_location (contact, location);
247 client_types = tp_contact_get_client_types (priv->tp_contact);
248 if (client_types != NULL)
249 contact_set_client_types (contact, client_types);
251 set_capabilities_from_tp_caps (contact,
252 tp_contact_get_capabilities (priv->tp_contact));
254 contact_set_avatar_from_tp_contact (contact);
256 /* Set is-user property. Note that it could still be the handle is
257 * different from the connection's self handle, in the case the handle
258 * comes from a group interface. */
259 self_handle = tp_connection_get_self_handle (
260 tp_contact_get_connection (priv->tp_contact));
261 handle = tp_contact_get_handle (priv->tp_contact);
262 empathy_contact_set_is_user (contact, self_handle == handle);
264 g_signal_connect (priv->tp_contact, "notify",
265 G_CALLBACK (tp_contact_notify_cb), contact);
269 empathy_contact_class_init (EmpathyContactClass *class)
271 GObjectClass *object_class;
273 object_class = G_OBJECT_CLASS (class);
275 object_class->finalize = contact_finalize;
276 object_class->dispose = contact_dispose;
277 object_class->get_property = contact_get_property;
278 object_class->set_property = contact_set_property;
279 object_class->constructed = contact_constructed;
281 g_object_class_install_property (object_class,
283 g_param_spec_object ("tp-contact",
285 "The TpContact associated with the contact",
287 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
289 g_object_class_install_property (object_class,
291 g_param_spec_object ("account",
293 "The account associated with the contact",
295 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
297 g_object_class_install_property (object_class,
299 g_param_spec_object ("persona",
301 "The FolksPersona associated with the contact",
303 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
305 g_object_class_install_property (object_class,
307 g_param_spec_string ("id",
309 "String identifying contact",
311 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
313 g_object_class_install_property (object_class,
315 g_param_spec_string ("alias",
317 "An alias for the contact",
319 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
321 g_object_class_install_property (object_class,
323 g_param_spec_string ("logged-alias",
325 "The alias the user had when a message was logged, "
326 "only set when using empathy_contact_from_tpl_contact()",
328 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
330 g_object_class_install_property (object_class,
332 g_param_spec_boxed ("avatar",
336 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
338 g_object_class_install_property (object_class,
340 g_param_spec_uint ("presence",
342 "Presence of contact",
343 TP_CONNECTION_PRESENCE_TYPE_UNSET,
344 NUM_TP_CONNECTION_PRESENCE_TYPES,
345 TP_CONNECTION_PRESENCE_TYPE_UNSET,
346 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
348 g_object_class_install_property (object_class,
349 PROP_PRESENCE_MESSAGE,
350 g_param_spec_string ("presence-message",
351 "Contact presence message",
352 "Presence message of contact",
354 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
356 g_object_class_install_property (object_class,
358 g_param_spec_uint ("handle",
360 "The handle of the contact",
364 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
366 g_object_class_install_property (object_class,
368 g_param_spec_flags ("capabilities",
369 "Contact Capabilities",
370 "Capabilities of the contact",
371 EMPATHY_TYPE_CAPABILITIES,
372 EMPATHY_CAPABILITIES_UNKNOWN,
373 G_PARAM_CONSTRUCT | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
375 g_object_class_install_property (object_class,
377 g_param_spec_boolean ("is-user",
379 "Is contact the user",
381 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
384 g_object_class_install_property (object_class,
386 g_param_spec_boxed ("location",
388 "Physical location of the contact",
390 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
392 g_object_class_install_property (object_class,
394 g_param_spec_boxed ("client-types",
395 "Contact client types",
396 "Client types of the contact",
398 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
400 signals[PRESENCE_CHANGED] =
401 g_signal_new ("presence-changed",
402 G_TYPE_FROM_CLASS (class),
406 g_cclosure_marshal_generic,
411 g_type_class_add_private (object_class, sizeof (EmpathyContactPriv));
415 empathy_contact_init (EmpathyContact *contact)
417 EmpathyContactPriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (contact,
418 EMPATHY_TYPE_CONTACT, EmpathyContactPriv);
420 contact->priv = priv;
422 priv->location = NULL;
423 priv->client_types = NULL;
428 contact_finalize (GObject *object)
430 EmpathyContactPriv *priv;
432 priv = GET_PRIV (object);
434 DEBUG ("finalize: %p", object);
436 g_clear_object (&priv->groups);
437 g_free (priv->alias);
439 g_strfreev (priv->client_types);
441 G_OBJECT_CLASS (empathy_contact_parent_class)->finalize (object);
445 empathy_contact_set_capabilities (EmpathyContact *contact,
446 EmpathyCapabilities capabilities)
448 EmpathyContactPriv *priv;
450 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
452 priv = GET_PRIV (contact);
454 if (priv->capabilities == capabilities)
457 priv->capabilities = capabilities;
459 g_object_notify (G_OBJECT (contact), "capabilities");
463 empathy_contact_set_id (EmpathyContact *contact,
466 EmpathyContactPriv *priv;
468 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
469 g_return_if_fail (id != NULL);
471 priv = GET_PRIV (contact);
473 /* We temporally ref the contact because it could be destroyed
474 * during the signal emition */
475 g_object_ref (contact);
476 if (tp_strdiff (id, priv->id))
479 priv->id = g_strdup (id);
481 g_object_notify (G_OBJECT (contact), "id");
482 if (EMP_STR_EMPTY (priv->alias))
483 g_object_notify (G_OBJECT (contact), "alias");
486 g_object_unref (contact);
490 empathy_contact_set_presence (EmpathyContact *contact,
491 TpConnectionPresenceType presence)
493 EmpathyContactPriv *priv;
494 TpConnectionPresenceType old_presence;
496 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
498 priv = GET_PRIV (contact);
500 if (presence == priv->presence)
503 old_presence = priv->presence;
504 priv->presence = presence;
506 g_signal_emit (contact, signals[PRESENCE_CHANGED], 0, presence, old_presence);
508 g_object_notify (G_OBJECT (contact), "presence");
512 empathy_contact_set_presence_message (EmpathyContact *contact,
513 const gchar *message)
515 EmpathyContactPriv *priv = GET_PRIV (contact);
517 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
519 if (priv->persona != NULL)
521 folks_presence_details_set_presence_message (
522 FOLKS_PRESENCE_DETAILS (priv->persona), message);
527 empathy_contact_set_handle (EmpathyContact *contact,
530 EmpathyContactPriv *priv;
532 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
534 priv = GET_PRIV (contact);
536 g_object_ref (contact);
537 if (handle != priv->handle)
539 priv->handle = handle;
540 g_object_notify (G_OBJECT (contact), "handle");
542 g_object_unref (contact);
546 contact_get_property (GObject *object,
551 EmpathyContact *contact = EMPATHY_CONTACT (object);
555 case PROP_TP_CONTACT:
556 g_value_set_object (value, empathy_contact_get_tp_contact (contact));
559 g_value_set_object (value, empathy_contact_get_account (contact));
562 g_value_set_object (value, empathy_contact_get_persona (contact));
565 g_value_set_string (value, empathy_contact_get_id (contact));
568 g_value_set_string (value, empathy_contact_get_alias (contact));
570 case PROP_LOGGED_ALIAS:
571 g_value_set_string (value, empathy_contact_get_logged_alias (contact));
574 g_value_set_boxed (value, empathy_contact_get_avatar (contact));
577 g_value_set_uint (value, empathy_contact_get_presence (contact));
579 case PROP_PRESENCE_MESSAGE:
580 g_value_set_string (value, empathy_contact_get_presence_message (contact));
583 g_value_set_uint (value, empathy_contact_get_handle (contact));
585 case PROP_CAPABILITIES:
586 g_value_set_flags (value, empathy_contact_get_capabilities (contact));
589 g_value_set_boolean (value, empathy_contact_is_user (contact));
592 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
598 contact_set_property (GObject *object,
603 EmpathyContact *contact = EMPATHY_CONTACT (object);
604 EmpathyContactPriv *priv = GET_PRIV (object);
608 case PROP_TP_CONTACT:
609 priv->tp_contact = g_value_dup_object (value);
612 g_assert (priv->account == NULL);
613 priv->account = g_value_dup_object (value);
616 empathy_contact_set_persona (contact, g_value_get_object (value));
619 empathy_contact_set_id (contact, g_value_get_string (value));
622 empathy_contact_set_alias (contact, g_value_get_string (value));
624 case PROP_LOGGED_ALIAS:
625 g_assert (priv->logged_alias == NULL);
626 priv->logged_alias = g_value_dup_string (value);
629 empathy_contact_set_presence (contact, g_value_get_uint (value));
631 case PROP_PRESENCE_MESSAGE:
632 empathy_contact_set_presence_message (contact, g_value_get_string (value));
635 empathy_contact_set_handle (contact, g_value_get_uint (value));
637 case PROP_CAPABILITIES:
638 empathy_contact_set_capabilities (contact, g_value_get_flags (value));
641 empathy_contact_set_is_user (contact, g_value_get_boolean (value));
644 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
650 remove_tp_contact (gpointer data,
653 g_hash_table_remove (contacts_table, data);
656 static EmpathyContact *
657 empathy_contact_new (TpContact *tp_contact)
659 EmpathyContact *retval;
661 g_return_val_if_fail (TP_IS_CONTACT (tp_contact), NULL);
663 retval = g_object_new (EMPATHY_TYPE_CONTACT,
664 "tp-contact", tp_contact,
667 g_object_weak_ref (G_OBJECT (retval), remove_tp_contact, tp_contact);
679 contact_is_tpl_entity (gpointer key,
683 EmpathyContact *contact = value;
684 FindContactData *data = user_data;
685 TpAccount *account = empathy_contact_get_account (contact);
686 const gchar *path = NULL;
689 path = tp_proxy_get_object_path (account);
691 return !tp_strdiff (empathy_contact_get_id (contact),
692 tpl_entity_get_identifier (data->entity)) &&
693 !tp_strdiff (tp_proxy_get_object_path (data->account), path);
697 get_contacts_cb (TpConnection *connection,
699 TpContact * const *contacts,
700 const gchar * const *requested_ids,
701 GHashTable *failed_id_errors,
704 GObject *weak_object)
706 EmpathyContact *self = (EmpathyContact *) weak_object;
707 EmpathyContactPriv *priv = GET_PRIV (self);
708 TpContact *tp_contact;
713 tp_contact = contacts[0];
715 g_return_if_fail (priv->tp_contact == NULL);
716 priv->tp_contact = g_object_ref (tp_contact);
717 g_object_notify (G_OBJECT (self), "tp-contact");
719 /* Update capabilities now that we have a TpContact */
720 set_capabilities_from_tp_caps (self,
721 tp_contact_get_capabilities (tp_contact));
725 empathy_contact_from_tpl_contact (TpAccount *account,
726 TplEntity *tpl_entity)
728 EmpathyContact *retval;
730 EmpathyContact *existing_contact = NULL;
732 g_return_val_if_fail (TPL_IS_ENTITY (tpl_entity), NULL);
734 if (contacts_table != NULL)
736 FindContactData data;
738 data.entity = tpl_entity;
739 data.account = account;
741 existing_contact = g_hash_table_find (contacts_table,
742 contact_is_tpl_entity, &data);
745 if (existing_contact != NULL)
747 retval = g_object_new (EMPATHY_TYPE_CONTACT,
748 "tp-contact", empathy_contact_get_tp_contact (existing_contact),
749 "logged-alias", tpl_entity_get_alias (tpl_entity),
757 is_user = (TPL_ENTITY_SELF == tpl_entity_get_entity_type (tpl_entity));
759 id = tpl_entity_get_identifier (tpl_entity);
761 retval = g_object_new (EMPATHY_TYPE_CONTACT,
763 "alias", tpl_entity_get_alias (tpl_entity),
768 /* Try to get a TpContact associated to have at least contact
769 * capabilities if possible. This is useful for CM supporting calling
770 * offline contacts for example. */
771 conn = tp_account_get_connection (account);
774 TpContactFeature features[] = { TP_CONTACT_FEATURE_CAPABILITIES };
775 conn = tp_account_get_connection (account);
777 tp_connection_get_contacts_by_id (conn, 1, &id,
778 G_N_ELEMENTS (features), features, get_contacts_cb,
779 NULL, NULL, G_OBJECT (retval));
783 if (!EMP_STR_EMPTY (tpl_entity_get_avatar_token (tpl_entity)))
784 contact_load_avatar_cache (retval,
785 tpl_entity_get_avatar_token (tpl_entity));
791 empathy_contact_get_tp_contact (EmpathyContact *contact)
793 EmpathyContactPriv *priv;
795 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
797 priv = GET_PRIV (contact);
799 return priv->tp_contact;
803 empathy_contact_get_id (EmpathyContact *contact)
805 EmpathyContactPriv *priv;
807 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
809 priv = GET_PRIV (contact);
811 if (priv->tp_contact != NULL)
812 return tp_contact_get_identifier (priv->tp_contact);
818 empathy_contact_get_alias (EmpathyContact *contact)
820 EmpathyContactPriv *priv;
821 const gchar *alias = NULL;
823 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
825 priv = GET_PRIV (contact);
827 if (!EMP_STR_EMPTY (priv->alias))
829 else if (priv->tp_contact != NULL)
830 alias = tp_contact_get_alias (priv->tp_contact);
832 if (!EMP_STR_EMPTY (alias))
835 return empathy_contact_get_id (contact);
839 empathy_contact_get_logged_alias (EmpathyContact *contact)
841 EmpathyContactPriv *priv;
843 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
845 priv = GET_PRIV (contact);
847 if (priv->logged_alias != NULL)
848 return priv->logged_alias;
850 return empathy_contact_get_alias (contact);
854 empathy_contact_set_alias (EmpathyContact *contact,
857 EmpathyContactPriv *priv;
858 FolksPersona *persona;
860 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
862 priv = GET_PRIV (contact);
864 g_object_ref (contact);
866 /* Set the alias on the persona if possible */
867 persona = empathy_contact_get_persona (contact);
868 if (persona != NULL && FOLKS_IS_ALIAS_DETAILS (persona))
870 DEBUG ("Setting alias for contact %s to %s",
871 empathy_contact_get_id (contact), alias);
873 folks_alias_details_set_alias (FOLKS_ALIAS_DETAILS (persona), alias);
876 if (tp_strdiff (alias, priv->alias))
878 g_free (priv->alias);
879 priv->alias = g_strdup (alias);
880 g_object_notify (G_OBJECT (contact), "alias");
883 g_object_unref (contact);
887 groups_change_group_cb (GObject *source,
888 GAsyncResult *result,
891 FolksGroupDetails *group_details = FOLKS_GROUP_DETAILS (source);
892 GError *error = NULL;
894 folks_group_details_change_group_finish (group_details, result, &error);
897 g_warning ("failed to change group: %s", error->message);
898 g_clear_error (&error);
903 empathy_contact_change_group (EmpathyContact *contact, const gchar *group,
906 EmpathyContactPriv *priv;
907 FolksPersona *persona;
909 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
910 g_return_if_fail (group != NULL);
912 priv = GET_PRIV (contact);
914 /* Normally pass through the changes to the persona */
915 persona = empathy_contact_get_persona (contact);
918 if (FOLKS_IS_GROUP_DETAILS (persona))
919 folks_group_details_change_group (FOLKS_GROUP_DETAILS (persona), group,
920 is_member, groups_change_group_cb, contact);
924 /* If the persona doesn't exist yet, we have to cache the changes until it
926 if (priv->groups == NULL)
928 priv->groups = gee_hash_set_new (G_TYPE_STRING, (GBoxedCopyFunc) g_strdup,
929 g_free, g_str_hash, g_str_equal);
932 gee_collection_add (GEE_COLLECTION (priv->groups), group);
936 empathy_contact_get_avatar (EmpathyContact *contact)
938 EmpathyContactPriv *priv;
940 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
942 priv = GET_PRIV (contact);
948 contact_set_avatar (EmpathyContact *contact,
949 EmpathyAvatar *avatar)
951 EmpathyContactPriv *priv;
953 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
955 priv = GET_PRIV (contact);
957 if (priv->avatar == avatar)
962 empathy_avatar_unref (priv->avatar);
967 priv->avatar = empathy_avatar_ref (avatar);
969 g_object_notify (G_OBJECT (contact), "avatar");
973 empathy_contact_get_account (EmpathyContact *contact)
975 EmpathyContactPriv *priv;
977 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
979 priv = GET_PRIV (contact);
981 if (priv->account == NULL && priv->tp_contact != NULL)
983 TpConnection *connection;
985 /* FIXME: This assume the account manager already exists */
986 connection = tp_contact_get_connection (priv->tp_contact);
988 g_object_ref (tp_connection_get_account (connection));
991 return priv->account;
995 empathy_contact_get_persona (EmpathyContact *contact)
997 EmpathyContactPriv *priv;
999 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
1001 priv = GET_PRIV (contact);
1003 if (priv->persona == NULL && priv->tp_contact != NULL)
1005 TpfPersona *persona;
1007 persona = tpf_persona_dup_for_contact (priv->tp_contact);
1008 if (persona != NULL)
1010 empathy_contact_set_persona (contact, (FolksPersona *) persona);
1011 g_object_unref (persona);
1015 return priv->persona;
1019 empathy_contact_set_persona (EmpathyContact *contact,
1020 FolksPersona *persona)
1022 EmpathyContactPriv *priv;
1024 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
1025 g_return_if_fail (TPF_IS_PERSONA (persona));
1027 priv = GET_PRIV (contact);
1029 if (persona == priv->persona)
1032 if (priv->persona != NULL)
1034 g_signal_handlers_disconnect_by_func (priv->persona,
1035 folks_persona_notify_cb, contact);
1036 g_object_unref (priv->persona);
1038 priv->persona = g_object_ref (persona);
1040 g_signal_connect (priv->persona, "notify",
1041 G_CALLBACK (folks_persona_notify_cb), contact);
1043 g_object_notify (G_OBJECT (contact), "persona");
1045 /* Set the persona's alias, since ours could've been set using
1046 * empathy_contact_set_alias() before we had a persona; this happens when
1047 * adding a contact. */
1048 if (priv->alias != NULL)
1049 empathy_contact_set_alias (contact, priv->alias);
1051 /* Set the persona's groups */
1052 if (priv->groups != NULL)
1054 folks_group_details_set_groups (FOLKS_GROUP_DETAILS (persona),
1055 GEE_SET (priv->groups));
1056 g_object_unref (priv->groups);
1057 priv->groups = NULL;
1062 empathy_contact_get_connection (EmpathyContact *contact)
1064 EmpathyContactPriv *priv;
1066 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
1068 priv = GET_PRIV (contact);
1070 if (priv->tp_contact != NULL)
1071 return tp_contact_get_connection (priv->tp_contact);
1076 TpConnectionPresenceType
1077 empathy_contact_get_presence (EmpathyContact *contact)
1079 EmpathyContactPriv *priv;
1081 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact),
1082 TP_CONNECTION_PRESENCE_TYPE_UNSET);
1084 priv = GET_PRIV (contact);
1086 if (priv->tp_contact != NULL)
1087 return tp_contact_get_presence_type (priv->tp_contact);
1089 return priv->presence;
1093 empathy_contact_get_presence_message (EmpathyContact *contact)
1095 EmpathyContactPriv *priv;
1097 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
1099 priv = GET_PRIV (contact);
1101 if (priv->persona != NULL)
1102 return folks_presence_details_get_presence_message (
1103 FOLKS_PRESENCE_DETAILS (priv->persona));
1105 if (priv->tp_contact != NULL)
1106 return tp_contact_get_presence_message (priv->tp_contact);
1112 empathy_contact_get_handle (EmpathyContact *contact)
1114 EmpathyContactPriv *priv;
1116 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
1118 priv = GET_PRIV (contact);
1120 if (priv->tp_contact != NULL)
1121 return tp_contact_get_handle (priv->tp_contact);
1123 return priv->handle;
1127 empathy_contact_get_capabilities (EmpathyContact *contact)
1129 EmpathyContactPriv *priv;
1131 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), 0);
1133 priv = GET_PRIV (contact);
1135 return priv->capabilities;
1139 empathy_contact_is_user (EmpathyContact *contact)
1141 EmpathyContactPriv *priv;
1143 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1145 priv = GET_PRIV (contact);
1147 return priv->is_user;
1151 empathy_contact_set_is_user (EmpathyContact *contact,
1154 EmpathyContactPriv *priv;
1156 g_return_if_fail (EMPATHY_IS_CONTACT (contact));
1158 priv = GET_PRIV (contact);
1160 if (priv->is_user == is_user)
1163 priv->is_user = is_user;
1165 g_object_notify (G_OBJECT (contact), "is-user");
1169 empathy_contact_is_online (EmpathyContact *contact)
1171 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1173 switch (empathy_contact_get_presence (contact))
1175 case TP_CONNECTION_PRESENCE_TYPE_OFFLINE:
1176 case TP_CONNECTION_PRESENCE_TYPE_UNKNOWN:
1177 case TP_CONNECTION_PRESENCE_TYPE_ERROR:
1179 /* Contacts without presence are considered online so we can display IRC
1180 * contacts in rooms. */
1181 case TP_CONNECTION_PRESENCE_TYPE_UNSET:
1182 case TP_CONNECTION_PRESENCE_TYPE_AVAILABLE:
1183 case TP_CONNECTION_PRESENCE_TYPE_AWAY:
1184 case TP_CONNECTION_PRESENCE_TYPE_EXTENDED_AWAY:
1185 case TP_CONNECTION_PRESENCE_TYPE_HIDDEN:
1186 case TP_CONNECTION_PRESENCE_TYPE_BUSY:
1193 empathy_contact_get_status (EmpathyContact *contact)
1195 const gchar *message;
1197 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), "");
1199 message = empathy_contact_get_presence_message (contact);
1200 if (!EMP_STR_EMPTY (message))
1203 return empathy_presence_get_default_message (
1204 empathy_contact_get_presence (contact));
1208 empathy_contact_can_sms (EmpathyContact *contact)
1210 EmpathyContactPriv *priv;
1212 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1214 priv = GET_PRIV (contact);
1216 return priv->capabilities & EMPATHY_CAPABILITIES_SMS;
1220 empathy_contact_can_voip (EmpathyContact *contact)
1222 EmpathyContactPriv *priv;
1224 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1226 priv = GET_PRIV (contact);
1228 return priv->capabilities & (EMPATHY_CAPABILITIES_AUDIO |
1229 EMPATHY_CAPABILITIES_VIDEO);
1233 empathy_contact_can_voip_audio (EmpathyContact *contact)
1235 EmpathyContactPriv *priv;
1237 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1239 priv = GET_PRIV (contact);
1241 return priv->capabilities & EMPATHY_CAPABILITIES_AUDIO;
1245 empathy_contact_can_voip_video (EmpathyContact *contact)
1247 EmpathyContactPriv *priv;
1249 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1251 priv = GET_PRIV (contact);
1253 return priv->capabilities & EMPATHY_CAPABILITIES_VIDEO;
1257 empathy_contact_can_send_files (EmpathyContact *contact)
1259 EmpathyContactPriv *priv;
1261 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1263 priv = GET_PRIV (contact);
1265 return priv->capabilities & EMPATHY_CAPABILITIES_FT;
1269 empathy_contact_can_use_rfb_stream_tube (EmpathyContact *contact)
1271 EmpathyContactPriv *priv;
1273 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1275 priv = GET_PRIV (contact);
1277 return priv->capabilities & EMPATHY_CAPABILITIES_RFB_STREAM_TUBE;
1281 contact_has_log (EmpathyContact *contact)
1283 TplLogManager *manager;
1287 manager = tpl_log_manager_dup_singleton ();
1288 entity = tpl_entity_new (empathy_contact_get_id (contact),
1289 TPL_ENTITY_CONTACT, NULL, NULL);
1291 have_log = tpl_log_manager_exists (manager,
1292 empathy_contact_get_account (contact), entity, TPL_EVENT_MASK_TEXT);
1294 g_object_unref (entity);
1295 g_object_unref (manager);
1301 empathy_contact_can_do_action (EmpathyContact *self,
1302 EmpathyActionType action_type)
1304 gboolean sensitivity = FALSE;
1306 switch (action_type)
1308 case EMPATHY_ACTION_CHAT:
1311 case EMPATHY_ACTION_SMS:
1312 sensitivity = empathy_contact_can_sms (self);
1314 case EMPATHY_ACTION_AUDIO_CALL:
1315 sensitivity = empathy_contact_can_voip_audio (self);
1317 case EMPATHY_ACTION_VIDEO_CALL:
1318 sensitivity = empathy_contact_can_voip_video (self);
1320 case EMPATHY_ACTION_VIEW_LOGS:
1321 sensitivity = contact_has_log (self);
1323 case EMPATHY_ACTION_SEND_FILE:
1324 sensitivity = empathy_contact_can_send_files (self);
1326 case EMPATHY_ACTION_SHARE_MY_DESKTOP:
1327 sensitivity = empathy_contact_can_use_rfb_stream_tube (self);
1330 g_assert_not_reached ();
1333 return (sensitivity ? TRUE : FALSE);
1337 contact_get_avatar_filename (EmpathyContact *contact,
1343 gchar *token_escaped;
1345 if (EMP_STR_EMPTY (empathy_contact_get_id (contact)))
1348 token_escaped = tp_escape_as_identifier (token);
1349 account = empathy_contact_get_account (contact);
1351 avatar_path = g_build_filename (g_get_user_cache_dir (),
1354 tp_account_get_connection_manager (account),
1355 tp_account_get_protocol (account),
1357 g_mkdir_with_parents (avatar_path, 0700);
1359 avatar_file = g_build_filename (avatar_path, token_escaped, NULL);
1361 g_free (token_escaped);
1362 g_free (avatar_path);
1368 contact_load_avatar_cache (EmpathyContact *contact,
1371 EmpathyAvatar *avatar = NULL;
1375 GError *error = NULL;
1377 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), FALSE);
1378 g_return_val_if_fail (!EMP_STR_EMPTY (token), FALSE);
1380 /* Load the avatar from file if it exists */
1381 filename = contact_get_avatar_filename (contact, token);
1382 if (filename && g_file_test (filename, G_FILE_TEST_EXISTS))
1384 if (!g_file_get_contents (filename, &data, &len, &error))
1386 DEBUG ("Failed to load avatar from cache: %s",
1387 error ? error->message : "No error given");
1388 g_clear_error (&error);
1394 DEBUG ("Avatar loaded from %s", filename);
1395 avatar = empathy_avatar_new ((guchar *) data, len, NULL, filename);
1396 contact_set_avatar (contact, avatar);
1397 empathy_avatar_unref (avatar);
1403 return data != NULL;
1407 empathy_avatar_get_type (void)
1409 static GType type_id = 0;
1413 type_id = g_boxed_type_register_static ("EmpathyAvatar",
1414 (GBoxedCopyFunc) empathy_avatar_ref,
1415 (GBoxedFreeFunc) empathy_avatar_unref);
1422 * empathy_avatar_new:
1423 * @data: the avatar data
1424 * @len: the size of avatar data
1425 * @format: the mime type of the avatar image
1426 * @filename: the filename where the avatar is stored in cache
1428 * Create a #EmpathyAvatar from the provided data.
1430 * Returns: a new #EmpathyAvatar
1433 empathy_avatar_new (const guchar *data,
1435 const gchar *format,
1436 const gchar *filename)
1438 EmpathyAvatar *avatar;
1440 avatar = g_slice_new0 (EmpathyAvatar);
1441 avatar->data = g_memdup (data, len);
1443 avatar->format = g_strdup (format);
1444 avatar->filename = g_strdup (filename);
1445 avatar->refcount = 1;
1451 empathy_avatar_unref (EmpathyAvatar *avatar)
1453 g_return_if_fail (avatar != NULL);
1456 if (avatar->refcount == 0)
1458 g_free (avatar->data);
1459 g_free (avatar->format);
1460 g_free (avatar->filename);
1461 g_slice_free (EmpathyAvatar, avatar);
1466 empathy_avatar_ref (EmpathyAvatar *avatar)
1468 g_return_val_if_fail (avatar != NULL, NULL);
1476 * empathy_avatar_save_to_file:
1477 * @avatar: the avatar
1478 * @filename: name of a file to write avatar to
1479 * @error: return location for a GError, or NULL
1481 * Save the avatar to a file named filename
1483 * Returns: %TRUE on success, %FALSE if an error occurred
1486 empathy_avatar_save_to_file (EmpathyAvatar *self,
1487 const gchar *filename,
1490 return g_file_set_contents (filename, (const gchar *) self->data, self->len,
1495 * empathy_contact_get_location:
1496 * @contact: an #EmpathyContact
1498 * Returns the user's location if available. The keys are defined in
1499 * empathy-location.h. If the contact doesn't have location
1500 * information, the GHashTable will be empthy. Use #g_hash_table_unref when
1501 * you are done with the #GHashTable.
1503 * It is composed of string keys and GValues. Keys are
1504 * defined in empathy-location.h such as #EMPATHY_LOCATION_COUNTRY.
1505 * Example: a "city" key would have "Helsinki" as string GValue,
1506 * a "latitude" would have 65.0 as double GValue.
1508 * Returns: a #GHashTable of location values
1511 empathy_contact_get_location (EmpathyContact *contact)
1513 EmpathyContactPriv *priv;
1515 g_return_val_if_fail (EMPATHY_CONTACT (contact), NULL);
1517 priv = GET_PRIV (contact);
1519 return priv->location;
1523 * empathy_contact_set_location:
1524 * @contact: an #EmpathyContact
1525 * @location: a #GHashTable of the location
1527 * Sets the user's location based on the location #GHashTable passed.
1528 * It is composed of string keys and GValues. Keys are
1529 * defined in empathy-location.h such as #EMPATHY_LOCATION_COUNTRY.
1530 * Example: a "city" key would have "Helsinki" as string GValue,
1531 * a "latitude" would have 65.0 as double GValue.
1534 empathy_contact_set_location (EmpathyContact *contact,
1535 GHashTable *location)
1537 EmpathyContactPriv *priv;
1539 g_return_if_fail (EMPATHY_CONTACT (contact));
1540 g_return_if_fail (location != NULL);
1542 priv = GET_PRIV (contact);
1544 if (priv->location != NULL)
1545 g_hash_table_unref (priv->location);
1547 priv->location = g_hash_table_ref (location);
1549 update_geocode (contact);
1551 g_object_notify (G_OBJECT (contact), "location");
1554 const gchar * const *
1555 empathy_contact_get_client_types (EmpathyContact *contact)
1557 EmpathyContactPriv *priv;
1559 g_return_val_if_fail (EMPATHY_IS_CONTACT (contact), NULL);
1561 priv = GET_PRIV (contact);
1563 return (const gchar * const *) priv->client_types;
1567 contact_set_client_types (EmpathyContact *contact,
1568 const gchar * const *client_types)
1570 EmpathyContactPriv *priv = GET_PRIV (contact);
1572 if (priv->client_types != NULL)
1573 g_strfreev (priv->client_types);
1575 priv->client_types = g_strdupv ((gchar **) client_types);
1576 g_object_notify (G_OBJECT (contact), "client-types");
1580 * empathy_contact_equal:
1581 * @contact1: an #EmpathyContact
1582 * @contact2: an #EmpathyContact
1584 * Returns FALSE if one of the contacts is NULL but the other is not.
1585 * Otherwise returns TRUE if both pointer are equal or if they bith
1586 * refer to the same id.
1587 * It's only necessary to call this function if your contact objects
1588 * come from logs where contacts are created dynamically and comparing
1589 * pointers is not enough.
1592 empathy_contact_equal (gconstpointer contact1,
1593 gconstpointer contact2)
1600 if ((contact1 == NULL) != (contact2 == NULL)) {
1603 if (contact1 == contact2) {
1606 c1 = EMPATHY_CONTACT (contact1);
1607 c2 = EMPATHY_CONTACT (contact2);
1608 id1 = empathy_contact_get_id (c1);
1609 id2 = empathy_contact_get_id (c2);
1610 if (!tp_strdiff (id1, id2)) {
1617 /* This callback is called by geocode-glib when it found a position
1618 * for the given address. A position is necessary for a contact
1619 * to show up on the map
1622 geocode_cb (GObject *source,
1623 GAsyncResult *result,
1626 EmpathyContact *contact = user_data;
1627 EmpathyContactPriv *priv = GET_PRIV (contact);
1628 GError *error = NULL;
1629 GHashTable *new_location;
1630 GHashTable *resolved = NULL;
1631 gdouble latitude, longitude;
1633 if (priv->location == NULL)
1636 resolved = geocode_object_resolve_finish (GEOCODE_OBJECT (source), result,
1639 if (resolved == NULL)
1641 DEBUG ("Failed to resolve geocode: %s", error->message);
1642 g_error_free (error);
1646 if (!geocode_object_get_coords (resolved, &longitude, &latitude))
1649 new_location = tp_asv_new (
1650 EMPATHY_LOCATION_LAT, G_TYPE_DOUBLE, latitude,
1651 EMPATHY_LOCATION_LON, G_TYPE_DOUBLE, longitude,
1654 DEBUG ("\t - Latitude: %f", latitude);
1655 DEBUG ("\t - Longitude: %f", longitude);
1657 /* Copy remaning fields. LAT and LON were not defined so we won't overwrite
1658 * the values we just set. */
1659 tp_g_hash_table_update (new_location, priv->location,
1660 (GBoxedCopyFunc) g_strdup, (GBoxedCopyFunc) tp_g_value_slice_dup);
1662 /* Don't change the accuracy as we used an address to get this position */
1663 g_hash_table_unref (priv->location);
1664 priv->location = new_location;
1665 g_object_notify ((GObject *) contact, "location");
1668 tp_clear_pointer (&resolved, g_hash_table_unref);
1669 g_object_unref (contact);
1673 update_geocode (EmpathyContact *contact)
1675 GeocodeObject *geocode;
1676 GHashTable *location;
1678 location = empathy_contact_get_location (contact);
1679 if (location == NULL ||
1680 g_hash_table_size (location) == 0)
1683 /* No need to search for position if contact published it */
1684 if (g_hash_table_lookup (location, EMPATHY_LOCATION_LAT) != NULL ||
1685 g_hash_table_lookup (location, EMPATHY_LOCATION_LON) != NULL)
1688 geocode = geocode_object_new_for_params (location);
1689 if (geocode == NULL)
1692 geocode_object_resolve_async (geocode, NULL, geocode_cb,
1693 g_object_ref (contact));
1695 g_object_unref (geocode);
1699 static EmpathyCapabilities
1700 tp_caps_to_capabilities (TpCapabilities *caps)
1702 EmpathyCapabilities capabilities = 0;
1706 classes = tp_capabilities_get_channel_classes (caps);
1708 for (i = 0; i < classes->len; i++)
1710 GValueArray *class_struct;
1711 GHashTable *fixed_prop;
1713 TpHandleType handle_type;
1714 const gchar *chan_type;
1716 class_struct = g_ptr_array_index (classes, i);
1717 tp_value_array_unpack (class_struct, 2,
1721 handle_type = tp_asv_get_uint32 (fixed_prop,
1722 TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, NULL);
1723 if (handle_type != TP_HANDLE_TYPE_CONTACT)
1726 chan_type = tp_asv_get_string (fixed_prop,
1727 TP_PROP_CHANNEL_CHANNEL_TYPE);
1729 if (!tp_strdiff (chan_type, TP_IFACE_CHANNEL_TYPE_FILE_TRANSFER))
1731 capabilities |= EMPATHY_CAPABILITIES_FT;
1733 else if (!tp_strdiff (chan_type, TP_IFACE_CHANNEL_TYPE_STREAM_TUBE))
1735 const gchar *service;
1737 service = tp_asv_get_string (fixed_prop,
1738 TP_PROP_CHANNEL_TYPE_STREAM_TUBE_SERVICE);
1740 if (!tp_strdiff (service, "rfb"))
1741 capabilities |= EMPATHY_CAPABILITIES_RFB_STREAM_TUBE;
1743 else if (!tp_strdiff (chan_type, TP_IFACE_CHANNEL_TYPE_STREAMED_MEDIA))
1747 for (j = 0; allowed_prop[j] != NULL; j++)
1749 if (!tp_strdiff (allowed_prop[j],
1750 TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_AUDIO))
1751 capabilities |= EMPATHY_CAPABILITIES_AUDIO;
1752 else if (!tp_strdiff (allowed_prop[j],
1753 TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_VIDEO))
1754 capabilities |= EMPATHY_CAPABILITIES_VIDEO;
1757 if (tp_asv_get_boolean (fixed_prop,
1758 TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_AUDIO, NULL))
1759 capabilities |= EMPATHY_CAPABILITIES_AUDIO;
1760 if (tp_asv_get_boolean (fixed_prop,
1761 TP_PROP_CHANNEL_TYPE_STREAMED_MEDIA_INITIAL_VIDEO, NULL))
1762 capabilities |= EMPATHY_CAPABILITIES_VIDEO;
1764 else if (!tp_strdiff (chan_type, TP_IFACE_CHANNEL_TYPE_TEXT))
1766 if (tp_asv_get_boolean (fixed_prop,
1767 TP_PROP_CHANNEL_INTERFACE_SMS_SMS_CHANNEL, NULL))
1768 capabilities |= EMPATHY_CAPABILITIES_SMS;
1770 else if (!tp_strdiff (chan_type, TP_IFACE_CHANNEL_TYPE_CALL))
1774 if (tp_asv_get_boolean (fixed_prop,
1775 TP_PROP_CHANNEL_TYPE_CALL_INITIAL_AUDIO, NULL))
1776 capabilities |= EMPATHY_CAPABILITIES_AUDIO;
1778 if (tp_asv_get_boolean (fixed_prop,
1779 TP_PROP_CHANNEL_TYPE_CALL_INITIAL_VIDEO, NULL))
1780 capabilities |= EMPATHY_CAPABILITIES_VIDEO;
1782 for (j = 0; allowed_prop[j] != NULL; j++)
1784 if (!tp_strdiff (allowed_prop[j],
1785 TP_PROP_CHANNEL_TYPE_CALL_INITIAL_AUDIO))
1786 capabilities |= EMPATHY_CAPABILITIES_AUDIO;
1787 else if (!tp_strdiff (allowed_prop[j],
1788 TP_PROP_CHANNEL_TYPE_CALL_INITIAL_VIDEO))
1789 capabilities |= EMPATHY_CAPABILITIES_VIDEO;
1794 return capabilities;
1798 set_capabilities_from_tp_caps (EmpathyContact *self,
1799 TpCapabilities *caps)
1801 EmpathyCapabilities capabilities;
1806 capabilities = tp_caps_to_capabilities (caps);
1807 empathy_contact_set_capabilities (self, capabilities);
1811 contact_set_avatar_from_tp_contact (EmpathyContact *contact)
1813 EmpathyContactPriv *priv = GET_PRIV (contact);
1817 mime = tp_contact_get_avatar_mime_type (priv->tp_contact);
1818 file = tp_contact_get_avatar_file (priv->tp_contact);
1822 EmpathyAvatar *avatar;
1826 GError *error = NULL;
1828 if (!g_file_load_contents (file, NULL, &data, &len, NULL, &error))
1830 DEBUG ("Failed to load avatar: %s", error->message);
1832 g_error_free (error);
1833 contact_set_avatar (contact, NULL);
1837 path = g_file_get_path (file);
1839 avatar = empathy_avatar_new ((guchar *) data, len, mime, path);
1841 contact_set_avatar (contact, avatar);
1842 empathy_avatar_unref (avatar);
1848 contact_set_avatar (contact, NULL);
1853 empathy_contact_dup_from_tp_contact (TpContact *tp_contact)
1855 EmpathyContact *contact = NULL;
1857 g_return_val_if_fail (TP_IS_CONTACT (tp_contact), NULL);
1859 if (contacts_table == NULL)
1860 contacts_table = g_hash_table_new (g_direct_hash, g_direct_equal);
1862 contact = g_hash_table_lookup (contacts_table, tp_contact);
1864 if (contact == NULL)
1866 contact = empathy_contact_new (tp_contact);
1868 /* The hash table does not keep any ref.
1869 * contact keeps a ref to tp_contact, and is removed from the table in
1870 * contact_dispose() */
1871 g_hash_table_insert (contacts_table, tp_contact, contact);
1875 g_object_ref (contact);
1882 presence_cmp_func (EmpathyContact *a,
1885 FolksPresenceDetails *presence_a, *presence_b;
1887 presence_a = FOLKS_PRESENCE_DETAILS (empathy_contact_get_persona (a));
1888 presence_b = FOLKS_PRESENCE_DETAILS (empathy_contact_get_persona (b));
1890 /* We negate the result because we're sorting in reverse order (i.e. such that
1891 * the Personas with the highest presence are at the beginning of the list. */
1892 return -folks_presence_details_typecmp (
1893 folks_presence_details_get_presence_type (presence_a),
1894 folks_presence_details_get_presence_type (presence_b));
1898 voip_cmp_func (EmpathyContact *a,
1901 gboolean has_audio_a, has_audio_b;
1902 gboolean has_video_a, has_video_b;
1904 has_audio_a = empathy_contact_can_voip_audio (a);
1905 has_audio_b = empathy_contact_can_voip_audio (b);
1906 has_video_a = empathy_contact_can_voip_video (a);
1907 has_video_b = empathy_contact_can_voip_video (b);
1909 /* First check video */
1910 if (has_video_a == has_video_b)
1912 /* Use audio to to break tie */
1913 if (has_audio_a == has_audio_b)
1915 else if (has_audio_a)
1920 else if (has_video_a)
1927 ft_cmp_func (EmpathyContact *a,
1930 gboolean can_send_files_a, can_send_files_b;
1932 can_send_files_a = empathy_contact_can_send_files (a);
1933 can_send_files_b = empathy_contact_can_send_files (b);
1935 if (can_send_files_a == can_send_files_b)
1937 else if (can_send_files_a)
1944 rfb_stream_tube_cmp_func (EmpathyContact *a,
1947 gboolean rfb_a, rfb_b;
1949 rfb_a = empathy_contact_can_use_rfb_stream_tube (a);
1950 rfb_b = empathy_contact_can_use_rfb_stream_tube (b);
1960 /* Sort by presence as with presence_cmp_func(), but if the two contacts have
1961 * the same presence, prefer the one which can do both audio *and* video calls,
1962 * over the one which can only do one of the two. */
1964 voip_sort_func (EmpathyContact *a, EmpathyContact *b)
1966 gint presence_sort = presence_cmp_func (a, b);
1968 if (presence_sort != 0)
1969 return presence_sort;
1971 return voip_cmp_func (a, b);
1974 /* Sort by presence as with presence_cmp_func() and then break ties using the
1975 * most "capable" individual. So users will be able to pick more actions on
1976 * the contact in the "Contact" menu of the chat window. */
1978 chat_sort_func (EmpathyContact *a,
1983 result = presence_cmp_func (a, b);
1987 /* Prefer individual supporting file transfer */
1988 result = ft_cmp_func (a, b);
1992 /* Check audio/video capabilities */
1993 result = voip_cmp_func (a, b);
1997 /* Check 'Share my destop' feature */
1998 return rfb_stream_tube_cmp_func (a, b);
2002 get_sort_func_for_action (EmpathyActionType action_type)
2004 switch (action_type)
2006 case EMPATHY_ACTION_AUDIO_CALL:
2007 case EMPATHY_ACTION_VIDEO_CALL:
2008 return (GCompareFunc) voip_sort_func;
2009 case EMPATHY_ACTION_CHAT:
2010 return (GCompareFunc) chat_sort_func;
2011 case EMPATHY_ACTION_VIEW_LOGS:
2012 case EMPATHY_ACTION_SEND_FILE:
2013 case EMPATHY_ACTION_SHARE_MY_DESKTOP:
2015 return (GCompareFunc) presence_cmp_func;
2020 * empathy_contact_dup_best_for_action:
2021 * @individual: a #FolksIndividual
2022 * @action_type: the type of action to be performed on the contact
2024 * Chooses a #FolksPersona from the given @individual which is best-suited for
2025 * the given @action_type. "Best-suited" is determined by choosing the persona
2026 * with the highest presence out of all the personas which can perform the given
2027 * @action_type (e.g. are capable of video calling).
2029 * Return value: an #EmpathyContact for the best persona, or %NULL;
2030 * unref with g_object_unref()
2033 empathy_contact_dup_best_for_action (FolksIndividual *individual,
2034 EmpathyActionType action_type)
2039 EmpathyContact *best_contact = NULL;
2041 /* Build a list of EmpathyContacts that we can sort */
2042 personas = folks_individual_get_personas (individual);
2045 iter = gee_iterable_iterator (GEE_ITERABLE (personas));
2046 while (gee_iterator_next (iter))
2048 FolksPersona *persona = gee_iterator_get (iter);
2049 TpContact *tp_contact;
2050 EmpathyContact *contact = NULL;
2052 if (!empathy_folks_persona_is_interesting (persona))
2055 tp_contact = tpf_persona_get_contact (TPF_PERSONA (persona));
2056 if (tp_contact == NULL)
2059 contact = empathy_contact_dup_from_tp_contact (tp_contact);
2060 empathy_contact_set_persona (contact, FOLKS_PERSONA (persona));
2062 /* Only choose the contact if they're actually capable of the specified
2064 if (empathy_contact_can_do_action (contact, action_type))
2065 contacts = g_list_prepend (contacts, g_object_ref (contact));
2068 g_clear_object (&contact);
2069 g_clear_object (&persona);
2071 g_clear_object (&iter);
2073 /* Sort the contacts by some heuristic based on the action type, then take
2074 * the top contact. */
2075 if (contacts != NULL)
2077 contacts = g_list_sort (contacts, get_sort_func_for_action (action_type));
2078 best_contact = g_object_ref (contacts->data);
2081 g_list_foreach (contacts, (GFunc) g_object_unref, NULL);
2082 g_list_free (contacts);
2084 return best_contact;
2087 #define declare_contact_cb(name) \
2089 contact_##name##_cb (GObject *source, \
2090 GAsyncResult *result, \
2091 gpointer user_data) \
2093 TpContact *contact = (TpContact *) source; \
2094 GError *error = NULL; \
2096 if (!tp_contact_##name##_finish (contact, result, &error)) \
2098 DEBUG ("Failed to ##name## on %s\n", \
2099 tp_contact_get_identifier (contact)); \
2100 g_error_free (error); \
2104 declare_contact_cb (request_subscription)
2105 declare_contact_cb (authorize_publication)
2106 declare_contact_cb (unblock)
2109 empathy_contact_add_to_contact_list (EmpathyContact *self,
2110 const gchar *message)
2112 EmpathyContactPriv *priv = GET_PRIV (self);
2114 g_return_if_fail (priv->tp_contact != NULL);
2116 tp_contact_request_subscription_async (priv->tp_contact, message,
2117 contact_request_subscription_cb, NULL);
2119 tp_contact_authorize_publication_async (priv->tp_contact,
2120 contact_authorize_publication_cb, NULL);
2122 tp_contact_unblock_async (priv->tp_contact, contact_unblock_cb, NULL);
2125 declare_contact_cb (remove)
2128 empathy_contact_remove_from_contact_list (EmpathyContact *self)
2130 EmpathyContactPriv *priv = GET_PRIV (self);
2132 g_return_if_fail (priv->tp_contact != NULL);
2134 tp_contact_remove_async (priv->tp_contact, contact_remove_cb, NULL);