From: Cullen Jennings <fluffy@cisco.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
Date: Mon, 23 Jan 2012 08:32:55 -0800
Message-Id: <5A7593E9-0366-4BD1-B7AC-F1E246690E75@cisco.com>
To: public-webrtc@w3.org
Mime-Version: 1.0 (Apple Message framework v1251.1)
Received-SPF: pass client-ip=173.36.130.12; envelope-from=fluffy@cisco.com; helo=mtv-iport-1.cisco.com
Subject: Proposal for Hints Information 
Archived-At: <http://www.w3.org/mid/5A7593E9-0366-4BD1-B7AC-F1E246690E75@cisco.com>
Resent-From: public-webrtc@w3.org
Resent-Sender: public-webrtc-request@w3.org
Precedence: list
Resent-Message-Id: <E1RpMpg-0004p9-ON@frink.w3.org>
Resent-Date: Mon, 23 Jan 2012 16:33:24 +0000


Here is a rough sketch of the information I think we likely need in the =
Hints API. Note all of these are hints and can be ignored.=20

For Video: ----------------------------

min / max height=20

min / max width=20

aspect ratio=20

min / max frame rate=20

codingPreference - enum with values "detail" "action". This provides a =
hint of it the video coder should prefer to put bits into temporal or =
spacial resolution. It could use a better name but I'm trying to pick =
values where they both are appealing to web developers and do not seem =
like one is better than other. For example, if we called these =
"goodDetail" and "badDetail", I doubt badDetail would be used as often =
as it should.=20

preferredCamera - enum of front, back, left, right, middle, =
presentation, speaker, whiteboard

interactive: boolean indicating if this is for an interactive session or =
not. This would imply the browser would favor lower latency and shooter =
GOP sequence=20


For audio: ------------------------------

maxChannels - integer. 1 indicates mono, 2 stereo, and so on.=20

codingPreference - enum of "music", "speech", "scientific" - Music =
implies very trying to select a codec that can represent most things we =
hear. Speech implies this is human speech from mostly one speaker at a =
time. Scientific means we want to process this in ways beyond what the =
human ear does and prefer as faithful a reproduction as the original =
waveform as possible.=20

interactive: boolean indicating if this is for an interactive session or =
not. This would indicate the browser should try and do echo cancelation=20=

=20
disableAudioFiltering - boolean to disable VAD and other noise =
processing needed E911=20

useHeadsetInput - boolean

useHaedsetOutput - boolean=20