summaryrefslogtreecommitdiff
path: root/extensions
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2010-02-22 18:22:29 +0000
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2010-02-22 18:22:29 +0000
commit7681838ed4c82198be95a90ac98395b607dab94c (patch)
tree6d40c8117bac7a47282f2702d2c59f129aa205af /extensions
parentbc62ca21f71fc6a84cad4f5c4e105e5c0870e6e3 (diff)
extensions: use the spec's copy of Call stuff, not our own
This also fixes distcheck; the Call spec XML was incorrectly not in EXTRA_DIST.
Diffstat (limited to 'extensions')
-rw-r--r--extensions/Call_Content.xml141
-rw-r--r--extensions/Call_Content_Codec_Offer.xml57
-rw-r--r--extensions/Call_Content_Interface_Media.xml229
-rw-r--r--extensions/Call_Stream.xml165
-rw-r--r--extensions/Call_Stream_Endpoint.xml95
-rw-r--r--extensions/Call_Stream_Interface_Media.xml400
-rw-r--r--extensions/Channel_Type_Call.xml931
-rw-r--r--extensions/call-content.xml4
-rw-r--r--extensions/call-stream.xml4
-rw-r--r--extensions/channel.xml2
-rw-r--r--extensions/misc.xml4
11 files changed, 7 insertions, 2025 deletions
diff --git a/extensions/Call_Content.xml b/extensions/Call_Content.xml
deleted file mode 100644
index 1d5e891d..00000000
--- a/extensions/Call_Content.xml
+++ /dev/null
@@ -1,141 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Call_Content"
- xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2009 Collabora Ltd.</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.Call.Content.DRAFT"
- tp:causes-havoc="experimental">
- <tp:added version="0.19.0">(draft 1)</tp:added>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- This object represents one Content inside a Call. For example in an
- audio/video call there would be one audio and one video content. Each
- content has one or more <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call">Stream.DRAFT</tp:dbus-ref>
- objects which represent the actual transport to one or more contacts.
-
- </tp:docstring>
-
- <property name="Name" tp:name-for-bindings="Name" type="s" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The name of the content.
- [FIXME: rationale?]</p>
- </tp:docstring>
- </property>
-
- <property name="Type" tp:name-for-bindings="Type"
- type="u" tp:type="Media_Stream_Type" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The media type of this content</p>
- </tp:docstring>
- </property>
-
- <property name="Creator" tp:name-for-bindings="Creator"
- type="u" tp:type="Contact_Handle" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The creator of this content</p>
- </tp:docstring>
- </property>
-
- <tp:enum name="Call_Content_Disposition" type="u">
- <tp:docstring>
- [FIXME]
- </tp:docstring>
-
- <tp:enumvalue suffix="None" value="0">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- The content has no specific disposition
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="Early_Media" value="1">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- [FIXME: what does this mean?]
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="Initial" value="2">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The content was initially part of the call. When <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel.Type.Call.DRAFT"
- >Accept</tp:dbus-ref> is called on the channel, all streams of
- this content where the self-handle's sending state in <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.DRAFT"
- >Senders</tp:dbus-ref> is Sending_State_Pending_Send
- will be moved to Sending_State_Sending as if <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.DRAFT"
- >SetSending</tp:dbus-ref>(TRUE) had been called.</p>
- </tp:docstring>
- </tp:enumvalue>
- </tp:enum>
-
- <property name="Disposition" tp:name-for-bindings="Disposition"
- type="u" tp:type="Call_Content_Disposition" access="read">
- <tp:docstring>
- The disposition of this content. This property cannot change.
- </tp:docstring>
- </property>
-
- <signal name="StreamAdded" tp:name-for-bindings="Stream_Added">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Emitted when a stream is added to a call</p>
- </tp:docstring>
- <arg name="Stream" type="o">
- <tp:docstring>
- The stream which was added
- </tp:docstring>
- </arg>
- </signal>
-
- <signal name="StreamRemoved" tp:name-for-bindings="Stream_Removed">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Emitted when a stream is added to a call</p>
- </tp:docstring>
- <arg name="Stream" type="o">
- <tp:docstring>
- The stream which was removed
- </tp:docstring>
- </arg>
- </signal>
-
- <property name="Streams" tp:name-for-bindings="Streams"
- type="ao" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The list of
- <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call">Stream.DRAFT</tp:dbus-ref>
- objects that exist in this content.</p>
-
- <tp:rationale>
- <p>In a conference call multiple parties can share one media content
- (say, audio), but the streaming of that media can either be shared
- or separate. For example, in a multicast conference all contacts
- would share one stream, while in a Muji conference there would be
- a stream for each participant.</p>
- </tp:rationale>
-
- <p>Change notification is via
- <tp:member-ref>StreamAdded</tp:member-ref> and
- <tp:member-ref>StreamRemoved</tp:member-ref>.</p>
- </tp:docstring>
- </property>
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Call_Content_Codec_Offer.xml b/extensions/Call_Content_Codec_Offer.xml
deleted file mode 100644
index 31ff0b3c..00000000
--- a/extensions/Call_Content_Codec_Offer.xml
+++ /dev/null
@@ -1,57 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Call_Content_Codec_Offer"
- xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2009 Collabora Ltd.</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.Call.Content.CodecOffer.DRAFT"
- tp:causes-havoc="experimental">
- <tp:added version="0.19.0">(draft 1)</tp:added>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- This object represents an offer of a Codec payload mapping.
- FIXME add Accept and Reject signals ?
- </tp:docstring>
-
- <method name="Accept" tp:name-for-bindings="Accept">
- <arg name="Codecs" direction="in"
- type="a(usuua{ss})" tp:type="Codec[]" />
- <tp:docstring>
- Accept the updated Codec mapping and update the local mapping
- </tp:docstring>
- </method>
-
- <method name="Reject" tp:name-for-bindings="Reject">
- <tp:docstring>
- Reject the proposed update to the codecs
- FIXME add error codes and strings here
- </tp:docstring>
- </method>
-
- <property name="RemoteContactCodecMap"
- tp:name-for-bindings="Remote_Contact_Codec_Map"
- type="a{ua(usuua{ss})}" tp:type="Contact_Codec_Map" access="read">
- <tp:docstring>
- A map from remote contacts to the lists of codecs they support.
- </tp:docstring>
- </property>
-
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Call_Content_Interface_Media.xml b/extensions/Call_Content_Interface_Media.xml
deleted file mode 100644
index 2b3eb65d..00000000
--- a/extensions/Call_Content_Interface_Media.xml
+++ /dev/null
@@ -1,229 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Call_Content_Interface_Media"
- xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2009 Collabora Ltd.</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.Call.Content.Interface.Media.DRAFT"
- tp:causes-havoc="experimental">
- <tp:added version="0.19.0">(draft 1)</tp:added>
- <tp:requires interface="org.freedesktop.Telepathy.Call.Content"/>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- Interface to use by a software implementation of media streaming.
-
- FIXME: How should the streaming implementation know when it is its turn
- to set the codecs.
- </tp:docstring>
-
- <tp:struct name="Codec" array-name="Codec_List">
- <tp:docstring>
- A description of a codec.
- </tp:docstring>
-
- <tp:member name="Identifier" type="u">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- Numeric identifier for the codec. This will be used as the PT in the
- SDP or content description.
- </tp:docstring>
- </tp:member>
-
- <tp:member name="Name" type="s">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- The name of the codec.
- </tp:docstring>
- </tp:member>
-
- <tp:member name="Clockrate" type="u">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- The clockrate of the codec
- </tp:docstring>
- </tp:member>
- <tp:member name="Channels" type="u">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- Number of channels of the codec if applicable, otherwise 0
- </tp:docstring>
- </tp:member>
-
- <tp:member name="Parameters" type="a{ss}">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- Extra parameters for this codec
- </tp:docstring>
- </tp:member>
- </tp:struct>
-
- <tp:mapping name="Contact_Codec_Map">
- <tp:docstring>
- A map from contacts to the lists of codecs they support.
- </tp:docstring>
-
- <tp:member name="Handle" type="u" tp:type="Contact_Handle">
- <tp:docstring>
- A contact
- </tp:docstring>
- </tp:member>
-
- <tp:member name="Codecs" type="a(usuua{ss})" tp:type="Codec[]">
- <tp:docstring>
- The codecs that the contact supports
- </tp:docstring>
- </tp:member>
- </tp:mapping>
-
- <tp:struct name="Codec_Offering">
- <tp:docstring>
- A codec offer and its corresponding remote contact codec map.
- </tp:docstring>
-
- <tp:member name="Codec_Offer" type="o">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- The object path to the
- <tp:dbus-ref namespace="org.freedesktop.Telepathy.Call.Content"
- >CodecOffer.DRAFT</tp:dbus-ref>
- </tp:docstring>
- </tp:member>
-
- <tp:member name="Remote_Contact_Codec_Map" type="a{ua(usuua{ss})}"
- tp:type="Contact_Codec_Map">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- The <tp:dbus-ref namespace="org.freedesktop.Telepathy.Call.Content"
- >CodecOffer.DRAFT.RemoteContactCodecMap</tp:dbus-ref> property
- of the codec offer.
- </tp:docstring>
- </tp:member>
- </tp:struct>
-
- <signal name="CodecsChanged" tp:name-for-bindings="Codecs_Changed">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Emitted when the codecs in use change.</p>
-
- <p>As well as acting as change notification for the
- <tp:member-ref>ContactCodecMap</tp:member-ref>, emission of this
- signal implies that the <tp:member-ref>CodecOffer</tp:member-ref>
- property has changed to <code>('/', {})</code>.</p>
- </tp:docstring>
-
- <arg name="Updated_Codecs" type="a{ua(usuua{ss})}"
- tp:type="Contact_Codec_Map">
- <tp:docstring>
- A map from contacts to their codecs. Each pair in this map is added
- to the <tp:member-ref>ContactCodecMap</tp:member-ref> property,
- replacing any previous pair with that key.
- </tp:docstring>
- </arg>
-
- <arg name="Removed_Contacts" type="au" tp:type="Contact_Handle[]">
- <tp:docstring>
- A list of keys which were removed from the
- <tp:member-ref>ContactCodecMap</tp:member-ref>, probably because
- those contacts left the call.
- </tp:docstring>
- </arg>
- </signal>
-
- <method name="SetCodecs" tp:name-for-bindings="Set_Codecs">
- <tp:docstring>
- Set or update the local codec mapping.
- </tp:docstring>
-
- <arg name="Codecs" direction="in"
- type="a(usuua{ss})" tp:type="Codec[]">
- <tp:docstring>
- The codecs now supported by the local user.
- </tp:docstring>
- </arg>
- </method>
-
- <property name="ContactCodecMap" tp:name-for-bindings="Contact_Codec_Map"
- type="a{ua(usuua{ss})}" tp:type="Contact_Codec_Map" access="read">
- <tp:docstring>
- <p>A map from contact handles (including the local user's own handle)
- to the codecs supported by that contact.</p>
-
- <p>Change notification is via
- <tp:member-ref>CodecsChanged</tp:member-ref>.</p>
- </tp:docstring>
- </property>
-
- <signal name="NewCodecOffer" tp:name-for-bindings="New_Codec_Offer">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Emitted when a new <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Content"
- >CodecOffer.DRAFT</tp:dbus-ref> appears. The streaming
- implementation MUST respond by calling the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Content.CodecOffer.DRAFT"
- >Accept</tp:dbus-ref> or <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Content.CodecOffer.DRAFT"
- >Reject</tp:dbus-ref> method on the codec offer object.</p>
-
- <p>Emission of this signal indicates that the
- <tp:member-ref>CodecOffer</tp:member-ref> property has changed to
- <code>(Offer, Codecs)</code>.</p>
- </tp:docstring>
-
- <arg name="Offer" type="o">
- <tp:docstring>
- The object path of the new codec offer. This replaces any previous
- codec offer.
- </tp:docstring>
- </arg>
-
- <arg name="Codecs" type="a{ua(usuua{ss})}" tp:type="Contact_Codec_Map">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The <tp:dbus-ref namespace="org.freedesktop.Telepathy.Call.Content"
- >CodecOffer.DRAFT.RemoteContactCodecMap</tp:dbus-ref> property
- of the codec offer.</p>
-
- <tp:rationale>
- <p>Having the RemoteContactCodecMap property here saves a D-Bus
- round-trip - it shouldn't be necessary to get the property
- from the CodecOffer object, in practice.</p>
- </tp:rationale>
- </tp:docstring>
- </arg>
- </signal>
-
- <property name="CodecOffer" tp:name-for-bindings="Codec_Offer"
- type="(oa{ua(usuua{ss})})" tp:type="Codec_Offering" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The object path to the current
- <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Content"
- >CodecOffer.DRAFT</tp:dbus-ref> object, and its
- <tp:dbus-ref namespace="org.freedesktop.Telepathy.Call.Content"
- >CodecOffer.DRAFT.RemoteContactCodecMap</tp:dbus-ref> property.
- If the object path is "/" then there isn't an outstanding
- codec offer, and the mapping MUST be empty.</p>
-
- <tp:rationale>
- <p>Having the RemoteContactCodecMap property here saves a D-Bus
- round-trip - it shouldn't be necessary to get the property
- from the CodecOffer object, in practice.</p>
- </tp:rationale>
-
- <p>Change notification is via
- <tp:member-ref>NewCodecOffer</tp:member-ref> (which replaces the
- value of this property with a new codec offer), and
- <tp:member-ref>CodecsChanged</tp:member-ref> (which implies that
- there is no longer any active codec offer).</p>
- </tp:docstring>
- </property>
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Call_Stream.xml b/extensions/Call_Stream.xml
deleted file mode 100644
index 302bd5e9..00000000
--- a/extensions/Call_Stream.xml
+++ /dev/null
@@ -1,165 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Call_Stream"
- xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2009 Collabora Ltd.</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.Call.Stream.DRAFT"
- tp:causes-havoc="experimental">
- <tp:added version="0.19.0">(draft 1)</tp:added>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- One stream inside a content
- FIXME, direction should be a mapping of contact -> (bool)sending ?
- </tp:docstring>
-
- <method name="SetSending" tp:name-for-bindings="Set_Sending">
- <p>Set the stream to start or stop sending media from the local
- user to other contacts.</p>
-
- <arg name="Send" type="b" direction="in">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>If true, the local user's sending state should change
- to Sending, if it isn't already.</p>
-
- <p>If false, the local user's sending state should change to None,
- if it isn't already.</p>
- </tp:docstring>
- </arg>
-
- <tp:possible-errors>
- <tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
- <tp:docstring>
- [FIXME: when?]
- </tp:docstring>
- </tp:error>
- </tp:possible-errors>
- </method>
-
- <method name="RequestReceiving" tp:name-for-bindings="Request_Receiving">
- <tp:docstring>
- Request that a remote contact stops or starts sending on this stream.
- </tp:docstring>
-
- <arg name="Contact" type="u" tp:type="Contact_Handle" direction="in">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Contact from which sending is requested</p>
- </tp:docstring>
- </arg>
-
- <arg name="Receive" type="b" direction="in">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>If true, request that the given contact starts to send media.
- If false, request that the given contact stops sending media.</p>
- </tp:docstring>
- </arg>
-
- <tp:possible-errors>
- <tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
- <tp:docstring>
- [FIXME: when?]
- </tp:docstring>
- </tp:error>
- </tp:possible-errors>
- </method>
-
- <signal name="SendersChanged"
- tp:name-for-bindings="Senders_Changed">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- Emitted when <tp:member-ref>Senders</tp:member-ref> changes.
- </tp:docstring>
-
- <arg name="Updates" type="a{uu}" tp:type="Contact_Sending_State_Map">
- <tp:docstring>
- A mapping from channel-specific handles to their updated sending
- state, whose keys include at least the senders who were added,
- and the senders whose states changed.
- </tp:docstring>
- </arg>
- <arg name="Removed" type="au" tp:type="Contact_Handle[]">
- <tp:docstring>
- The channel-specific handles that were removed from
- the keys of the Senders property, as a result of the
- contact leaving this stream
- </tp:docstring>
- </arg>
- </signal>
-
- <tp:enum name="Sending_State" type="u">
- <tp:docstring>
- Tristate indicating whether a contact is sending media.
- </tp:docstring>
-
- <tp:enumvalue suffix="None" value="0">
- <tp:docstring>
- The contact is not sending media and has not been asked to do so.
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="Pending_Send" value="1">
- <tp:docstring>
- The contact has been asked to start sending media.
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="Sending" value="2">
- <tp:docstring>
- The contact is sending media.
- </tp:docstring>
- </tp:enumvalue>
- </tp:enum>
-
- <tp:mapping name="Contact_Sending_State_Map">
- <tp:docstring>
- A map from contacts to their sending state.
- </tp:docstring>
- <tp:member name="Contact" type="u" tp:type="Contact_Handle">
- </tp:member>
- <tp:member name="Sending" type="u" tp:type="Sending_State">
- <tp:docstring>
- </tp:docstring>
- </tp:member>
- </tp:mapping>
-
- <property name="Senders" tp:name-for-bindings="Senders"
- type="a{uu}" access="read" tp:type="Contact_Sending_State_Map">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A map from contacts to their sending state.</p>
-
- <p>The local user's handle in this map (the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel.Interface"
- >Group.SelfHandle</tp:dbus-ref> if the channel implements
- Group, or the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy"
- >Connection.SelfHandle</tp:dbus-ref> otherwise) indicates
- whether the local user is sending media. Media sent on this stream
- should be assumed to be received, directly or indirectly, by every
- other contact in the Senders mapping. Sending_State_Pending_Send
- indicates that another contact has asked the local user to send
- media.</p>
-
- <p>Other contacts' handles in this map indicate whether they are
- sending media to the contacts in this stream.
- Sending_State_Pending_Send indicates contacts who are not sending but
- have been asked to do so.</p>
- </tp:docstring>
- </property>
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Call_Stream_Endpoint.xml b/extensions/Call_Stream_Endpoint.xml
deleted file mode 100644
index fbab2cfa..00000000
--- a/extensions/Call_Stream_Endpoint.xml
+++ /dev/null
@@ -1,95 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Call_Stream_Endpoint"
- xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2009 Collabora Ltd.</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.Call.Stream.Endpoint.DRAFT"
- tp:causes-havoc="experimental">
- <tp:added version="0.19.0">(draft 1)</tp:added>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- This object represents a set of candidates of one end-point.
- </tp:docstring>
-
- <property name="RemoteCredentials"
- tp:name-for-bindings="Remote_Credentials"
- type="(ss)" tp:type="Stream_Credentials" access="read">
- </property>
-
- <signal name="RemoteCredentialsSet"
- tp:name-for-bindings="Remote_Credentials_Set">
- <arg name="Username" type="s" />
- <arg name="Password" type="s" />
- </signal>
-
- <property name="RemoteCandidates" tp:name-for-bindings="Remote_Candidates"
- type="a(usqa{sv})" tp:type="Candidate[]" access="read">
- </property>
-
- <signal name="RemoteCandidatesAdded"
- tp:name-for-bindings="Remote_Candidates_Added">
- <arg name="Candidates"
- type="a(usqa{sv})" tp:type="Candidate[]"/>
- </signal>
-
- <signal name="CandidateSelected"
- tp:name-for-bindings="Candidate_Selected">
- <arg name="Candidate"
- type="(usqa{sv})" tp:type="Candidate"/>
- </signal>
-
- <property name="SelectedCandidate"
- tp:name-for-bindings="Selected_Candidate"
- type="(usqa{sv})" tp:type="Candidate" access="read">
- </property>
-
- <method name="SetSelectedCandidate"
- tp:name-for-bindings="Set_Selected_Candidate">
- <arg name="Candidate"
- type="(usqa{sv})" tp:type="Candidate" direction="in">
- <tp:docstring>
- </tp:docstring>
- </arg>
- </method>
-
- <property name="StreamState" tp:name-for-bindings="Stream_State"
- type="u" tp:type="Media_Stream_State"
- access="read">
- </property>
-
- <signal name="StreamStateChanged"
- tp:name-for-bindings="Stream_State_Changed">
- <arg name="state"
- type="u" tp:type="Media_Stream_State"/>
- </signal>
-
- <method name="SetStreamState"
- tp:name-for-bindings="Set_Stream_State">
- <arg name="State" type="u" tp:type="Media_Stream_State"
- direction="in" />
- </method>
-
- <property name="Transport" tp:name-for-bindings="Transport"
- type="u" tp:type="Stream_Transport_Type" access="read">
- </property>
-
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Call_Stream_Interface_Media.xml b/extensions/Call_Stream_Interface_Media.xml
deleted file mode 100644
index ccf90337..00000000
--- a/extensions/Call_Stream_Interface_Media.xml
+++ /dev/null
@@ -1,400 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Call_Stream_Interface_Media"
- xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright>Copyright © 2009 Collabora Ltd.</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.Call.Stream.Interface.Media.DRAFT"
- tp:causes-havoc="experimental">
- <tp:added version="0.19.0">(draft 1)</tp:added>
- <tp:requires interface="org.freedesktop.Telepathy.Call.Stream"/>
-
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- [FIXME]
- </tp:docstring>
-
- <tp:method name="SetCredentials" tp:name-for-bindings="Set_Credentials">
- <tp:docstring>
- Used to set the username fragment and password for streams that have
- global credentials.
-
- <tp:rationale>
- [FIXME: rationale?]
- </tp:rationale>
- </tp:docstring>
- <arg name="Username" type="s" direction="in"/>
- <arg name="Password" type="s" direction="in" />
- </tp:method>
-
- <tp:mapping name="Candidate_Info">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- Extra information about the candidate. Allowed and mandatory keys
- depend on the transport protocol used. The following keys are commenly
- used:
- <dl>
- <dt>Type (u)</dt>
- <dd>type of candidate (host, srflx, prflx, relay)</dd>
-
- <dt>Foundation (s)</dt>
- <dd>the foundation of this candiate</dd>
-
- <dt>Protocol (u) </dt>
- <dd>Underlying protocol of the candidate (udp, tcp) </dd>
-
- <dt>Priority (u) </dt>
- <dd>Priority of the candidate </dd>
-
- <dt>BaseIP (u) </dt>
- <dd>Base IP of this candidate </dd>
-
- <dt>Username (s) </dt>
- <dd>Username of this candidate
- (only if credentials are per candidate)</dd>
-
- <dt>Password (s) </dt>
- <dd>Password of this candidate
- (only if credentials are per candidate)</dd>
-
- <dt>RawUDPFallback (b) </dt>
- <dd>Indicate whether this candidate may be used to provide a UDP
- fallback</dd>
- </dl>
- </tp:docstring>
- <tp:member name="Key" type="s">
- <tp:docstring>One of the well-known keys documented here, or an
- implementation-specific key</tp:docstring>
- </tp:member>
- <tp:member name="Value" type="v">
- <tp:docstring>The value corresponding to that key</tp:docstring>
- </tp:member>
- </tp:mapping>
-
- <tp:struct name="Candidate" array-name="Candidate_List">
- <tp:docstring>A Stream Candidate</tp:docstring>
-
- <tp:member name="Component" type="u">
- <tp:docstring>The component number</tp:docstring>
- </tp:member>
- <tp:member name="IP" type="s">
- <tp:docstring>The IP address to use</tp:docstring>
- </tp:member>
- <tp:member name="Port" type="q">
- <tp:docstring>The port number to use</tp:docstring>
- </tp:member>
- <tp:member name="Info" type="a{sv}" tp:type="Candidate_Info">
- <tp:docstring>Additional information about the candidate</tp:docstring>
- </tp:member>
- </tp:struct>
-
- <method name="AddCandidates" tp:name-for-bindings="Add_Candidates">
- <tp:docstring>
- Add candidates to <tp:member-ref>LocalCandidates</tp:member-ref>
- and signal them to the remote contact(s).
- </tp:docstring>
-
- <arg name="candidates" direction="in"
- type="a(usqa{sv})" tp:type="Candidate[]">
- <tp:docstring>
- Candidates to be appended to
- <tp:member-ref>LocalCandidates</tp:member-ref>
- </tp:docstring>
- </arg>
- </method>
-
- <method name="CandidatesPrepared"
- tp:name-for-bindings="Candidates_Prepared">
- <tp:docstring>
- This indicates to the CM that the initial batch of candidates has been
- added.
-
- <tp:rationale>
- [FIXME: rationale]
- </tp:rationale>
- </tp:docstring>
- </method>
-
- <tp:enum type="u" name="Stream_Transport_Type">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- A transport that can be used for streaming.
- </tp:docstring>
-
- <tp:enumvalue suffix="Raw_UDP" value="0">
- <tp:docstring>
- Raw UDP, with or without STUN. All streaming clients are assumed to
- support this transport, so there is no handler capability token for
- it in the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel.Type"
- >Call.DRAFT</tp:dbus-ref> interface.
- [This corresponds to "none" or "stun" in the old Media.StreamHandler
- interface.]
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="ICE" value="1">
- <tp:docstring>
- Interactive Connectivity Establishment, as defined by the IETF MMUSIC
- working group.
- [FIXME: do we want this to cover both ICE-UDP and ICE-TCP, or split
- them?]
- [This corresponds to "ice-udp" in the old Media.StreamHandler
- interface.]
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="GTalk_P2P" value="2">
- <tp:docstring>
- Google Talk peer-to-peer connectivity establishment, as implemented
- by libjingle 0.3.
- [This corresponds to "gtalk-p2p" in the old Media.StreamHandler
- interface.]
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="WLM_8_5" value="3">
- <tp:docstring>
- The transport used by Windows Live Messenger 8.5 or later, which
- resembles ICE draft 6.
- [This corresponds to "wlm-8.5" in the old Media.StreamHandler
- interface.]
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="WLM_2009" value="4">
- <tp:docstring>
- The transport used by Windows Live Messenger 2009 or later, which
- resembles ICE draft 19.
- [This corresponds to "wlm-2009" in the old Media.StreamHandler
- interface.]
- </tp:docstring>
- </tp:enumvalue>
- </tp:enum>
-
- <property name="Transport" tp:name-for-bindings="Transport"
- type="u" tp:type="Stream_Transport_Type" access="read">
- <tp:docstring>
- The transport for this stream. This property is immutable.
- </tp:docstring>
- </property>
-
- <property name="LocalCandidates" tp:name-for-bindings="Local_Candidates"
- type="a(usqa{sv})" tp:type="Candidate[]" access="read">
- <tp:docstring>
- [FIXME]. Change notification is via
- <tp:member-ref>LocalCandidatesAdded</tp:member-ref>.
- </tp:docstring>
- </property>
-
- <signal name="LocalCandidatesAdded"
- tp:name-for-bindings="Local_Candidates_Added">
- <tp:docstring>
- Emitted when local candidates are added to
- <tp:member-ref>LocalCandidates</tp:member-ref>.
- </tp:docstring>
-
- <arg name="Candidates"
- type="a(usqa{sv})" tp:type="Candidate[]">
- <tp:docstring>
- Candidates that have been appended to
- <tp:member-ref>LocalCandidates</tp:member-ref>
- </tp:docstring>
- </arg>
- </signal>
-
- <tp:struct name="Stream_Credentials">
- <tp:docstring>A username/password pair.</tp:docstring>
-
- <tp:member name="Username" type="s">
- <tp:docstring>The username</tp:docstring>
- </tp:member>
-
- <tp:member name="Password" type="s">
- <tp:docstring>The password</tp:docstring>
- </tp:member>
- </tp:struct>
-
- <property name="LocalCredentials" tp:name-for-bindings="Local_Credentials"
- type="(ss)" tp:type="Stream_Credentials" access="read">
- <tp:docstring>
- [FIXME]. Change notification is via
- <tp:member-ref>LocalCredentialsSet</tp:member-ref>.
- </tp:docstring>
-
- </property>
-
- <signal name="LocalCredentialsSet"
- tp:name-for-bindings="Local_Credentials_Set">
- <tp:docstring>
- Emitted when the value of
- <tp:member-ref>LocalCredentials</tp:member-ref> changes.
- </tp:docstring>
-
- <arg name="Username" type="s" />
- <arg name="Password" type="s" />
- </signal>
-
- <property name="STUNServers" tp:name-for-bindings="STUN_Servers"
- type="a(sq)" tp:type="Socket_Address_IP[]" access="read">
- <tp:docstring>
- The IP addresses of possible STUN servers to use for NAT traversal, as
- dotted-quad IPv4 address literals or RFC2373 IPv6 address literals.
- This property cannot change once the stream has been created, so there
- is no change notification. The IP addresses MUST NOT be given as DNS
- hostnames.
-
- <tp:rationale>
- High-quality connection managers already need an asynchronous
- DNS resolver, so they might as well resolve this name to an IP
- to make life easier for streaming implementations.
- </tp:rationale>
- </tp:docstring>
- </property>
-
- <property name="RelayInfo" type="aa{sv}" access="read"
- tp:type="String_Variant_Map[]" tp:name-for-bindings="Relay_Info">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A list of mappings describing TURN or Google relay servers
- available for the client to use in its candidate gathering, as
- determined from the protocol. Map keys are:</p>
-
- <dl>
- <dt><code>ip</code> - s</dt>
- <dd>The IP address of the relay server as a dotted-quad IPv4
- address literal or an RFC2373 IPv6 address literal. This MUST NOT
- be a DNS hostname.
-
- <tp:rationale>
- High-quality connection managers already need an asynchronous
- DNS resolver, so they might as well resolve this name to an IP
- and make life easier for streaming implementations.
- </tp:rationale>
- </dd>
-
- <dt><code>type</code> - s</dt>
- <dd>
- <p>Either <code>udp</code> for UDP (UDP MUST be assumed if this
- key is omitted), <code>tcp</code> for TCP, or
- <code>tls</code>.</p>
-
- <p>The precise meaning of this key depends on the
- <tp:member-ref>Transport</tp:member-ref> property: if
- Transport is ICE, <code>tls</code> means
- TLS over TCP as referenced by ICE draft 19, and if
- Transport is GTalk_P2P, <code>tls</code> means
- a fake SSL session over TCP as implemented by libjingle.</p>
- </dd>
-
- <dt><code>port</code> - q</dt>
- <dd>The UDP or TCP port of the relay server as an ASCII unsigned
- integer</dd>
-
- <dt><code>username</code> - s</dt>
- <dd>The username to use</dd>
-
- <dt><code>password</code> - s</dt>
- <dd>The password to use</dd>
-
- <dt><code>component</code> - u</dt>
- <dd>The component number to use this relay server for, as an
- ASCII unsigned integer; if not included, this relay server
- may be used for any or all components.
-
- <tp:rationale>
- In ICE draft 6, as used by Google Talk, credentials are only
- valid once, so each component needs relaying separately.
- </tp:rationale>
- </dd>
- </dl>
-
- <tp:rationale>
- <p>An equivalent of the gtalk-p2p-relay-token property on
- MediaSignalling channels is not included here. The connection
- manager should be responsible for making the necessary HTTP
- requests to turn the token into a username and password.</p>
- </tp:rationale>
-
- <p>The type of relay server that this represents depends on
- the value of the <tp:member-ref>Transport</tp:member-ref>
- property. If Transport is ICE, this is a TURN server;
- if Transport is GTalk_P2P, this is a Google relay server;
- otherwise, the meaning of RelayInfo is undefined.</p>
-
- <p>If relaying is not possible for this stream, the list is empty.</p>
- </tp:docstring>
- </property>
-
- <signal name="ServerInfoRetrieved"
- tp:name-for-bindings="Server_Info_Retrieved">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Signals that the initial information about STUN and Relay servers
- has been retrieved, i.e. the
- <tp:member-ref>RetrievedServerInfo</tp:member-ref> property is now
- true.</p>
- </tp:docstring>
- </signal>
-
- <property name="RetrievedServerInfo" type="b"
- tp:name-for-bindings="Retrieved_Server_Info" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>True if the initial information about STUN servers and Relay servers
- has been retrieved. Change notification is via the
- <tp:member-ref>ServerInfoRetrieved</tp:member-ref> signal.</p>
-
- <tp:rationale>
- <p>Streaming implementations that can't cope with STUN and relay
- servers being added later SHOULD wait for this property
- to become true before proceeding.</p>
- </tp:rationale>
- </tp:docstring>
- </property>
-
- <signal name="EndpointsChanged"
- tp:name-for-bindings="Endpoints_Changed">
- <tp:docstring>
- Emitted when the <tp:member-ref>Endpoints</tp:member-ref> property
- changes.
- </tp:docstring>
-
- <arg name="EndpointsAdded" type="ao">
- <tp:docstring>
- Endpoints that were added.
- </tp:docstring>
- </arg>
-
- <arg name="EndpointsRemoved" type="ao">
- <tp:docstring>
- Endpoints that no longer exist.
- </tp:docstring>
- </arg>
- </signal>
-
- <property name="Endpoints" tp:name-for-bindings="Endpoints"
- type="ao" access="read">
- <p> The list of endpoints
- <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream"
- >Endpoint.DRAFT</tp:dbus-ref>
- that exist for this stream.
- </p>
-
- <p>Change notification is via the
- <tp:member-ref>EndpointsChanged</tp:member-ref> signal.</p>
- </property>
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Channel_Type_Call.xml b/extensions/Channel_Type_Call.xml
deleted file mode 100644
index 702eb175..00000000
--- a/extensions/Channel_Type_Call.xml
+++ /dev/null
@@ -1,931 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Channel_Type_Call" 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>
- 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.
-
-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.
-
-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.
- </tp:license>
- <interface name="org.freedesktop.Telepathy.Channel.Type.Call.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>A channel type for making audio and video calls.</p>
-
- <p>A Call channel can have one or more <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call">Content.DRAFT</tp:dbus-ref>
- objects, which represent the actual Media that forms the Call (e.g. an
- audio content and a video content).</p>
- </tp:docstring>
-
- <method name="Ringing" tp:name-for-bindings="Ringing">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Indicate that the local user has been alerted about the incoming
- call.</p>
-
- <p>This method is only useful if the channel's
- <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel"
- >Requested</tp:dbus-ref> property is false, and the
- <tp:member-ref>CallState</tp:member-ref> is
- Call_State_Pending_Initiator. While this is the case,
- this method SHOULD change the
- <tp:member-ref>CallFlags</tp:member-ref> to include
- Call_Flag_Ringing, and notify the remote contact that the local
- user has been alerted (if the protocol implements this); repeated
- calls to this method SHOULD succeed, but have no further effect.</p>
-
- <p>In all other states, this method SHOULD fail with the error
- NotAvailable.</p>
- </tp:docstring>
-
- <tp:possible-errors>
- <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
- <tp:docstring>
- The call was <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel"
- >Requested</tp:dbus-ref>, so ringing does not make sense.
- </tp:docstring>
- </tp:error>
- <tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
- <tp:docstring>
- The call is no longer in state Call_State_Pending_Initiator.
- </tp:docstring>
- </tp:error>
- </tp:possible-errors>
- </method>
-
- <method name="Accept" tp:name-for-bindings="Accept">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>For incoming calls in state Call_State_Pending_Receiver, accept the
- incoming call; this changes the
- <tp:member-ref>CallState</tp:member-ref> to Call_State_Accepted.</p>
-
- <p>For outgoing calls in state Call_State_Pending_Initiator, actually
- call the remote contact; this changes the
- <tp:member-ref>CallState</tp:member-ref> to
- Call_State_Pending_Receiver.</p>
-
- <p>Otherwise, this method SHOULD fail with the error NotAvailable.</p>
-
- <p>This method should be called exactly once per Call, by whatever
- client (user interface) is handling the channel.</p>
-
- <p>When this method is called, for each <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call"
- >Content.DRAFT</tp:dbus-ref> whose <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Content.DRAFT"
- >Disposition</tp:dbus-ref> is Call_Content_Disposition_Initial,
- any streams where the self-handle's sending state in <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.DRAFT"
- >Senders</tp:dbus-ref> is Sending_State_Pending_Send
- will be moved to Sending_State_Sending as if <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.DRAFT"
- >SetSending</tp:dbus-ref>(TRUE) had been called.</p>
- </tp:docstring>
-
- <tp:possible-errors>
- <tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
- <tp:docstring>
- The call is not in one of the states where this method makes sense.
- </tp:docstring>
- </tp:error>
- </tp:possible-errors>
- </method>
-
- <method name="Hangup" tp:name-for-bindings="Hangup">
- <tp:docstring>
- Request that the call is ended.
- </tp:docstring>
-
- <arg direction="in" name="Reason"
- type="u" tp:type="Call_State_Change_Reason">
- <tp:docstring>
- A generic hangup reason.
- </tp:docstring>
- </arg>
-
- <arg direction="in" name="Detailed_Hangup_Reason"
- type="s" tp:type="DBus_Error_Name">
- <tp:docstring>
- A more specific reason for the call hangup, if one is available, or
- an empty string otherwise.
- </tp:docstring>
- </arg>
-
- <arg direction="in" name="Message" type="s">
- <tp:docstring>
- A human-readable message to be sent to the remote contact(s).
-
- <tp:rationale>
- XMPP Jingle allows calls to be terminated with a human-readable
- message.
- </tp:rationale>
- </tp:docstring>
- </arg>
-
- <tp:possible-errors>
- <tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
- <tp:docstring>
- The call has already been ended.
- </tp:docstring>
- </tp:error>
- </tp:possible-errors>
- </method>
-
- <method name="AddContent" tp:name-for-bindings="Add_Content">
- <tp:docstring>
- [FIXME]
- </tp:docstring>
- <arg direction="in" name="Content_Name" type="s">
- <tp:docstring>
- The suggested name of the content to add
-
- <tp:rationale>
- [FIXME: rationale]
- </tp:rationale>
- </tp:docstring>
- </arg>
- <arg direction="in" name="Content_Type" type="u"
- tp:type="Media_Stream_Type">
- <tp:docstring>
- The media type of the content to add
- </tp:docstring>
- </arg>
- <arg direction="out" name="Content" type="o">
- <tp:docstring>
- Path to the newly-created <tp:dbus-ref
- namespace="org.freedesktop.Telepathy"
- >Call.Content.DRAFT</tp:dbus-ref> object.
- </tp:docstring>
- </arg>
-
- <tp:possible-errors>
- <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
- <tp:docstring>
- [FIXME: when?]
- </tp:docstring>
- </tp:error>
- <tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
- <tp:docstring>
- [FIXME: when?]
- </tp:docstring>
- </tp:error>
- </tp:possible-errors>
- </method>
-
- <signal name="ContentAdded"
- tp:name-for-bindings="Content_Added">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Emitted when a new <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call"
- >Content.DRAFT</tp:dbus-ref> is added to the call.</p>
- </tp:docstring>
- <arg name="Content" type="o">
- <tp:docstring>
- Path to the newly-created <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call"
- >Content.DRAFT</tp:dbus-ref> object.
- </tp:docstring>
- </arg>
- <arg name="Content_Type" type="u" tp:type="Media_Stream_Type">
- <tp:docstring>
- The media type of the content which was added
- </tp:docstring>
- </arg>
- </signal>
-
- <signal name="ContentRemoved" tp:name-for-bindings="Content_Removed">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Emitted when a <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call"
- >Content.DRAFT</tp:dbus-ref> is removed from the call.</p>
- </tp:docstring>
- <arg name="Content" type="o">
- <tp:docstring>
- The <tp:dbus-ref namespace="org.freedesktop.Telepathy.Call"
- >Content.DRAFT</tp:dbus-ref> which was removed.
- </tp:docstring>
- </arg>
- </signal>
-
- <property name="Contents" type="ao" access="read"
- tp:name-for-bindings="Contents">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The list of
- <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call">Content.DRAFT</tp:dbus-ref>
- objects that are part of this call. Change notification
- is via the <tp:member-ref>ContentAdded</tp:member-ref> and
- <tp:member-ref>ContentRemoved</tp:member-ref> signals.
- </p>
- </tp:docstring>
- </property>
-
- <tp:enum type="u" name="Call_State">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The state of a call, as a whole.</p>
-
- <p>The allowed transitions are:</p>
-
- <ul>
- <li>Pending_Initiator → Pending_Receiver (for outgoing calls,
- when <tp:member-ref>Accept</tp:member-ref> is called)</li>
- <li>Pending_Receiver → Accepted (for incoming calls, when
- <tp:member-ref>Accept</tp:member-ref> is called; for outgoing
- calls to a contact, when the remote contact accepts the call;
- for joining a conference call, when the local user successfully
- joins the conference)</li>
- <li>Accepted → Pending_Receiver (when transferred to another
- contact)</li>
- <li>any state → Ended (when the call is terminated normally, or
- when an error occurs)</li>
- </ul>
-
- <p>Clients MAY consider unknown values from this enum to be an
- error - additional values will not be defined after the Call
- specification is declared to be stable.</p>
- </tp:docstring>
-
- <tp:enumvalue suffix="Unknown" value = "0">
- <tp:docstring>
- The call state is not known. This call state MUST NOT appear as a
- value of the <tp:member-ref>CallState</tp:member-ref> property, but
- MAY be used by client code to represent calls whose state is as yet
- unknown.
- </tp:docstring>
- </tp:enumvalue>
- <tp:enumvalue suffix="Pending_Initiator" value = "1">
- <tp:docstring>
- The initiator of the call hasn't accepted the call yet. This state
- only makes sense for outgoing calls, where it means that the local
- user has not yet sent any signalling messages to the remote user(s),
- and will not do so until <tp:member-ref>Accept</tp:member-ref> is
- called.
- </tp:docstring>
- </tp:enumvalue>
- <tp:enumvalue suffix="Pending_Receiver" value = "2">
- <tp:docstring>
- The receiver (the contact being called) hasn't accepted the call yet.
- </tp:docstring>
- </tp:enumvalue>
- <tp:enumvalue suffix="Accepted" value = "3">
- <tp:docstring>
- The contact being called has accepted the call.
- </tp:docstring>
- </tp:enumvalue>
- <tp:enumvalue suffix="Ended" value = "4">
- <tp:docstring>
- The call has ended, either via normal termination or an error.
- </tp:docstring>
- </tp:enumvalue>
- </tp:enum>
-
- <tp:flags name="Call_Flags" value-prefix="Call_Flag" type="u">
- <tp:docstring>
- A set of flags representing the status of the call as a whole,
- providing more specific information than the
- <tp:member-ref>CallState</tp:member-ref>. Many of these flags only make
- sense in a particular state.
- </tp:docstring>
-
- <tp:flag suffix="Locally_Ringing" value="1">
- <tp:docstring>
- The local contact has been alerted about the call but has not
- responded; if possible, the remote contact(s) have been informed of
- this fact. This flag only makes sense on incoming calls in
- state Call_State_Pending_Receiver. It SHOULD be set when
- <tp:member-ref>Ringing</tp:member-ref> is called successfully, and
- unset when the state changes.
- </tp:docstring>
- </tp:flag>
-
- <tp:flag suffix="Queued" value="2">
- <tp:docstring>
- The contact is temporarily unavailable, and the call has been placed
- in a queue (e.g. 182 Queued in SIP, or call-waiting in telephony).
- This flag only makes sense on outgoing 1-1 calls in
- state Call_State_Pending_Receiver. It SHOULD be set or unset
- according to informational messages from other contacts.
- </tp:docstring>
- </tp:flag>
-
- <tp:flag suffix="Locally_Held" value="4">
- <tp:docstring>
- The call has been put on hold by the local user, e.g. using the
- <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Interface"
- >Hold</tp:dbus-ref> interface. This flag SHOULD only be set if
- there is at least one Content, and all Contents are locally held;
- it makes sense on calls in state Call_State_Pending_Receiver or
- Call_State_Accepted.
-
- <tp:rationale>
- Otherwise, in transient situations where some but not all contents
- are on hold, UIs would falsely indicate that the call as a whole
- is on hold, which could lead to the user saying something they'll
- regret, while under the impression that the other contacts can't
- hear them!
- </tp:rationale>
- </tp:docstring>
- </tp:flag>
-
- <tp:flag suffix="Forwarded" value="8">
- <tp:docstring>
- The initiator of the call originally called a contact other than the
- current recipient of the call, but the call was then forwarded or
- diverted. This flag only makes sense on outgoing calls, in state
- Call_State_Pending_Receiver or Call_State_Accepted. It SHOULD be
- set or unset according to informational messages from other contacts.
- </tp:docstring>
- </tp:flag>
-
- <tp:flag suffix="In_Progress" value="16">
- <tp:docstring>
- Progress has been made in placing the outgoing call, but the
- contact may not have been made aware of the call yet
- (so the Ringing state is not appropriate). This corresponds to SIP's
- status code 183 Session Progress, and could be used when the
- outgoing call has reached a gateway, for instance.
- This flag only makes sense on outgoing calls in state
- Call_State_Pending_Receiver, and SHOULD be set or unset according to
- informational messages from servers, gateways and other
- infrastructure.
- </tp:docstring>
- </tp:flag>
-
- <tp:flag suffix="Clearing" value="32">
- <tp:docstring>
- This flag only occurs when the CallState is Ended. The call with
- this flag set has ended, but not all resources corresponding to the
- call have been freed yet.
-
- Depending on the protocol there might be some audible feedback while
- the clearing flag is set.
-
- <tp:rationale>
- In calls following the ITU-T Q.931 standard there is a period of
- time between the call ending and the underlying channel being
- completely free for re-use.
- </tp:rationale>
- </tp:docstring>
- </tp:flag>
- </tp:flags>
-
- <property name="CallStateDetails"
- tp:name-for-bindings="Call_State_Details" type="a{sv}" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A map used to provide optional extensible details for the
- <tp:member-ref>CallState</tp:member-ref>,
- <tp:member-ref>CallFlags</tp:member-ref> and/or
- <tp:member-ref>CallStateReason</tp:member-ref>.</p>
-
- <p>Well-known keys and their corresponding value types include:</p>
-
- <dl>
- <dt>hangup-message - s</dt>
- <dd>An optional human-readable message sent when the call was ended,
- corresponding to the Message argument to the
- <tp:member-ref>Hangup</tp:member-ref> method. This is only
- applicable when the call state is Call_State_Ended.
- <tp:rationale>
- XMPP Jingle can send such messages.
- </tp:rationale>
- </dd>
-
- <dt>queue-message - s</dt>
- <dd>An optional human-readable message sent when the local contact
- is being held in a queue. This is only applicable when
- Call_Flag_Queued is in the call flags.
- <tp:rationale>
- SIP 182 notifications can have human-readable messages attached.
- </tp:rationale>
- </dd>
-
- <dt>debug-message - s</dt>
- <dd>A message giving further details of any error indicated by the
- <tp:member-ref>CallStateReason</tp:member-ref>. This will not
- normally be localized or suitable for display to users, and is only
- applicable when the call state is Call_State_Ended.</dd>
- </dl>
- </tp:docstring>
- </property>
-
- <property name="CallState" type="u" access="read"
- tp:name-for-bindings="Call_State" tp:type="Call_State">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The current high-level state of this call. The
- <tp:member-ref>CallFlags</tp:member-ref> provide additional
- information, and the <tp:member-ref>CallStateReason</tp:member-ref>
- and <tp:member-ref>CallStateDetails</tp:member-ref> explain the
- reason for the current values for those properties.</p>
-
- <p>Clients MAY consider unknown values in this property to be an
- error.</p>
- </tp:docstring>
- </property>
-
- <property name="CallFlags" type="u" access="read"
- tp:name-for-bindings="Call_Flags" tp:type="Call_Flags">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Flags representing the status of the call as a whole,
- providing more specific information than the
- <tp:member-ref>CallState</tp:member-ref>.</p>
-
- <p>Clients are expected to ignore unknown flags in this property,
- without error.</p>
- </tp:docstring>
- </property>
-
- <tp:enum name="Call_State_Change_Reason" type="u">
- <tp:docstring>
- A simple representation of the reason for a change in the call's
- state, which may be used by simple clients, or used as a fallback
- when the DBus_Reason member of a <tp:type>Call_State_Reason</tp:type>
- struct is not understood.
- </tp:docstring>
-
- <tp:enumvalue suffix="Unknown" value="0">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- We just don't know. Unknown values of this enum SHOULD also be
- treated like this.
- </tp:docstring>
- </tp:enumvalue>
-
- <tp:enumvalue suffix="User_Requested" value="1">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The change was requested by the contact indicated by the Actor
- member of a <tp:type>Call_State_Reason</tp:type> struct.</p>
-
- <p>If the Actor is the local user, the DBus_Reason SHOULD be the
- empty string.</p>
-
- <p>If the Actor is a remote user, the DBus_Reason SHOULD be the empty
- string if the call was terminated normally, but MAY be a non-empty
- error name to indicate error-like call termination reasons (call
- rejected as busy, kicked from a conference by a moderator, etc.).</p>
- </tp:docstring>
- </tp:enumvalue>
- </tp:enum>
-
- <tp:struct name="Call_State_Reason">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A description of the reason for a change to the
- <tp:member-ref>CallState</tp:member-ref> and/or
- <tp:member-ref>CallFlags</tp:member-ref>.</p>
- </tp:docstring>
-
- <tp:member type="u" tp:type="Contact_Handle" name="Actor">
- <tp:docstring>
- The contact responsible for the change, or 0 if no contact was
- responsible.
- </tp:docstring>
- </tp:member>
-
- <tp:member type="u" tp:type="Call_State_Change_Reason" name="Reason">
- <tp:docstring>
- The reason, chosen from a limited set of possibilities defined by
- the Telepathy specification.
- </tp:docstring>
- </tp:member>
-
- <tp:member type="s" tp:type="DBus_Error_Name" name="DBus_Reason">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A specific reason for the change, which may be a D-Bus error in
- the Telepathy namespace, a D-Bus error in any other namespace
- (for implementation-specific errors), or the empty string to
- indicate that the state change was not an error.</p>
-
- <p>This SHOULD be an empty string for changes to any state other
- than Ended.</p>
-
- <p>The errors Cancelled and Terminated SHOULD NOT be used here;
- an empty string SHOULD be used instead.</p>
-
- <tp:rationale>
- <p>Those error names are used to indicate normal call
- termination by the local user or another user, respectively,
- in contexts where a D-Bus error name must appear.</p>
- </tp:rationale>
- </tp:docstring>
- </tp:member>
- </tp:struct>
-
- <property name="CallStateReason" tp:name-for-bindings="Call_State_Reason"
- type="(uus)" access="read" tp:type="Call_State_Reason">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The reason for the last change to the
- <tp:member-ref>CallState</tp:member-ref> and/or
- <tp:member-ref>CallFlags</tp:member-ref>. The
- <tp:member-ref>CallStateDetails</tp:member-ref> MAY provide additional
- information.</p>
- </tp:docstring>
- </property>
-
- <signal name="CallStateChanged"
- tp:name-for-bindings="Call_State_Changed">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Emitted when the state of the call as a whole changes.</p>
-
- <p>This signal is emitted for any change in the properties
- corresponding to its arguments, even if the other properties
- referenced remain unchanged.</p>
- </tp:docstring>
-
- <arg name="Call_State" type="u" tp:type="Call_State">
- <tp:docstring>
- The new value of the <tp:member-ref>CallState</tp:member-ref>
- property.
- </tp:docstring>
- </arg>
-
- <arg name="Call_Flags" type="u" tp:type="Call_Flags">
- <tp:docstring>
- The new value of the <tp:member-ref>CallFlags</tp:member-ref>
- property.
- </tp:docstring>
- </arg>
-
- <arg name="Call_State_Reason" type="(uus)">
- <tp:docstring>
- The new value of the <tp:member-ref>CallStateReason</tp:member-ref>
- property.
- </tp:docstring>
- </arg>
-
- <arg name="Call_State_Details" type="a{sv}">
- <tp:docstring>
- The new value of the <tp:member-ref>CallStateDetails</tp:member-ref>
- property.
- </tp:docstring>
- </arg>
- </signal>
-
- <property name="HardwareStreaming" tp:name-for-bindings="Hardware_Streaming"
- type="b" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>If this property is TRUE, all of the media streaming is done by some
- mechanism outside the scope of Telepathy.</p>
-
- <tp:rationale>
- <p>A connection manager might be intended for a specialized hardware
- device, which will take care of the audio streaming (e.g.
- telepathy-yafono, which uses GSM hardware which does the actual
- audio streaming for the call).</p>
- </tp:rationale>
-
- <p>If this is FALSE, the handler is responsible for doing the actual
- media streaming for at least some contents itself. Those contents
- will have the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Content.Interface"
- >Media.DRAFT</tp:dbus-ref> interface, to communicate the necessary
- information to a streaming implementation. Connection managers SHOULD
- operate like this, if possible.</p>
-
- <tp:rationale>
- <p>Many connection managers (such as telepathy-gabble) only do the
- call signalling, and expect the client to do the actual streaming
- using something like
- <a href="http://farsight.freedesktop.org/">Farsight</a>, to improve
- latency and allow better UI integration.</p>
- </tp:rationale>
- </tp:docstring>
- </property>
-
- <tp:flags type="u" name="Call_Member_Flags" value-prefix="Call_Member_Flag">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A set of flags representing the status of a remote contact in a
- call.</p>
-
- <p>It is protocol- and client-specific whether a particular contact
- will ever have a particular flag set on them, and Telepathy clients
- SHOULD NOT assume that a flag will ever be set.</p>
-
- <tp:rationale>
- <p>180 Ringing in SIP, and its equivalent in XMPP, are optional
- informational messages, and implementations are not required
- to send them. The same applies to the messages used to indicate
- hold state.</p>
- </tp:rationale>
- </tp:docstring>
-
- <tp:flag suffix="Ringing" value = "1">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The remote contact's client has told us that the contact has been
- alerted about the call but has not responded.</p>
-
- <tp:rationale>
- <p>This is a flag per member, not a flag for the call as a whole,
- because in Muji conference calls, you could invite someone and
- have their state be "ringing" for a while.</p>
- </tp:rationale>
- </tp:docstring>
- </tp:flag>
-
- <tp:flag suffix="Held" value = "2">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The call member has put this call on hold.</p>
-
- <tp:rationale>
- <p>This is a flag per member, not a flag for the call as a whole,
- because in conference calls, any member could put the conference
- on hold.</p>
- </tp:rationale>
- </tp:docstring>
- </tp:flag>
- </tp:flags>
-
- <tp:mapping name="Call_Member_Map" array-name="Call_Member_Map_List">
- <tp:docstring>A mapping from handles to their current state in the call.
- </tp:docstring>
- <tp:member type="u" tp:type="Handle" name="key"/>
- <tp:member type="u" tp:type="Call_Member_Flags" name="Flag"/>
- </tp:mapping>
-
- <signal name="CallMembersChanged"
- tp:name-for-bindings="Call_Members_Changed">
- <tp:docstring>
- Emitted when the <tp:member-ref>CallMembers</tp:member-ref> property
- changes in any way, either because contacts have been added to the
- call, contacts have been removed from the call, or contacts' flags
- have changed.
- </tp:docstring>
-
- <arg name="Flags_Changed" type="a{uu}" tp:type="Call_Member_Map">
- <tp:docstring>
- A map from members of the call to their new call member flags,
- including at least the members who have been added to
- <tp:member-ref>CallMembers</tp:member-ref>, and the members whose
- flags have changed.
- </tp:docstring>
- </arg>
- <arg name="Removed" type="au" tp:type="Contact_Handle[]">
- <tp:docstring>
- A list of members who have left the call, i.e. keys to be removed
- from <tp:member-ref>CallMembers</tp:member-ref>.
- </tp:docstring>
- </arg>
- </signal>
-
- <property name="CallMembers" tp:name-for-bindings="Call_Members"
- type="a{uu}" access="read" tp:type="Call_Member_Map">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- A mapping from the remote contacts that are part of this call to flags
- discribing their status. This mapping never has the local user's handle
- as a key.
- </tp:docstring>
- </property>
-
- <property name="InitialTransport" tp:name-for-bindings="Initial_Transport"
- type="s" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>
- If set on a requested channel this indicates the transport that
- should be used for this call.
- <tp:rationale>
- When implementing a voip gateway one wants the outgoing leg of the
- gatewayed to have the same transport as the incoming leg. This
- property allows the gateway to request a Call with the right
- transport from the CM.
- </tp:rationale>
- </p>
- </tp:docstring>
- </property>
-
- <property name="InitialAudio" tp:name-for-bindings="Initial_Audio"
- type="b" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>If set to true in a channel request that will create a new channel,
- the connection manager should immediately attempt to establish an
- audio stream to the remote contact, making it unnecessary for the
- client to call
- <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel.Type.Call.DRAFT">AddContent</tp:dbus-ref>.
- </p>
-
- <p>If this property, or InitialVideo, is passed to EnsureChannel
- (as opposed to CreateChannel), the connection manager SHOULD ignore
- these properties when checking whether it can return an existing
- channel as suitable; these properties only become significant when
- the connection manager has decided to create a new channel.</p>
-
- <p>If true on a requested channel, this indicates that the audio
- stream has already been requested and the client does not need to
- call RequestStreams, although it MAY still do so.</p>
-
- <p>If true on an unrequested (incoming) channel, this indicates that
- the remote contact initially requested an audio stream; this does
- not imply that that audio stream is still active (as indicated by
- <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel.Type.Call.DRAFT">Contents</tp:dbus-ref>).</p>
-
- <p>This property is immutable (cannot change), and therefore SHOULD
- appear wherever immutable properties are reported, e.g. <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">NewChannels</tp:dbus-ref>
- signals.</p>
-
- <tp:rationale><p>This reduces D-Bus round trips.</p></tp:rationale>
-
- <p>Connection managers capable of signalling audio calls to contacts
- SHOULD include a channel class in <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">RequestableChannelClasses</tp:dbus-ref>
- with <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel">ChannelType</tp:dbus-ref>
- <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel.Type">Call.DRAFT</tp:dbus-ref>
- and <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Channel">TargetHandleType</tp:dbus-ref>
- = Contact in the fixed properties dictionary, and InitialAudio
- (and also InitialVideo, if applicable) in the allowed properties
- list. Clients wishing to discover whether a connection manager
- can signal audio and/or video calls SHOULD use this information.</p>
-
- <tp:rationale>
- <p>Not all protocols support signalling video calls, and it would be
- possible (although unlikely) to have a protocol where only video,
- and not audio, could be signalled.</p>
- </tp:rationale>
-
- <p>Connection managers that support the <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Connection.Interface">ContactCapabilities</tp:dbus-ref>
- interface SHOULD represent the capabilities of receiving audio
- and/or video calls by including a channel class in
- a contact's capabilities with ChannelType = Call
- in the fixed properties dictionary, and InitialAudio and/or
- InitialVideo in the allowed properties list. Clients wishing to
- discover whether a particular contact is likely to be able to
- receive audio and/or video calls SHOULD use this information.</p>
-
- <tp:rationale>
- <p>Not all clients support video calls, and it would also be
- possible (although unlikely) to have a client which could only
- stream video, not audio.</p>
- </tp:rationale>
-
- <p>Clients that are willing to receive audio and/or video calls
- SHOULD include the following among their channel classes if
- calling <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities">UpdateCapabilities</tp:dbus-ref>
- (clients of a <tp:dbus-ref
- namespace="org.freedesktop.Telepathy">ChannelDispatcher</tp:dbus-ref>
- SHOULD instead arrange for the ChannelDispatcher to do this,
- by including the filters in their <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Client.Handler">HandlerChannelFilter</tp:dbus-ref>
- properties):</p>
-
- <ul>
- <li>{ ChannelType = Call }</li>
- <li>{ ChannelType = Call, InitialAudio = true }
- if receiving calls with audio is supported</li>
- <li>{ ChannelType = Call, InitialVideo = true }
- if receiving calls with video is supported</li>
- </ul>
-
- <tp:rationale>
- <p>Connection managers for protocols with capability discovery,
- like XMPP, need this information to advertise the appropriate
- capabilities for their protocol.</p>
- </tp:rationale>
- </tp:docstring>
- </property>
-
- <property name="InitialVideo" tp:name-for-bindings="Initial_Video"
- type="b" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The same as <tp:member-ref>InitialAudio</tp:member-ref>, but for
- a video stream. This property is immutable (cannot change).</p>
-
- <p>In particular, note that if this property is false, this does not
- imply that an active video stream has not been added, only that no
- video stream was active at the time the channel appeared.</p>
-
- <p>This property is the correct way to discover whether connection
- managers, contacts etc. support video calls; it appears in
- capabilities structures in the same way as InitialAudio.</p>
- </tp:docstring>
- </property>
-
- <property name="MutableContents" tp:name-for-bindings="Mutable_Contents"
- type="b" access="read">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>If <tt>True</tt>, a stream of a different content type can be added
- after the Channel has been requested </p>
-
- <p>If this property is missing, clients SHOULD assume that it is false,
- and thus that the channel's streams cannot be changed once the call
- has started.</p>
-
- <p>If this property isn't present in the "allowed" set in any of the
- Call entries contact capabilities, then user interfaces MAY choose to
- show a separate "call" option for each class of call.</p>
-
- <tp:rationale>
- <p>For example, once an audio-only Google Talk call has started,
- it is not possible to add a video stream; both audio and video
- must be requested at the start of the call if video is desired.
- User interfaces may use this pseudo-capability as a hint to
- display separate "Audio call" and "Video call" buttons, rather
- than a single "Call" button with the option to add and remove
- video once the call has started for contacts without this flag.
- </p>
- </tp:rationale>
-
- <p>This property is immutable, and therefore SHOULD be announced
- in <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Connection.Interface.Requests">NewChannels</tp:dbus-ref>,
- etc.</p>
- </tp:docstring>
- </property>
-
- <tp:handler-capability-token name="gtalk-p2p">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The client can implement streaming for streams whose <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.Interface.Media.DRAFT">Transport</tp:dbus-ref>
- property is Stream_Transport_Type_GTalk_P2P.</p>
- </tp:docstring>
- </tp:handler-capability-token>
-
- <tp:handler-capability-token name="ice">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The client can implement streaming for streams whose <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.Interface.Media.DRAFT">Transport</tp:dbus-ref>
- property is Stream_Transport_Type_ICE.</p>
- </tp:docstring>
- </tp:handler-capability-token>
-
- <tp:handler-capability-token name="wlm-8.5">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The client can implement streaming for streams whose <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.Interface.Media.DRAFT">Transport</tp:dbus-ref>
- property is Stream_Transport_Type_WLM_8_5.</p>
- </tp:docstring>
- </tp:handler-capability-token>
-
- <tp:handler-capability-token name="wlm-2009">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>The client can implement streaming for streams whose <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Call.Stream.Interface.Media.DRAFT">Transport</tp:dbus-ref>
- property is Stream_Transport_Type_WLM_2009.</p>
- </tp:docstring>
- </tp:handler-capability-token>
-
- <tp:handler-capability-token name="video/h264" is-family="yes">
- <tp:docstring>
- <p>The client supports media streaming with H264 (etc.).</p>
-
- <p>This handler capability token is a one of a family
- of similar tokens: for any other audio or video codec whose MIME
- type is audio/<em>subtype</em> or video/<em>subtype</em>, a handler
- capability token of this form may exist (the subtype MUST appear
- in lower case in this context). Clients MAY support more
- codecs than they explicitly advertise support for; clients SHOULD
- explicitly advertise support for their preferred codec(s), and
- for codecs like H264 that are, in practice, significant in codec
- negotiation.</p>
-
- <tp:rationale>
- <p>For instance, the XMPP capability used by the Google Video
- Chat web client to determine whether a client is compatible
- with it requires support for H264 video, so an XMPP
- connection manager that supports this version of Jingle should
- not advertise the Google Video Chat capability unless there
- is at least one installed client that declares that it supports
- <code>video/h264</code> on Call channels.</p>
- </tp:rationale>
-
- <p>For example, a client could advertise support for
- Speex, Theora and H264 by having three
- handler capability tokens,
- <code>org.freedesktop.Telepathy.Channel.Type.Call.DRAFT/audio/speex</code>,
- <code>org.freedesktop.Telepathy.Channel.Type.Call.DRAFT/video/theora</code> and
- <code>org.freedesktop.Telepathy.Channel.Type.Call.DRAFT/video/h264</code>,
- in its <tp:dbus-ref
- namespace="org.freedesktop.Telepathy.Client.Handler">Capabilities</tp:dbus-ref>
- property.</p>
-
- <p>Clients MAY have media signalling abilities without explicitly
- supporting any particular codec, and connection managers SHOULD
- support this usage.</p>
-
- <tp:rationale>
- <p>This is necessary to support gatewaying between two Telepathy
- connections, in which case the available codecs might not be
- known to the gatewaying process.</p>
- </tp:rationale>
- </tp:docstring>
- </tp:handler-capability-token>
-
- </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/call-content.xml b/extensions/call-content.xml
index cfb10003..b9b02af4 100644
--- a/extensions/call-content.xml
+++ b/extensions/call-content.xml
@@ -4,7 +4,7 @@
<tp:title>Call Content</tp:title>
-<xi:include href="Call_Content.xml"/>
-<xi:include href="Call_Content_Interface_Media.xml"/>
+<xi:include href="../spec/Call_Content.xml"/>
+<xi:include href="../spec/Call_Content_Interface_Media.xml"/>
</tp:spec>
diff --git a/extensions/call-stream.xml b/extensions/call-stream.xml
index 3e85b379..0f4dbf30 100644
--- a/extensions/call-stream.xml
+++ b/extensions/call-stream.xml
@@ -4,7 +4,7 @@
<tp:title>Call Stream</tp:title>
-<xi:include href="Call_Stream.xml"/>
-<xi:include href="Call_Stream_Interface_Media.xml"/>
+<xi:include href="../spec/Call_Stream.xml"/>
+<xi:include href="../spec/Call_Stream_Interface_Media.xml"/>
</tp:spec>
diff --git a/extensions/channel.xml b/extensions/channel.xml
index b4e0a469..e10326ec 100644
--- a/extensions/channel.xml
+++ b/extensions/channel.xml
@@ -4,6 +4,6 @@
<tp:title>Channel extensions from the future</tp:title>
-<xi:include href="Channel_Type_Call.xml"/>
+<xi:include href="../spec/Channel_Type_Call.xml"/>
</tp:spec>
diff --git a/extensions/misc.xml b/extensions/misc.xml
index 0384410f..af9d1c65 100644
--- a/extensions/misc.xml
+++ b/extensions/misc.xml
@@ -4,7 +4,7 @@
<tp:title>Miscellaneous extensions from the future</tp:title>
-<xi:include href="Call_Content_Codec_Offer.xml"/>
-<xi:include href="Call_Stream_Endpoint.xml"/>
+<xi:include href="../spec/Call_Content_Codec_Offer.xml"/>
+<xi:include href="../spec/Call_Stream_Endpoint.xml"/>
</tp:spec>