Capture(捕捉).doc

Capture(捕捉)提供对音频，图片和视频采集设备的功能。对象 捕捉 CaptureAudioOptions CaptureImageOptions CaptureVideoOptions CaptureCB CaptureErrorCB ConfigurationData MediaFile MediaFileData方法 capture.captureAudio capture.captureImage capture.captureVideo MediaFile.getFormatData范围在捕捉的对象分配给navigator.device对象，因此具有全局作用域。/ /全球捕捉对象var capture = navigator.device.capture;属性 supportedAudioModes：音频录音设备支持的格式。（ConfigurationData） supportedImageModes：录制图像大小和设备支持的格式。（ConfigurationData） supportedVideoModes：录制视频分辨率和设备支持的格式。（ConfigurationData）方法 capture.captureAudio：启动夹（s），录音设备录制音频应用。 capture.captureImage：启动的（S）设备上的照相机申请参加形象。 capture.captureVideo：启动视频（星期日）应用设备视频录像机录制。支持的平台 Android BlackBerry WebWorks（操作系统5.0和更高版本）capture.captureAudio启动录音机应用程序并返回信息捕获音频剪辑文件（s）。navigator.device.capture.captureAudio( CaptureCB captureSuccess, CaptureErrorCB captureError, CaptureAudioOptions options);说明这种方法启动一个异步操作来捕捉录音使用设备的默认音频录音应用。该设备的操作允许用户在一个会话中捕获多个录音。捕捉操作结束时，无论是用户退出录音应用程序，或最大数量的录音，指定由限制在参数CaptureAudioOptions，已经达到。如果没有值是为极限参数，一个默认值（1）使用，并且捕捉操作将终止后，用户记录单个音频剪辑。当捕捉操作完成后，它将调用CaptureCB回调与数组MediaFile文件对象的描述每个捕获音频剪辑。如果操作终止捕获用户之前是一个音频剪辑，CaptureErrorCB回调会被调用一个CaptureError的对象CaptureError。CAPTURE_NO_MEDIA_FILES错误代码。支持的平台 Android BlackBerry WebWorks（操作系统5.0和更高版本）简单的例子/ /捕获回调var captureSuccess = function(mediaFiles) var i, path, len; for (i = 0, len = mediaFiles.length; i len; i += 1) path = mediaFilesi.fullPath; / do something interesting with the file ;/ capture error callbackvar captureError = function(error) navigator.notification.alert(Error code: + error.code, null, Capture Error);/ start audio capturenavigator.device.capture.captureAudio(captureSuccess, captureError, limit:2);完整的例子 Capture Audio / Called when capture operation is finished / function captureSuccess(mediaFiles) var i, len; for (i = 0, len = mediaFiles.length; i len; i += 1) uploadFile(mediaFilesi); / Called if something bad happens. / function captureError(error) var msg = An error occurred during capture: + error.code; navigator.notification.alert(msg, null, Uh oh!); / A button will call this function / function captureAudio() / Launch device audio recording application, / allowing user to capture up to 2 audio clips navigator.device.capture.captureAudio(captureSuccess, captureError, limit: 2); / Upload files to server function uploadFile(mediaFile) var ft = new FileTransfer(), path = mediaFile.fullPath, name = mediaF; ft.upload(path, /upload.php, function(result) console.log(Upload success: + result.responseCode); console.log(result.bytesSent + bytes sent); , function(error) console.log(Error uploading file + path + : + error.code); , fileName: name ); Capture Audio BlackBerry WebWorks怪癖 WebWorks PhoneGap BlackBerry尝试推出语音记事录音应用，RIM公司提供的，捕捉录音。开发人员将获得CaptureError。CAPTURE_NOT_SUPPORTED错误代码，如果应用程序没有安装的设备。CaptureAudioOptions封装音频捕获配置选项。属性 限制：音频剪辑设备的最大数量的用户可以记录在一个捕获操作。该值必须大于或等于1（默认为1）。 时间：最长期限声音剪辑的音频秒，在。 模式：选定的音频模式。该值必须在一个匹配的元素capture.supportedAudioModes。简单的例子/ /限制捕捞作业3媒体文件，不超过每10秒var options = limit: 3, duration: 10 ;navigator.device.capture.captureAudio(captureSuccess, captureError, options);Android的怪癖 在时间参数不支持。录音长度不能仅限于编程。 该模式的参数是不支持。音频记录格式无法改变编程方式。录音是编码使用自适应多速率（AMR）格式（音频/ AMR）系统。BlackBerry WebWorks怪癖 在时间参数不支持。录音长度不能仅限于编程。 该模式的参数是不支持。音频记录格式无法改变编程方式。录音是编码使用自适应多速率（AMR）格式（音频/ AMR）系统。capture.captureImage启动应用程序并返回相机拍摄的图像信息文件（s）。navigator.device.capture.captureImage( CaptureCB captureSuccess, CaptureErrorCB captureError, CaptureImageOptions options);说明这种方法启动一个异步操作来捕捉图像使用设备相机应用。该设备的操作允许用户在一个会话中获取多个图像。捕捉操作结束时，无论是用户退出相机应用程序，或图像的最大数量，指定限制在参数CaptureImageOptions，已经达到。如果没有值是为极限参数，一个默认值（1）使用，并且捕捉操作将终止后，用户可以捕获单个图像。当捕捉操作完成后，它将调用CaptureCB回调与数组MediaFile文件对象的描述每个拍摄的图像。如果操作是捕获终止是用户之前的形象，CaptureErrorCB回调会被调用一个CaptureError的对象CaptureError。CAPTURE_NO_MEDIA_FILES错误代码。支持的平台 Android BlackBerry WebWorks（操作系统5.0和更高版本）简单的例子/ /捕获回调var captureSuccess = function(mediaFiles) var i, path, len; for (i = 0, len = mediaFiles.length; i len; i += 1) path = mediaFilesi.fullPath; / do something interesting with the file ;/ capture error callbackvar captureError = function(error) navigator.notification.alert(Error code: + error.code, null, Capture Error);/ start image capturenavigator.device.capture.captureImage(captureSuccess, captureError, limit:2);完整的例子 Capture Image / Called when capture operation is finished / function captureSuccess(mediaFiles) var i, len; for (i = 0, len = mediaFiles.length; i len; i += 1) uploadFile(mediaFilesi); / Called if something bad happens. / function captureError(error) var msg = An error occurred during capture: + error.code; navigator.notification.alert(msg, null, Uh oh!); / A button will call this function / function captureImage() / Launch device camera application, / allowing user to capture up to 2 images navigator.device.capture.captureImage(captureSuccess, captureError, limit: 2); / Upload files to server function uploadFile(mediaFile) var ft = new FileTransfer(), path = mediaFile.fullPath, name = mediaF; ft.upload(path, /upload.php, function(result) console.log(Upload success: + result.responseCode); console.log(result.bytesSent + bytes sent); , function(error) console.log(Error uploading file + path + : + error.code); , fileName: name ); Capture Image CaptureImageOptions封装图像捕获配置选项。属性 限制：最大数量的图像的设备用户可以捕获单个捕获操作。该值必须大于或等于1（默认为1）。 模式：所选择的图像模式。该值必须在一个匹配的元素capture.supportedImageModes。简单的例子/ /限制到3图像捕获操作var options = limit: 3 ;navigator.device.capture.captureImage(captureSuccess, captureError, options);Android的怪癖 该模式的参数是不支持。图像的大小和格式不能改变编程方式，但是，图像的大小可以由用户改变了该设备。图像保存为JPEG格式（图像/ JPEG文件）。BlackBerry WebWorks怪癖 该模式的参数是不支持。图像的大小和格式不能改变编程方式，但是，图像的大小可以由用户改变了该设备。图像保存为JPEG格式（图像/ JPEG文件）。capture.captureVideo录像机启动应用程序并返回信息捕获的视频剪辑文件（s）。navigator.device.capture.captureVideo( CaptureCB captureSuccess, CaptureErrorCB captureError, CaptureVideoOptions options);说明这种方法启动一个异步操作来捕捉录像设备使用录像的应用。该设备的操作允许用户在一个会话中捕获多个录音。捕捉操作结束时，无论是用户退出录像的申请，或录音的最大数量，指定由限制在参数CaptureVideoOptions，已经达到。如果没有值是为极限参数，一个默认值（1）使用，并且捕捉操作将终止后，用户记录单个视频剪辑。当捕捉操作完成后，它将调用CaptureCB回调与数组MediaFile文件对象的描述每个捕获的视频剪辑。如果操作是用户终止了之前的视频剪辑被捕获时，CaptureErrorCB回调会被调用一个CaptureError的对象CaptureError。CAPTURE_NO_MEDIA_FILES错误代码。支持的平台 Android BlackBerry WebWorks（操作系统5.0和更高版本）简单的例子/ capture callbackvar captureSuccess = function(mediaFiles) var i, path, len; for (i = 0, len = mediaFiles.length; i len; i += 1) path = mediaFilesi.fullPath; / do something interesting with the file ;/ capture error callbackvar captureError = function(error) navigator.notification.alert(Error code: + error.code, null, Capture Error);/ start video capturenavigator.device.capture.captureVideo(captureSuccess, captureError, limit:2);完整的例子 Capture Video / Called when capture operation is finished / function captureSuccess(mediaFiles) var i, len; for (i = 0, len = mediaFiles.length; i len; i += 1) uploadFile(mediaFilesi); / Called if something bad happens. / function captureError(error) var msg = An error occurred during capture: + error.code; navigator.notification.alert(msg, null, Uh oh!); / A button will call this function / function captureVideo() / Launch device video recording application, / allowing user to capture up to 2 video clips navigator.device.capture.captureVideo(captureSuccess, captureError, limit: 2); / Upload files to server function uploadFile(mediaFile) var ft = new FileTransfer(), path = mediaFile.fullPath, name = mediaF; ft.upload(path, /upload.php, function(result) console.log(Upload success: + result.responseCode); console.log(result.bytesSent + bytes sent); , function(error) console.log(Error uploading file + path + : + error.code); , fileName: name ); Capture Video BlackBerry WebWorks怪癖 WebWorks PhoneGap BlackBerry尝试启动录像机应用，RIM公司提供的，捕捉录像。开发人员将获得CaptureError。CAPTURE_NOT_SUPPORTED错误代码，如果应用程序没有安装的设备。CaptureVideoOptions封装视频捕获配置选项。属性 限制：最大数量的视频剪辑的设备用户可以捕获单个捕获操作。该值必须大于或等于1（默认为1）。 时间：最长期限的视频剪辑的一秒钟，在。 模式：选定的视频拍摄模式。该值必须在一个匹配的元素capture.supportedVideoModes。简单的例子/ /限制捕获操作视频剪辑3var options = limit: 3 ;navigator.device.capture.captureVideo(captureSuccess, captureError, options);Android的怪癖 在时间参数不支持。录音长度不能仅限于编程。 该模式的参数是不支持。视频大小和格式不能改变编程方式，但是，这些参数可以由用户改变了设备。默认情况下，视频记录在3GPP（video/3gpp）格式。BlackBerryWebWorks怪癖 在时间参数不支持。录音长度不能仅限于编程。 该模式的参数是不支持。视频大小和格式不能改变编程方式，但是，这些参数可以由用户改变了设备。默认情况下，视频记录在3GPP（video/3gpp）格式。CaptureCB调用成功后，媒体捕捉操作。function captureSuccess( MediaFile mediaFiles ) . ;说明此函数调用成功后捕捉操作已完成。这意味着一个媒体文件已被抓获，无论是用户已退出媒体捕捉应用程序，或捕捉已达到限制。每个MediaFile对象描述一名被俘的媒体文件。简单的例子/ /捕获回调function captureSuccess(mediaFiles) var i, path, len; for (i = 0, len = mediaFiles.length; i width) width = mode.width; selectedmode = mode; MediaFile封装属性的媒体捕捉文件。属性 名称：该名称的文件，没有路径信息。（DOMString） fullPath：该文件的完整路径，包括名称。（DOMString） 类型：MIME类型（DOMString） lastModifiedDate：日期和时间，该文件的最后修改。（日期） 大小：在大小字节的文件，在。（数目）方法 MediaFile.getFormatData：检索媒体文件格式的信