From eece71434e4472b037be86f79a661b9577f45d2f Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Fri, 29 Oct 2010 17:20:46 +0100 Subject: Update to spec 0.21.4 * add NewActiveTransportPair * fix the namespace of MailNotification --- spec/Call_Content.xml | 9 +++++ spec/Call_Content_Interface_Media.xml | 9 ++++- spec/Channel_Type_Call.xml | 13 ++++--- spec/Connection.xml | 2 +- spec/Connection_Interface_Mail_Notification.xml | 2 +- spec/Media_Stream_Handler.xml | 47 +++++++++++++++++++++++++ spec/all.xml | 2 +- 7 files changed, 75 insertions(+), 9 deletions(-) (limited to 'spec') diff --git a/spec/Call_Content.xml b/spec/Call_Content.xml index 82d40443e..17ed71095 100644 --- a/spec/Call_Content.xml +++ b/spec/Call_Content.xml @@ -116,6 +116,15 @@ + + +

Emitted when the content is removed from the call. This + is the same as the Call.DRAFT.ContentRemoved + signal.

+ + + diff --git a/spec/Call_Content_Interface_Media.xml b/spec/Call_Content_Interface_Media.xml index 0552111a6..24811fd62 100644 --- a/spec/Call_Content_Interface_Media.xml +++ b/spec/Call_Content_Interface_Media.xml @@ -27,7 +27,14 @@

Interface to use by a software implementation of media - streaming.

+ streaming. The reason behind splitting the members of this + interface out from the main Content.DRAFT interface is + that the software is not necessarily what controls the + media. An example of this is in GSM phones, where the CM just + tells the phone to dial a number and it does the audio routing + in a device specific hardware way and the CM does not need + to concern itself with codecs.

On new Call.DRAFT channels, diff --git a/spec/Channel_Type_Call.xml b/spec/Channel_Type_Call.xml index eb1a66358..a45d95622 100644 --- a/spec/Channel_Type_Call.xml +++ b/spec/Channel_Type_Call.xml @@ -52,11 +52,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Contents

-

Content.DRAFT objects - represent the actual media that forms the Call (for example an - audio content and a video content). Calls always have one or - more Content objects associated with them.

+

Content.DRAFT + objects represent the actual media that forms the Call (for + example an audio content and a video content). Calls always + have one or more Content objects associated with them. As a + result, a new Call channel request MUST have either + InitialAudio=True, or + InitialVideo=True, or both, + as the Requestable Channel Classes will document.

Content.DRAFT objects have diff --git a/spec/Connection.xml b/spec/Connection.xml index fb8cd228e..a694e2429 100644 --- a/spec/Connection.xml +++ b/spec/Connection.xml @@ -1102,7 +1102,7 @@ USA.

the Google XMPP Mail Notification extension, which can be used to implement MailNotification.DRAFT. In this protocol, the CM + >MailNotification. In this protocol, the CM receives a notification that something has changed, but to get more information, the CM must request this information. Knowing that nobody is currently interested in this information, the CM diff --git a/spec/Connection_Interface_Mail_Notification.xml b/spec/Connection_Interface_Mail_Notification.xml index 003e255c1..1ac6d1a67 100644 --- a/spec/Connection_Interface_Mail_Notification.xml +++ b/spec/Connection_Interface_Mail_Notification.xml @@ -19,7 +19,7 @@ License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

+ name="org.freedesktop.Telepathy.Connection.Interface.MailNotification"> (as stable API) diff --git a/spec/Media_Stream_Handler.xml b/spec/Media_Stream_Handler.xml index 8881c115b..123ea8be7 100644 --- a/spec/Media_Stream_Handler.xml +++ b/spec/Media_Stream_Handler.xml @@ -337,6 +337,53 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + + + + + + +

Informs the connection manager that a valid transport pair + has been discovered and streaming is in progress. Component + id MUST be the same for both transports and the pair is + only valid for that component.

+ + +

The connection manager might need to send the details of + the active transport pair (e.g. c and o parameters of SDP + body need to contain address of selected native RTP transport + as stipulated by RFC 5245). However, the candidate ID might + not be enough to determine these info if the transport was + found after NativeCandidatesPrepared + has been called (e.g. peer reflexive ICE candidate).

+ + +

This method must be called before + NewActiveCandidatePair.

+ + +

This way, connection managers supporting this method can + safely ignore subsequent + NewActiveCandidatePair call.

+ + +

Connection managers SHOULD NOT implement this method unless + they need to inform the peer about selected transports. As a + result, streaming implementations MUST NOT treat errors raised + by this method as fatal.

+ + +

Usually, connection managers only need to do one answer/offer + round-trip. However, some protocols give the possibility to + to send an updated offer (e.g. ICE defines such mechanism to + avoid some race conditions and to properly set the state of + gateway devices).

+ + + UDP (User Datagram Protocol) diff --git a/spec/all.xml b/spec/all.xml index d3f1d851b..afb48dfc6 100644 --- a/spec/all.xml +++ b/spec/all.xml @@ -3,7 +3,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude"> Telepathy D-Bus Interface Specification -0.21.3 +0.21.4 Copyright © 2005-2010 Collabora Limited Copyright © 2005-2010 Nokia Corporation -- cgit v1.2.1