- From: Ingmar Kilche via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 03 Aug 2010 01:38:30 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/camera In directory hutz:/tmp/cvs-serv4683/camera Modified Files: Overview-API.html Log Message: ACTION-235, ISSUE-78 polish doc after split into two documents Index: Overview-API.html =================================================================== RCS file: /sources/public/2009/dap/camera/Overview-API.html,v retrieving revision 1.5 retrieving revision 1.6 diff -u -d -r1.5 -r1.6 --- Overview-API.html 16 Jul 2010 08:32:17 -0000 1.5 +++ Overview-API.html 3 Aug 2010 01:38:28 -0000 1.6 @@ -7,7 +7,7 @@ <script class='remove'> var respecConfig = { specStatus: "ED", - shortName: "capture-api", + shortName: "media-capture-api", editors: [{name: "Dzung D Tran", company: "Intel"}, {name: "Ilkka Oksanen", company: "Nokia"}, {name: "Ingmar Kliche", company: "Deutsche Telekom"}, @@ -42,7 +42,8 @@ <h2>Introduction</h2> <p>The Capture API defines a high-level interface for accessing the - microphone and camera of a hosting device.</p> + microphone and camera of a hosting device. The HTML Form Based Media + Capturing specification can be found at [[!HTMLMEDIACAPTURE]]</p> <section id="examples"> <h2>Usage Examples</h2> @@ -92,6 +93,10 @@ </pre> </div> + + <p class='note'> + The FormatData Interface contains a duration attribute. What does it mean here? Is it the max recording length?. + </p> </section> </section> @@ -120,6 +125,13 @@ ensure that privacy information is not revealed without user's informed consent.</p> + <p class='note'> + <strong>Note that there is a minimization issue with EXIF headers. + Implementations MUST not embed information in the EXIF header which + could be used for non-intended purposes (such as geolocation or device id). + </strong> + </p> + </section> <section id="api"> @@ -143,18 +155,18 @@ class="idl"><dt>readonly attribute FormatData[] supportedImageFormats</dt> - <dd>An array of FormatData objects which contains image sizes + <dd>An array of FormatData [[!HTMLMEDIACAPTURE]] objects which contains image sizes and formats supported by the hosting device camera.</dd> <dt>readonly attribute FormatData[] supportedVideoFormats </dt> - <dd>An array of FormatData objects which contains video + <dd>An array of FormatData [[!HTMLMEDIACAPTURE]] objects which contains video resolutions and formats supported by the hosting device camera.</dd> <dt>readonly attribute FormatData[] supportedAudioFormats</dt> - <dd>An array of FormatData objects which contains audio + <dd>An array of FormatData [[!HTMLMEDIACAPTURE]] objects which contains audio formats supported by the hosting device microphone.</dd> <dt>PendingOperation captureImage () </dt> @@ -175,7 +187,7 @@ picture(s).</li> <li>If successful, invoke the associated <code>successCB</code> - with a <a href="Overview.html#medialist"> <code>MediaList</code></a> + with a <code>FileList</code> [[!FILE-API]]</a> argument. If the attempt fails, and the method was invoked with a non-null <code>errorCallback</code> argument, this method must invoke the <code>errorCallback</code> with a <a @@ -195,7 +207,7 @@ <dt>CaptureCB successCB </dt> <dd>Function to call when the asynchronous operation completes </dd> - <dt>optional CaptureErrorCB? errorCB </dt> + <dt>optional CaptureErrorCB errorCB </dt> <dd>Function to call when the asynchronous operation fails. This parameter is OPTIONAL.</dd> @@ -224,8 +236,8 @@ <li>Start native video camera application. Allow end user to take video(s) and return. </li><li>If successful, invoke the - associated <code>successCB</code> with a <a - href="Overview.html#medialist"> <code>MediaList</code></a> argument. If + associated <code>successCB</code> with a <code>FileList</code> + [[!FILE-API]] argument. If the attempt fails, and the method was invoked with a non-null <code>errorCallback</code> argument, this method must invoke the <code>errorCallback</code> with a <a @@ -255,7 +267,7 @@ <dt>CaptureCB successCB </dt> <dd>Function to call when the asynchronous operation completes </dd> - <dt>optional CaptureErrorCB? errorCB</dt> + <dt>optional CaptureErrorCB errorCB</dt> <dd>Function to call when the asynchronous operation fails. This parameter is OPTIONAL.</dd> @@ -282,7 +294,7 @@ audio clip(s) and return.</li> <li>If successful, invoke the associated <code>successCB</code> - with a <a href="Overview.html#medialist"> <code>MediaList</code></a> + with a <code>FileList</code> [[!FILE-API]] argument. If the attempt fails, and the method was invoked with a non-null <code>errorCallback</code> argument, this method must invoke the <code>errorCallback</code> with a <a @@ -305,7 +317,7 @@ <dt>CaptureCB successCB </dt> <dd>Function to call when the asynchronous operation completes </dd> - <dt>optional CaptureErrorCB? errorCB </dt> + <dt>optional CaptureErrorCB errorCB </dt> <dd>Function to call when the asynchronous operation fails. This parameter is OPTIONAL.</dd> @@ -317,12 +329,12 @@ </dl> </section> - <section id="capturecallbak"><h3><a>CaptureCB</a> interface</h3> + <section id="capturecallback"><h3><a>CaptureCB</a> interface</h3> <dl title="[Callback=FunctionOnly, NoInterfaceObject] interface CaptureCB" class="idl"> <dt>void onSuccess () </dt><dd> - <dl class="parameters"><dt>MediaList capturedMedia </dt><dd>Sequence - of MediaFile successfully captured by the device</dd> + <dl class="parameters"><dt>FileList capturedMedia </dt><dd>Sequence + of Files [[!FILE-API]] (implementing the MediaFile [[!HTMLMEDIACAPTURE]] interface) successfully captured by the device</dd> </dd></dl> </dd></dl>
Received on Tuesday, 3 August 2010 01:38:31 UTC