~ubuntu-branches/ubuntu/feisty/libtelepathy/feisty

<?xml version="1.0" ?>

<node name="/Channel_Interface_DTMF" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">

  <tp:copyright>Copyright (C) 2005, 2006 Collabora Limited</tp:copyright>

  <tp:copyright>Copyright (C) 2005, 2006 Nokia Corporation</tp:copyright>

  <tp:copyright>Copyright (C) 2006 INdT</tp:copyright>

  <tp:license xmlns="http://www.w3.org/1999/xhtml">

    <p>This library is free software; you can redistribute it and/or

modify it under the terms of the GNU Lesser General Public

License as published by the Free Software Foundation; either

version 2.1 of the License, or (at your option) any later version.</p>

 

<p>This library is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

Library General Public License for more details.</p>

 

<p>You should have received a copy of the GNU Lesser General Public

License along with this library; if not, write to the Free Software

Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA</p>

  </tp:license>

  <interface name="org.freedesktop.Telepathy.Channel.Interface.DTMF">

    <tp:requires interface="org.freedesktop.Telepathy.Channel"/>

    <signal name="ReceivedDTMF">

      <arg name="signal" type="u">

        <tp:docstring>A numeric signal number</tp:docstring>

      </arg>

      <arg name="duration" type="u">

        <tp:docstring>A numeric duration in milliseconds</tp:docstring>

      </arg>

      <tp:docstring>

        Signals that this channel received a DTMF tone.

      </tp:docstring>

    </signal>

    <method name="SendDTMF">

      <arg direction="in" name="signal" type="u">

        <tp:docstring>A numeric signal number</tp:docstring>

      </arg>

      <arg direction="in" name="duration" type="u">

        <tp:docstring>A numeric duration in milliseconds</tp:docstring>

      </arg>

      <tp:docstring>

        Requests that a DTMF tone is sent.

      </tp:docstring>

      <tp:possible-errors>

        <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>

        <tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>

        <tp:error name="org.freedesktop.Telepathy.Error.NotAvailable"/>

        <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>

      </tp:possible-errors>

    </method>

    <tp:docstring>

      An interface that gives a Channel the ability to send or receive DTMF

    signalling tones. This usually only makes sense for channels transporting

    audio.

    </tp:docstring>

  </interface>

</node>

<!-- vim:set sw=2 sts=2 et ft=xml: -->