Re: Differences Between Specs

On Tue, Feb 7, 2012 at 11:55 AM, Joseph Berkovitz <joe@noteflight.com>wrote:

> Thanks Doug.  Before I can contribute to a comparison documeny I have a
> couple of basic questions about material in roc's sketch of the MediaStream
> API (I will try to keep these very brief):
>
> 1. Where are HTML MediaStreams described?  From the spec:
>
> The description of MediaStreams here extends and must remain compatible
> with HTML MediaStreams [
> http://www.whatwg.org/specs/web-apps/current-work/complete/video-conferencing-and-peer-to-peer-communication.html#stream-api
> ]
>
> The above link to a WHATWG document describing HTML MediaStreams seems to
> be broken; presumably there's a more up-to-date document. Can anyone please
> provide a link that works so I can view the general definition of an HTML
> MediaStream?
>

It's moved to here:
http://dev.w3.org/2011/webrtc/editor/webrtc.html#stream-api
I'll update the spec. Perhaps after Chris Rogers has got his updates in.

2. What are the "parameters" described in various places in the spec, e.g.
> in this method of ProcessedMediaStream:
>
>   void setParams(in any params, in optional double startTime);
>
>
In WebIDL 'any' means any Javascript value. In this case, the value has to
be supported by the HTML structured clone algorithm.
http://www.w3.org/TR/html5/common-dom-interfaces.html#safe-passing-of-structured-data
Any value that's "plain old data" would work fine.

3. Is there any sample code to back the various JS "black boxes" in the
> spec, e.g. the "synthesizer.js" code referenced in roc's UC 9?
>

Yes. You can get to example code from here:
http://people.mozilla.org/~roc/stream-demos/
(To actually play them, you'd need a test build linked from here:
http://robert.ocallahan.org/2012/01/mediastreams-processing-demos.html.)

Rob
-- 
"If we claim to be without sin, we deceive ourselves and the truth is not
in us. If we confess our sins, he is faithful and just and will forgive us
our sins and purify us from all unrighteousness. If we claim we have not
sinned, we make him out to be a liar and his word is not in us." [1 John
1:8-10]