- From: Harald Alvestrand <harald@alvestrand.no>
- Date: Mon, 14 Oct 2013 19:38:37 +0200
- To: "public-media-capture@w3.org" <public-media-capture@w3.org>
- Message-ID: <525C2C1D.2020901@alvestrand.no>
A discussion erupted this week at the office over the meaning of this
construct:
dictionaryMediaSourceStates {
|SourceTypeEnum| <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#idl-def-SourceTypeEnum> sourceType <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-sourceType>;
DOMString sourceId <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-sourceId>;
unsigned long? width <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-width>;
unsigned long? height <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-height>;
float? frameRate <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-frameRate>;
float? aspectRatio <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-aspectRatio>;
|VideoFacingModeEnum| <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#idl-def-VideoFacingModeEnum>? facingMode <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-facingMode>;
unsigned long? volume <http://dev.w3.org/2011/webrtc/editor/getusermedia.html#widl-MediaSourceStates-volume>;
};
In particular the last field, which has the definition:
|volume|of typeunsigned long, nullable
The current audio track's volume (as a percentage). A volume of 0 is
silence, while a volume of 100 is the maximum supported volume.
Returned for audio sources.
For all the other properties of MediaSourceStates, it's reasonably
obvious that they are relatively static properties that are controlled
mainly by setting constraints.
There's also a "volume" constraint in "Constraint Registrations":
volume unsigned long or MinMaxConstraint Constrain the audio
source to the exact desired volume or volume range.
The two interpretations at the office were:
- Volume is "audio level" - how much sound is currently coming out.
- Volume is "gain" - how much the system will amplify (or dampen) the
sound on the track.
For the constraint, it's obviously "gain". But is the MediaSourceState
what it's currently set to, or is it the amount of sound coming down the
channel?
(We have another discussion about the fact that we *need* a way to see
how loud the audio is. But let's first figure out if this particular
piece should be interpreted one way or the other.)
Harald
Received on Monday, 14 October 2013 17:39:07 UTC