Camera

稿件来源: 互联网   撰稿作者: 匿名   发表日期: 2015-03-23   阅读次数: 174   查看权限: 游客查看

Camera模块管理设备的摄像头,可用于拍照、摄像操作,通过plus.camera获取摄像头管理对象。

方法:

对象:

回调方法:

getCamera

获取摄像头管理对象

Camera plus.camera.getCamera( index );

说明:

获取需要操作的摄像头对象,如果要进行拍照或摄像操作,需先通过此方法获取摄像头对象。

参数:

  • index (Number) 可选 指定要获取摄像头的索引值,1表示主摄像头,2表示辅摄像头。如果没有设置则使用系统默认主摄像头。

返回值:

摄像头对象

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
var r = null; 
// 扩展API加载完毕,现在可以正常调用扩展API 
function onPlusReady() {
	// 获取设备默认的摄像头对象 
	var cmr = plus.camera.getCamera();
	// ...... 
}
	</script>
	</head>
	<body>
	</body>
</html>

Camera

摄像头对象

interface Camera {
	readonly attribute DOMString[] supportedImageResolutions;
	readonly attribute DOMString[] supportedVideoResolutions;
	readonly attribute DOMString[] supportedImageFormats;
	readonly attribute DOMString[] supportedVideoFormats;
	function void captureImage( successCB, errorCB, option );
	function void startVideoCapture( successCB, errorCB, option );
	function void stopVideoCapture();
}

方法:

属性:

  • supportedImageResolutions:Array,只读属性,属性类型为DOMString[],若不支持此属性则返回空数组对象。摄像头支持的拍照图片分辨率字符串形式“WIDTH*Height”,如“400*800”;如果支持任意自定义分辨率则“*”。
  • supportedVideoResolutions:Array,只读属性,属性类型为String[],若不支持此属性则返回空数组对象。摄像头支持的视频分辨率字符串形式为“WIDTH*Height”,如“400*800”;如果支持任意自定义分辨率则“*”。
  • supportedImageFormats:Array,只读属性,属性类型为String[],若不支持此属性则返回空数组对象。摄像头支持的图片文件格式字符串形式为文件格式后缀名,如“jpg”、“png”、“bmp”。
  • supportedVideoFormats:Array,只读属性,属性类型为String[],若不支持此属性则返回空数组对象。摄像头支持的视频文件格式字符串形式为文件格式后缀名,如“3gp”、“mp4”、“avi”。

captureImage

进行拍照操作

cmr.captureImage( successCB, errorCB, option );

说明:

摄像头资源为独占资源,如果其它程序或页面已经占用摄像头,再次操作则失败。 拍照操作成功将通过successCB返回拍照获取的图片路径。 可通过option设置摄像头的各种属性参数。

参数:

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
var r = null; 
// 扩展API加载完毕,现在可以正常调用扩展API 
function onPlusReady() {
	var cmr = plus.camera.getCamera();
	var res = cmr.supportedImageResolutions[0];
	var fmt = cmr.supportedImageFormats[0];
	cmr.captureImage( function( path ){
			alert( "Capture image success: " + path );
		},
		function( error ) {
			alert( "Capture image failed: " + error.message );
		},
		{resolution:res,
			format:fmt
		}
	);
}
	</script>
	</head>
	<body>
	</body>
</html>

startVideoCapture

调用摄像头进行摄像操作

cmr.startVideoCapture( successCB, errorCB, option );

说明:

摄像头资源为独占资源,如果其它程序或页面已经占用摄像头,再次操作则失败。 拍照操作成功将通过successCB返回摄像获取的视频文件路径。 可通过option设置摄像头的各种属性参数。

参数:

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
var r = null; 
// 扩展API加载完毕,现在可以正常调用扩展API 
function onPlusReady() {
	var cmr = plus.camera.getCamera();
	var res = cmr.supportedVideoResolutions[0];
	var fmt = cmr.supportedVideoFormats[0];
	cmr.startVideoCapture( function( path ){
			alert( "Capture video success: " + path );
		},
		function( error ) {
			alert( "Capture video failed: " + error.message );
		},
		{resolution:res,
			format:fmt
		}
	);
}
	</script>
	</head>
	<body>
	</body>
</html>

stopVideoCapture

结束摄像操作

cmr.stopVideoCapture();

说明:

