summaryrefslogtreecommitdiff
path: root/spec/Channel_Type_Streamed_Media.xml
diff options
context:
space:
mode:
authorSenko Rasic <senko.rasic@collabora.co.uk>2007-08-28 12:14:20 +0000
committerSenko Rasic <senko.rasic@collabora.co.uk>2007-08-28 12:14:20 +0000
commitc0b47755be282324c270f17019aa3f9fc2a3d485 (patch)
tree401de3ce861231307bce0d72e64c89496fbbef6a /spec/Channel_Type_Streamed_Media.xml
parent2257b14caf13d0f205c1219bb7d774d1f5195a8d (diff)
downloadtelepathy-glib-c0b47755be282324c270f17019aa3f9fc2a3d485.tar.gz
updated to spec version 0.15.5.1
20070828121420-01440-01fdc9a5eee520495896bca8ede7cdbba03a1404.gz
Diffstat (limited to 'spec/Channel_Type_Streamed_Media.xml')
-rw-r--r--spec/Channel_Type_Streamed_Media.xml17
1 files changed, 16 insertions, 1 deletions
diff --git a/spec/Channel_Type_Streamed_Media.xml b/spec/Channel_Type_Streamed_Media.xml
index 8cfe07154..733943975 100644
--- a/spec/Channel_Type_Streamed_Media.xml
+++ b/spec/Channel_Type_Streamed_Media.xml
@@ -20,6 +20,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:license>
<interface name="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">
<tp:requires interface="org.freedesktop.Telepathy.Channel"/>
+ <tp:requires interface="org.freedesktop.Telepathy.Channel.Interface.Group"/>
<tp:enum name="Media_Stream_Type" type="u">
<tp:enumvalue suffix="Audio" value="0">
<tp:docstring>An audio stream</tp:docstring>
@@ -283,7 +284,21 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
signals to indicate when streams have been added, removed and changed
status.</p>
- <p>In general this should always be used in conjunction with the IceSignalling
+ <p>Channels of this type are expected to provide the Group interface
+ and be "anonymous" (have no associated handle). To make a media call
+ to a contact, clients should request a new, empty streamed media
+ channel, then call AddMembers to add the contact to the channel.
+ The local user should be in the group's members, while the contact
+ should be in "remote pending" until the call is accepted, then
+ move to the group's members.</p>
+
+ <p>Similarly, incoming calls should be signalled as having handle type 0
+ and handle 0. The remote contact should be in the group's members,
+ with the local user in the "local pending" members; to accept the
+ call, AddMembers can be used to move the local user to the
+ group's members.</p>
+
+ <p>In general this should be used in conjunction with the MediaSignalling
interface to exchange connection candidates and codec choices with
whichever component is responsible for the streams. However, in certain
applications where no candidate exchange is necessary (eg the streams are