[Telepathy] changes to StreamedMedia channel interface

[Robert McQueen]

I've tweaked this (patch attached) to add a direction argument to
ListStreams and the StreamChanged signal, and clarified that
RequestStreams is for creating outgoing (and depending on the protocol,
incoming too) streams. The assumption is that in general, most protocols
will have either unidirectional streams which you send, and the other
end gets automatically, or they will have bidirectional streams which
you send and the other end can choose whether they also send media back
to you (which is the case with Jingle and SIP calls).

Admittedly, this is a compromise - it's feasible that when some mad
multicast or group call thing appears in the future that we'll need to
add some methods to support this.

Regards,
Rob

Robert McQueen wrote:
> Hey folks,
> 
> See attached patch which proposes some changes to the streamed media
> channel interface, to allow the controlling program (voice/video call
> UI) to control the types of stream within a streamed media channel.
> 
> In summary:
>  * The GetStreams method has been renamed to ListStreams, and each
> stream within the channel is identified by a channel-unique integer.
>  * RequestStreams can be used to request new streams of certain types
> with the given channel member.
>  * Streams being added and removed from the call are signalled by the
> StreamAdded and StreamRemoved signals.
>  * Acceptance of streams will be indicated by a change of state (via the
> StreamStateChanged signal) from STOPPED to CONNECTING.
>  * Streams which are rejected will be removed.
> 
> The behaviour of Gabble will change such that adding a member to a
> streamed media channel will not automatically create any new streams,
> but will just control whether or not incoming streams from these members
> are accepted and passed to the stream engine. This changes nothing for
> incoming calls, but means that outgoing calls will need to use
> RequestStreams to indicate what kind of media you would like to try and
> include in the call.
> 
> How does this sound to everyone?
> 
> Regards,
> Rob
-- 
Robert McQueen
Director, Collabora Ltd.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: streamed-media-more-changes.diff
Type: text/x-patch
Size: 3007 bytes
Desc: not available
Url : http://lists.freedesktop.org/archives/telepathy/attachments/20060808/79ad4253/streamed-media-more-changes-0001.bin