开始调用摄像头进行摄像操作后,可在后台结束摄像操作,与用户在界面结束操作效果一致。 摄像操作成功将通过startVideoCapture函数中的successCB返回拍照获取的图片路径。 用户如果没有进行摄像操作关闭摄像头页面则调用失败回调函数。

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
var r = null; 
// 扩展API加载完毕,现在可以正常调用扩展API 
function onPlusReady() {
	var cmr = plus.camera.getCamera();
	var res = cmr.supportedVideoResolutions[0];
	var fmt = cmr.supportedVideoFormats[0];
	cmr.startVideoCapture( function( path ){
			alert( "Capture video success: " + path );
		},
		function( error ) {
			alert( "Capture video failed: " + error.message );
		},
		{resolution:res,
			format:fmt
		}
	);

	// 拍摄10s后自动完成 
	setTimeout( function () {
		cmr.stopVideoCapture();
	}, 10000 );
}
	</script>
	</head>
	<body>
	</body>
</html>

CameraOption

JSON对象,调用摄像头的参数

interface CameraOption {
	attribute String filename;
	attribute String format;
	attribute String index;
	attribute PopPosition popover;
}

属性:

  • format:DOMString,可通过Camera对象的supportedImageFormats或supportedVideoFormats获取,如果设置的参数无效则使用系统默认值。
  • index:DOMString,拍照或摄像界面默认使用的摄像头编号,1表示主摄像头,2表示辅摄像头。
  • popover:PopPosition,对于大屏幕设备如iPad,拍照或摄像界面为弹出窗口,此时可通过此参数设置弹出窗口位置,其为JSON对象,格式如{top:10,left:10,width:200,height:200},默认弹出位置为屏幕居中。

PopPosition

JSON对象,弹出拍照或摄像界面指示位置

属性:

  • top:DOMString,弹出拍照或摄像窗口指示区域距离容器顶部的距离,支持像素值(如100px)和百分比(如50%)。
  • left:DOMString,弹出拍照或摄像窗口指示区域距离容器左侧的距离,支持像素值(如100px)和百分比(如50%)。
  • width:DOMString,弹出拍照或摄像窗口指示区域的宽度,支持像素值(如100px)和百分比(如50%)。
  • height:DOMString,弹出拍照或摄像窗口指示区域的高度,支持像素值(如100px)和百分比(如50%)。

CameraSuccessCallback

调用摄像头操作成功回调

void onSuccess( capturedFile ) {
	// Caputre image/video file code.
}

说明:

调用摄像头操作成功的回调函数,在拍照或摄像操作成功时调用,用于返回图片或视频文件的路径。

参数:

  • capturedFile (DOMString) 可选 拍照或摄像操作保存的文件路径

CameraErrorCallback

摄像头操作失败回调

void onError( error ) {
	// Handle camera error
}

说明:

摄像头操作失败回调

参数:

  • error (DOMException) 可选 摄像头操作的错误信息

关键词: html5puls,camera   编辑时间: 2015-03-23 22:17:58

  • 感到高兴

    0

    高兴
  • 感到支持

    0

    支持
  • 感到搞笑

    0

    搞笑
  • 感到不解

    0

    不解
  • 感到谎言

    0

    谎言
  • 感到枪稿

    0

    枪稿
  • 感到震惊

    0

    震惊
  • 感到无奈

    0

    无奈
  • 感到无聊

    0

    无聊
  • 感到反对

    0

    反对
  • 感到愤怒

    0

    愤怒
100%(1)
0%(0)
上一篇:Cache
下一篇:Contacts
共有0 条评论 发言请遵守【相关规定

网友评论

会员头像
发 表同步腾讯微博    验证码:  点击更新请先登陆
  • 暂无评论
关闭模块文章图片 article Pictrue
  • 我的妈妈爸爸
  • 基于koa2+mysql+vue2.0+Element阳光内容管理系统
  • 代码覆盖率工具 Istanbul 入门教程
  • 全栈工程师的武器——MEAN
  • 9款超炫的 CSS3 复选框(Checkbox)
  • 微信开发在线翻译功能
  • CSS3那些不为人知的高级属性
  • 给easyui的datebox添加清空事件
  • flash写字效果
  • kendoUI系列教程之DropDownList下拉菜单
  • kendoUI系列教程之datetimepicker日期时间选择
  • kendoUI系列教程之datepicker日期选择
  • kendoUI系列教程之combobox下拉列表框
  • kendoUI系列教程之colorpicker
  • kendoUI系列教程之calendar日历表
  • kendoUI系列教程之autocomplete自动补齐