~ubuntu-branches/ubuntu/karmic/ekiga/karmic

« back to all changes in this revision

Viewing changes to lib/engine/account/account.h

  • Committer: Bazaar Package Importer
  • Author(s): Ken VanDine
  • Date: 2009-03-17 15:14:12 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20090317151412-no6uq0wl8zz2hsw3
Tags: 3.2.0-0ubuntu1
* New upstream release (LP: #341367)
  - Better NAT support in case of Cone NAT
  - Uniformise detection of libnotify; fix compilation with mingw
  - Fix "URL completion combobox shows identical completions"
  - Fix "Assistant loosing values when going backward"
  - Fix GmConf settings when compiled with another package name
  - Fix unregistration of accounts
  - Fix build with --enable-kde
  - Fixed possible crash when retrieving presence information
  - New translations: crh, or
  - Updated translations: as, bg, bn_IN, da, de, el, eu, gl, gu, hi, hu,
    ja, kn, ko, ku, lt, ml, mr, or, pt, ro, ru, ta, te, tr
  - New help translation: en_GB
  - Updated help translation: fr
  - Better NAT support in case of Cone NAT
  - There is now only one H.263 plugin implementing both H.263 and H.263+
  - Allow several ALSA devices to have the same name
  - Added support for the G.722 audio codec: G.722 is a 16 kHz wideband
    audio codec advertised as HD Voice by the famous Polycom. It is a
    great boost in quality and interoperability
  - Added support for the CELT ultral-low delay audio codec: CELT delivers
    high quality audio at 32 kHz or 48 kHz, allowing to transmit music in
    high quality, with low delay and low bitrate
  - Added support for SIP dialog-info notifications: they allow displaying
    notifications of incoming calls in the roster. With software like
    kamailio or Asterisk, it allows being informed of incoming calls
    reaching your colleagues
  - Largely improved LDAP support: the OpenLDAP guys contributed several
    patches to provide state-of-the-art LDAP support in the Ekiga address
    book. The new code even supports authentication
  - Killed the gconf_test_age test, Ekiga can now finally work with
    badly installed GConf schemas
  - Better handling of multiple network interfaces with dynamic addition
    and removal
  - Added settings migration from Ekiga 2.0.x.
  - Other various fixes, cleanups, removal of deprecated symbols etc.
  - New translations: crh, or
  - New help translation: en_GB, eu
  - Updated many translations and help
  - Experimental features:
    * Significant improvements in IPv6 support
    * Gstreamer audio and video capture support near to be finished...
* debian/patches/migrate_2.0_settings.patch:
  - Removed, migration is now upstream
* debian/patches/00_news.patch
  - Removed
* debian/patches/ubuntu_lpi.patch:
  - Modified to work with 3.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
/*
 
3
 * Ekiga -- A VoIP and Video-Conferencing application
 
4
 * Copyright (C) 2000-2009 Damien Sandras <dsandras@seconix.com>
 
5
 
 
6
 * This program is free software; you can  redistribute it and/or modify
 
7
 * it under the terms of the GNU General Public License as published by
 
8
 * the Free Software Foundation; either version 2 of the License, or (at
 
9
 * your option) any later version. This program is distributed in the hope
 
10
 * that it will be useful, but WITHOUT ANY WARRANTY; without even the
 
11
 * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 
12
 * See the GNU General Public License for more details.
 
13
 *
 
14
 * You should have received a copy of the GNU General Public License along
 
15
 * with this program; if not, write to the Free Software Foundation, Inc.,
 
16
 * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
 
17
 *
 
18
 * Ekiga is licensed under the GPL license and as a special exception, you
 
19
 * have permission to link or otherwise combine this program with the
 
20
 * programs OPAL, OpenH323 and PWLIB, and distribute the combination, without
 
21
 * applying the requirements of the GNU GPL to the OPAL, OpenH323 and PWLIB
 
22
 * programs, as long as you do follow the requirements of the GNU GPL for all
 
23
 * the rest of the software thus combined.
 
24
 */
 
25
 
 
26
 
 
27
/*
 
28
 *                         account.h  -  description
 
29
 *                         ------------------------------------------
 
30
 *   begin                : written in 2008 by Damien Sandras
 
31
 *   copyright            : (c) 2008 by Damien Sandras
 
32
 *   description          : declaration of the interface of an AccountManager 
 
33
 *                          Account
 
34
 *
 
35
 */
 
36
 
 
37
#ifndef __ACCOUNT_H__
 
38
#define __ACCOUNT_H__
 
39
 
 
40
#include <set>
 
41
#include <map>
 
42
#include <string>
 
43
 
 
44
#include "account-core.h"
 
45
 
 
46
#include "chain-of-responsibility.h"
 
47
#include "form-request.h"
 
48
#include "menu-builder.h"
 
49
 
 
50
namespace Ekiga
 
51
{
 
52
 
 
53
/**
 
54
 * @addtogroup accounts 
 
55
 * @{
 
56
 */
 
57
 
 
58
  class Account
 
59
  {
 
60
  public:
 
61
 
 
62
 
 
63
    /** The destructor.
 
64
     */
 
65
    virtual ~Account () { }
 
66
 
 
67
 
 
68
    /** Returns the name of the Ekiga::Account.
 
69
     * This function is purely virtual and should be implemented by the
 
70
     * Ekiga::Account descendant.
 
71
     * @return The name of the Ekiga::Contact.
 
72
     */
 
73
    virtual const std::string get_name () const = 0;
 
74
 
 
75
 
 
76
    /** Returns the address of record for that Ekiga::Account.
 
77
     * @return The address of record.
 
78
     */
 
79
    virtual const std::string get_aor () const = 0;
 
80
 
 
81
 
 
82
    /** Returns the hostname for the Ekiga::Account.
 
83
     * This function is purely virtual and should be implemented by the
 
84
     * Ekiga::Account descendant.
 
85
     * @return The host name of the Ekiga::Account.
 
86
     */
 
87
    virtual const std::string get_host () const = 0;
 
88
 
 
89
 
 
90
    /** Subscribe the given account.
 
91
     * This function is purely virtual and should be implemented by the
 
92
     * Ekiga::Account descendant.
 
93
     */
 
94
    virtual void enable () = 0;
 
95
 
 
96
 
 
97
    /** Unsubscribe the given account.
 
98
     * This function is purely virtual and should be implemented by the
 
99
     * Ekiga::Account descendant.
 
100
     */
 
101
    virtual void disable () = 0;
 
102
 
 
103
 
 
104
    /** Return true if the account is enabled.
 
105
     * It does not mean that the account is successfully registered, it
 
106
     * just means it is enabled.
 
107
     * This function is purely virtual and should be implemented by the
 
108
     * Ekiga::Account descendant.
 
109
     */
 
110
    virtual bool is_enabled () const = 0;
 
111
 
 
112
 
 
113
    /** Return true if the account is active.
 
114
     * This function is purely virtual and should be implemented by the
 
115
     * Ekiga::Account descendant.
 
116
     */
 
117
    virtual bool is_active () const = 0;
 
118
    
 
119
    
 
120
    /** Create the menu for that account and its actions.
 
121
     * This function is purely virtual and should be implemented by
 
122
     * the descendant of the Ekiga::Contact.
 
123
     * @param A MenuBuilder object to populate.
 
124
     */
 
125
    virtual bool populate_menu (MenuBuilder &) = 0;
 
126
 
 
127
 
 
128
    /**
 
129
     * Signals on that object
 
130
     */
 
131
 
 
132
    /** This signal is emitted when the Account has been updated.
 
133
     */
 
134
    sigc::signal0<void> updated;
 
135
 
 
136
 
 
137
    /** This signal is emitted when the Account has been removed.
 
138
     */
 
139
    sigc::signal0<void> removed;
 
140
 
 
141
 
 
142
    /** This signal is emitted when there is a new registration event for 
 
143
     *  the Account.
 
144
     * @param: state is the state
 
145
     *         info contains information about the registration status
 
146
     */
 
147
    sigc::signal2<void, Ekiga::AccountCore::RegistrationState, std::string> registration_event;
 
148
 
 
149
 
 
150
    /** This signal is emitted when there is a new message waiting indication
 
151
     * @param: mwi is the message waiting indication
 
152
     */
 
153
    sigc::signal1<void, std::string> mwi_event;
 
154
 
 
155
 
 
156
    /** This chain allows the Account to present forms to the user
 
157
     */
 
158
    ChainOfResponsibility<FormRequest*> questions;
 
159
  };
 
160
 
 
161
/**
 
162
 * @}
 
163
 */
 
164
 
 
165
};
 
166
#endif