W3C home > Mailing lists > Public > public-webrtc@w3.org > April 2012

Re: Proposal for API for Data

From: Cullen Jennings <fluffy@cisco.com>
Date: Mon, 9 Apr 2012 15:31:31 -0600
Cc: public-webrtc@w3.org
Message-Id: <ED0A7A27-2FF8-4390-AD83-805B157DFB6C@cisco.com>
To: Harald Alvestrand <harald@alvestrand.no>

On Mar 15, 2012, at 10:13 AM, Harald Alvestrand wrote:

> On 03/15/2012 02:34 PM, Cullen Jennings wrote:
>> I had a proposal for the Data API for awhile and have circulated it privately to some folks but I had not sent it to the list because I wanted to keep the focus on the PeerConnection / JSEP stuff for awhile. However, I think I probably need to send this out. I think at the high level there is general agreement we need to be abel to send and receive data much like web sockets does, we need to be abel to create and destroy channels, and we need to be able to mark a channel as reliable or non reliable delivery. The API I'm proposing to do this is very simple.
>> 
>> Interface DataMediaStreamTrack : MediaStreamTrack
>> {
>>      attribute boolean reliable;
>> }
>> DataMediaStreamTrack implements WebSocket;
>> 
>> 
>> This ends up getting the function to send and receive data as well as report errors fromWebSocket. Any library that takes a WebSocket can take a DataMediaStream. It unifies creation of a new stream to be the same as MediaStreams. So in the same way that a new Video track was created, you can add a data track or remove one. It is labeled in same way as the the other tracks and so on. It seems like i works well for data sources that are from the JS app and it also can be used with data sources, such as a sensor or game controller, that may be more controlled by the browser in the same way a microphone or camera is more controlled form the browser. That will allow for better real time performance of devices that produce a data stream instead of an media stream.
>> 
>> I'd like to discuss on one of the call the pros / cons of such an interface but right now I am heads down on the JSEP changes.
> At one point I argued something similar....
> 
> the biggest worry I have with this approach is that it inherits a lot of stuff that doesn't seem to make sense, for instance:

I think my answer to all of this this is more or less "same thing as media". Something in media stream that does not work for data probably will not work for DTMF. 

My primary issues here is that I'd rather not have things be greatly different if they don't need to be. If there is something in the MediaStreams that does not work for Data, then I am worried that it will have problem for other media types that get done in the future that are not Audio or Video. 

I do think that given the primary goal of the Data interface is to reduce latency, that we need to have a model that works when the Data is generated directly by a device and not from the JS app. Of course we all need to support the JS app generation. 


> 
> - "mute" functions from the MediaStreamTrack: What does it mean to "mute" a data channel?

same thing as with media - it largely an indicate that the received data will be ignored 


> - track manipulations: what does it mean to add a DataMediaStreamTrack to two MediaStreams?

I don't think we have full agreement on what this means with media, but again, I would propose same thing. I think this means both streams would get a copy of the data yet only one copy of the data would be sent over the network. 

> Perhaps nothing, since there still can be only one handler (or handler list) for the onmessage() function anyway?
> - "url" and "extensions" attributes from the WebSocket API: Do they have meaning? Are "extensions" names from the same namespace as for WebSockets?

I may be confused but I think the URLs only show up in the constructor and thus would not apply over to the DataMediaStreamTrack. 


> 
> But I agree that getting the JSEP changes done is more important...
> 
>          Harald
> 
> 
> 
> 
> 
Received on Monday, 9 April 2012 21:32:02 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 9 April 2012 21:32:02 GMT