TelepathyQt4: capabilities-base.h Source File

00001 /*
00002  * This file is part of TelepathyQt4
00003  *
00004  * Copyright (C) 2009-2010 Collabora Ltd. <http://www.collabora.co.uk/>
00005  * Copyright (C) 2009-2010 Nokia Corporation
00006  *
00007  * This library is free software; you can redistribute it and/or
00008  * modify it under the terms of the GNU Lesser General Public
00009  * License as published by the Free Software Foundation; either
00010  * version 2.1 of the License, or (at your option) any later version.
00011  *
00012  * This library is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00015  * Lesser General Public License for more details.
00016  *
00017  * You should have received a copy of the GNU Lesser General Public
00018  * License along with this library; if not, write to the Free Software
00019  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
00020  */
00021 
00022 #ifndef _TelepathyQt4_capabilities_base_h_HEADER_GUARD_
00023 #define _TelepathyQt4_capabilities_base_h_HEADER_GUARD_
00024 
00025 #ifndef IN_TELEPATHY_QT4_HEADER
00026 #error IN_TELEPATHY_QT4_HEADER
00027 #endif
00028 
00029 #include <TelepathyQt4/RequestableChannelClassSpec>
00030 #include <TelepathyQt4/Types>
00031 
00032 namespace Tp
00033 {
00034 
00035 class TELEPATHY_QT4_EXPORT CapabilitiesBase
00036 {
00037 public:
00038     CapabilitiesBase();
00039     CapabilitiesBase(const CapabilitiesBase &other);
00040     virtual ~CapabilitiesBase();
00041 
00042     CapabilitiesBase &operator=(const CapabilitiesBase &other);
00043 
00044     RequestableChannelClassSpecList allClassSpecs() const;
00045 
00046     TELEPATHY_QT4_DEPRECATED RequestableChannelClassList requestableChannelClasses() const;
00047 
00048     bool isSpecificToContact() const;
00049 
00050     bool textChats() const;
00051 
00052     bool streamedMediaCalls() const;
00053     bool streamedMediaAudioCalls() const;
00054     bool streamedMediaVideoCalls() const;
00055     bool streamedMediaVideoCallsWithAudio() const;
00056     bool upgradingStreamedMediaCalls() const;
00057 
00058     TELEPATHY_QT4_DEPRECATED bool supportsTextChats() const;
00059 
00060     TELEPATHY_QT4_DEPRECATED bool supportsMediaCalls() const;
00061     TELEPATHY_QT4_DEPRECATED bool supportsAudioCalls() const;
00062     TELEPATHY_QT4_DEPRECATED bool supportsVideoCalls(bool withAudio = true) const;
00063     TELEPATHY_QT4_DEPRECATED bool supportsUpgradingCalls() const;
00064 
00065     // later: FIXME TODO why not now‽
00066     // bool fileTransfers() const;
00067     // QList<FileHashType> fileTransfersRequireHash() const;
00068     //
00069     // bool streamTubes() const;
00070     // bool dBusTubes() const;
00071 
00072 protected:
00073     CapabilitiesBase(bool specificToContact);
00074     CapabilitiesBase(const RequestableChannelClassList &rccs,
00075             bool specificToContact);
00076     CapabilitiesBase(const RequestableChannelClassSpecList &rccSpecs,
00077             bool specificToContact);
00078 
00079     virtual void updateRequestableChannelClasses(
00080             const RequestableChannelClassList &rccs);
00081 
00082 private:
00083     friend class Connection;
00084     friend class Contact;
00085 
00086     struct Private;
00087     friend struct Private;
00088     // FIXME (API/ABI break) Make mPriv a QSharedDataPointer
00089     Private *mPriv;
00090 };
00091 
00092 } // Tp
00093 
00094 Q_DECLARE_METATYPE(Tp::CapabilitiesBase);
00095 
00096 #endif