git.maemo.org Git - theonering/blob - src/tp/_generated/Channel_Interface_Call_State.py

   1 # -*- coding: utf-8 -*-
   2 # Generated from the Telepathy spec
   3 """ Copyright (C) 2008 Collabora Limited
   4  Copyright (C) 2008 Nokia Corporation
   5
   6     This library is free software; you can redistribute it and/or
   7 modify it under the terms of the GNU Lesser General Public
   8 License as published by the Free Software Foundation; either
   9 version 2.1 of the License, or (at your option) any later version.
  10
  11 This library is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 Lesser General Public License for more details.
  15
  16 You should have received a copy of the GNU Lesser General Public
  17 License along with this library; if not, write to the Free Software
  18 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  19
  20 """
  21
  22 import dbus.service
  23
  24
  25 class ChannelInterfaceCallState(dbus.service.Interface):
  26     """\
  27       An interface for streamed media channels that can indicate call
  28         progress or call states. The presence of this interface is no guarantee
  29         that call states will actually be signalled (for instance, SIP
  30         implementations are not guaranteed to generate status 180 Ringing, so a
  31         call can be accepted without the Ringing flag ever having been set;
  32         similarly, Jingle implementations are not guaranteed to send
  33         <ringing/>).
  34
  35       To notify the other participant in the call that they are on hold,
  36         see Hold.
  37     """
  38
  39     def __init__(self):
  40         self._interfaces.add('org.freedesktop.Telepathy.Channel.Interface.CallState')
  41
  42     @dbus.service.method('org.freedesktop.Telepathy.Channel.Interface.CallState', in_signature='', out_signature='a{uu}')
  43     def GetCallStates(self):
  44         """
  45         Get the current call states for all contacts involved in this call.
  46
  47         """
  48         raise NotImplementedError
  49
  50     @dbus.service.signal('org.freedesktop.Telepathy.Channel.Interface.CallState', signature='uu')
  51     def CallStateChanged(self, Contact, State):
  52         """
  53         Emitted when the state of a member of the channel has changed.
  54
  55         """
  56         pass
  57