libempathy-gtk/empathy-sound-manager.h

   1 /*
   2  * empathy-sound-manager.h - Various sound related utility functions.
   3  * Copyright (C) 2009 Collabora Ltd.
   4  *
   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.
   9  *
  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.
  14  *
  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
  18  */
  19
  20
  21 #ifndef __EMPATHY_SOUND_MANAGER_H__
  22 #define __EMPATHY_SOUND_MANAGER_H__
  23
  24 #include <gtk/gtk.h>
  25 #include <canberra-gtk.h>
  26
  27 G_BEGIN_DECLS
  28
  29 /* NOTE: Keep this sync with sound_entries in empathy-sound-manager.c */
  30 typedef enum {
  31   EMPATHY_SOUND_MESSAGE_INCOMING = 0,
  32   EMPATHY_SOUND_MESSAGE_OUTGOING,
  33   EMPATHY_SOUND_CONVERSATION_NEW,
  34   EMPATHY_SOUND_CONTACT_CONNECTED,
  35   EMPATHY_SOUND_CONTACT_DISCONNECTED,
  36   EMPATHY_SOUND_ACCOUNT_CONNECTED,
  37   EMPATHY_SOUND_ACCOUNT_DISCONNECTED,
  38   EMPATHY_SOUND_PHONE_INCOMING,
  39   EMPATHY_SOUND_PHONE_OUTGOING,
  40   EMPATHY_SOUND_PHONE_HANGUP,
  41   LAST_EMPATHY_SOUND,
  42 } EmpathySound;
  43
  44 #define EMPATHY_TYPE_SOUND_MANAGER         (empathy_sound_manager_get_type ())
  45 #define EMPATHY_SOUND_MANAGER(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), EMPATHY_TYPE_SOUND_MANAGER, EmpathySoundManager))
  46 #define EMPATHY_SOUND_MANAGER_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), EMPATHY_TYPE_SOUND_MANAGER, EmpathySoundManagerClass))
  47 #define EMPATHY_IS_SOUND_MANAGER(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), EMPATHY_TYPE_SOUND_MANAGER))
  48 #define EMPATHY_IS_SOUND_MANAGER_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), EMPATHY_TYPE_SOUND_MANAGER))
  49 #define EMPATHY_SOUND_MANAGER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), EMPATHY_TYPE_SOUND_MANAGER, EmpathySoundManagerClass))
  50
  51 typedef struct _EmpathySoundManager EmpathySoundManager;
  52 typedef struct _EmpathySoundManagerClass EmpathySoundManagerClass;
  53 typedef struct _EmpathySoundManagerPrivate EmpathySoundManagerPrivate;
  54
  55 struct _EmpathySoundManager
  56 {
  57   GObject parent;
  58   EmpathySoundManagerPrivate *priv;
  59 };
  60
  61 struct _EmpathySoundManagerClass
  62 {
  63   GObjectClass parent_class;
  64 };
  65
  66 GType empathy_sound_manager_get_type (void) G_GNUC_CONST;
  67
  68 EmpathySoundManager * empathy_sound_manager_dup_singleton (void);
  69
  70 gboolean empathy_sound_manager_play (EmpathySoundManager *self,
  71     GtkWidget *widget,
  72     EmpathySound sound_id);
  73
  74 void empathy_sound_manager_stop (EmpathySoundManager *self,
  75     EmpathySound sound_id);
  76
  77 gboolean empathy_sound_manager_start_playing (EmpathySoundManager *self,
  78     GtkWidget *widget,
  79     EmpathySound sound_id,
  80     guint timeout_before_replay);
  81
  82 gboolean empathy_sound_manager_play_full (EmpathySoundManager *self,
  83     GtkWidget *widget,
  84     EmpathySound sound_id,
  85     ca_finish_callback_t callback,
  86     gpointer user_data);
  87
  88 G_END_DECLS
  89
  90 #endif /* #ifndef __EMPATHY_SOUND_MANAGER_H__ */