--- a/reqs/Overview.html Thu Aug 30 10:57:59 2012 -0400
+++ b/reqs/Overview.html Mon Sep 03 14:15:43 2012 +0100
@@ -29,7 +29,7 @@
specStatus: "ED",
// the specification's short name, as in http://www.w3.org/TR/short-name/
- shortName: "audioproc-reqs",
+ shortName: "webaudio-usecases",
// if your specification has a subtitle that goes below the main
// formal title, define it here
@@ -40,7 +40,7 @@
// if the specification's copyright date is a range of years, specify
// the start date here:
- copyrightStart: "2011",
+ copyrightStart: "2012",
// if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
// and its maturity status
@@ -387,12 +387,14 @@
- <h3>User Control of Audio </h3>
- <p>A programmer wants to create a browser extension to allow the user to control the volume of audio on a per-tab basis, or to kill any audio playing completely, in a way that takes care of garbage collection.
- </p>
+ <h3>User Control of Audio</h3>
+ <p>A programmer wants to create a browser extension to allow the user to control the volume of audio.</p>
+ <p>The extension should let the user control the audio volume on a per-tab basis, or to kill any audio playing completely. The extension developer wishes to make sure killing the audio is done in a way that takes care of garbage collection.</p>
+ <p>Among the features sometimes requested for his extension are the ability to limit the audio volume to an acceptable level, both per tab and globally. On operating systems that allow it, the developer would also like his extension to mute or pause sound when a critical system sound is being played.</p>
<h4>Notes and Implementation Considerations</h4>
<ol>
- <li><p>This function is likely to combine usage of both a browser-specific extension API and the Web Audio API. One way to implement this scenario would be to use a browser-dependent API to iterate through a list of window objects, and then for each window object iterate through a list of active AudioContexts and manage their volume (or, more conveniently, manage some kind of master audio volume for the window). Neither of these latter approaches are currently supported by the Web Audio API</p></li>
+ <li><p>This function is likely to combine usage of both a browser-specific extension API and the Web Audio API. One way to implement this scenario would be to use a browser-dependent API to iterate through a list of window objects, and then for each window object iterate through a list of active AudioContexts and manage their volume (or, more conveniently, manage some kind of master audio volume for the window). Neither of these latter approaches are currently supported by the Web Audio API.</p></li>
+ <li><p>The ability to mute or pause sounds when the Operating System fires a critical system sound is modelled after the feature in existing Operating Systems which will automatically mute applications when outputting a system sound. As such, this may not involve any specific requirement for the Web Audio API. However, because some operating systems may implement such a feature, Web Audio apps may want to be notified of the muting and act accordingly (suspend, pause, etc). There may therefore be a requirement for the Web Audio API to provide such an event handler.</p></li>
</ol>
</section>