diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-01-21 14:12:23 +0000 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-01-21 14:12:23 +0000 |
commit | 963007bb16b76e6ccbad082fef1184785349cada (patch) | |
tree | b2002ca7184507fa1e1af2e31364b89317a1d2d8 /spec/Channel_Interface_Splittable.xml | |
parent | 5eacf345c57b919883db082ec2aad1609e8fa251 (diff) | |
download | telepathy-glib-963007bb16b76e6ccbad082fef1184785349cada.tar.gz |
Import telepathy-spec 0.19.0
Diffstat (limited to 'spec/Channel_Interface_Splittable.xml')
-rw-r--r-- | spec/Channel_Interface_Splittable.xml | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/spec/Channel_Interface_Splittable.xml b/spec/Channel_Interface_Splittable.xml new file mode 100644 index 000000000..063565e8c --- /dev/null +++ b/spec/Channel_Interface_Splittable.xml @@ -0,0 +1,74 @@ +<?xml version="1.0" ?> +<node name="/Channel_Interface_Splittable" + xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"> + <tp:copyright>Copyright © 2009 Collabora Limited</tp:copyright> + <tp:copyright>Copyright © 2009 Nokia Corporation</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 + Lesser 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., 51 Franklin Street, Fifth Floor, Boston, MA + 02110-1301, USA.</p> + </tp:license> + <interface + name="org.freedesktop.Telepathy.Channel.Interface.Splittable.DRAFT" + tp:causes-havoc="experimental"> + <tp:added version="0.19.0">(draft 1)</tp:added> + <tp:requires interface="org.freedesktop.Telepathy.Channel"/> + + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>An interface for channels that can be made conceptually part of a + <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface" + >Conference.DRAFT</tp:dbus-ref>, and can then be detached from that + conference.</p> + + <tp:rationale> + <p>This interface addresses part of freedesktop.org <a + href="http://bugs.freedesktop.org/show_bug.cgi?id=24906">bug + #24906</a> (GSM-compatible conference calls). GSM is currently + the only protocol known to implement this; PBXs might implement + it too.</p> + </tp:rationale> + </tp:docstring> + + <method name="Split" + tp:name-for-bindings="Split"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>Request that this channel is removed from any + <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface" + >Conference.DRAFT</tp:dbus-ref> of which it is a part.</p> + + <p>This implies that the media streams within the conference are put on + hold and the media streams within the member channel leaving the + conference are unheld. + <strong>[FIXME: or, maybe it'd be less surprising if it didn't do + this?]</strong> + </p> + </tp:docstring> + + <tp:possible-errors> + <tp:error name="org.freedesktop.Telepathy.Errors.InvalidArgument"> + <tp:docstring> + This channel isn't in a conference. + </tp:docstring> + </tp:error> + <tp:error name="org.freedesktop.Telepathy.Errors.NotAvailable"> + <tp:docstring> + This channel is in a conference but can't currently be split away + from it. + </tp:docstring> + </tp:error> + </tp:possible-errors> + </method> + + </interface> +</node> |