[telepathy-spec/master] Add an Immutable_Streams pseudo-capability.

Will Thompson will.thompson at collabora.co.uk
Tue Aug 4 10:24:01 PDT 2009


---
 spec/Channel_Type_Streamed_Media.xml |   25 +++++++++++++++++++++++++
 1 files changed, 25 insertions(+), 0 deletions(-)

diff --git a/spec/Channel_Type_Streamed_Media.xml b/spec/Channel_Type_Streamed_Media.xml
index db0b657..31ef965 100644
--- a/spec/Channel_Type_Streamed_Media.xml
+++ b/spec/Channel_Type_Streamed_Media.xml
@@ -549,6 +549,31 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
           NATs.
         </tp:docstring>
       </tp:flag>
+
+      <tp:flag suffix="Immutable_Streams" value="32">
+        <tp:docstring>
+          Once streams have been requested for a channel to this handle (either
+          by calling <tp:member-ref>RequestStreams</tp:member-ref> on a channel
+          with no streams, or by specifying <tp:dbus-ref
+            namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia.FUTURE">InitialAudio</tp:dbus-ref>
+          or <tp:dbus-ref
+            namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia.FUTURE">InitialAudio</tp:dbus-ref>
+          = <tt>True</tt> in the channel request), then they cannot be changed;
+          subsequent calls to <tp:member-ref>RequestStreams</tp:member-ref> or
+          <tp:member-ref>RemoveStreams</tp:member-ref> will fail.
+
+          <tp:rationale>
+            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.
+          </tp:rationale>
+        </tp:docstring>
+      </tp:flag>
+
     </tp:flags>
 
   </interface>
-- 
1.5.6.5




More information about the telepathy-commits mailing list