camera常见问题我要提意见

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

方法：

对象：

回调方法：

权限：

5+功能模块（permissions）


{
// ...
"permissions":{
	// ...
	"Camera": {
		"description": "摄像头"
	}
}
}

getCamera

获取摄像头管理对象


Camera plus.camera.getCamera( index );

说明：

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

参数：

返回值：

Camera : 摄像头对象

示例：


<!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>

uni-app使用plus注意事项

Camera

摄像头对象


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

属性：

方法：

supportedImageResolutions

字符串数组，摄像头支持的拍照分辨率

说明：

Array 类型 只读属性

属性类型为String[]，若不支持此属性则返回空数组对象。 摄像头支持的拍照图片分辨率字符串形式“WIDTH*Height”，如“400*800”；如果支持任意自定义分辨率则“*”。

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API 
function onPlusReady() {
	var cmr = plus.camera.getCamera();
	alert( "Camera supperted image resolutions: " + cmr.supportedImageResolutions );
}
	</script>
	</head>
	<body>
	</body>
</html>

uni-app使用plus注意事项

supportedVideoResolutions

字符串数组，摄像头支持的摄像分辨率

说明：

Array 类型 只读属性

属性类型为String[]，若不支持此属性则返回空数组对象。 摄像头支持的视频分辨率字符串形式为“WIDTH*Height”，如“400*800”；如果支持任意自定义分辨率则“*”。

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API 
function onPlusReady() {
	var cmr = plus.camera.getCamera();
	alert( "Camera supperted image resolutions: " + cmr.supportedImageResolutions );
}
	</script>
	</head>
	<body>
	</body>
</html>

uni-app使用plus注意事项

supportedImageFormats

字符串数组，摄像头支持的拍照文件格式

说明：

Array 类型 只读属性

属性类型为String[]，若不支持此属性则返回空数组对象。 摄像头支持的图片文件格式字符串形式为文件格式后缀名，如“jpg”、“png”、“bmp”。

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API 
function onPlusReady() {
	var cmr = plus.camera.getCamera();
	alert( "Camera supperted image formats: " + cmr.supportedImageFormats );
}
	</script>
	</head>
	<body>
	</body>
</html>

uni-app使用plus注意事项

supportedVideoFormats

字符串数组，摄像头支持的摄像文件格式

说明：

Array 类型 只读属性

属性类型为String[]，若不支持此属性则返回空数组对象。 摄像头支持的视频文件格式字符串形式为文件格式后缀名，如“3gp”、“mp4”、“avi”。

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API 
function onPlusReady() {
	var cmr = plus.camera.getCamera();
	alert( "Camera supperted video formats: " + cmr.supportedVideoFormats );
}
	</script>
	</head>
	<body>
	</body>
</html>

uni-app使用plus注意事项

captureImage

进行拍照操作


cmr.captureImage(successCB, errorCB, options);

说明：

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

参数：

返回值：

void : 无

示例：


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

uni-app使用plus注意事项

startVideoCapture

调用摄像头进行摄像操作


cmr.startVideoCapture(successCB, errorCB, option);

说明：

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

参数：

返回值：

void : 无

示例：


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

uni-app使用plus注意事项

stopVideoCapture

结束摄像操作


cmr.stopVideoCapture();

说明：

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

参数：

无

返回值：

void : 无

平台支持：

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Camera Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API 
function onPlusReady() {
	console.log("plusready");
}
var cmr=null;
// 摄像
function videoCapture(){
	cmr = plus.camera.getCamera();
	var res = cmr.supportedVideoResolutions[0];
	var fmt = cmr.supportedVideoFormats[0];
	console.log("Resolution: "+res+", Format: "+fmt);
	cmr.startVideoCapture( function( path ){
			alert( "Capture video success: " + path );  
		},
		function( error ) {
			alert( "Capture video failed: " + error.message );
		},
		{resolution:res,format:fmt}
	);
	// 拍摄10s后自动完成 
	setTimeout( stopCapture, 10000 );
}
// 停止摄像
function stopCapture(){
	console.log("stopCapture");
	cmr.stopVideoCapture();
}
	</script>
	</head>
	<body>
		<button onclick="videoCapture()">摄像</button><br/>
		<button onclick="stopCapture()">停止摄像</button>
	</body>
</html>

uni-app使用plus注意事项

CameraOptions

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


interface CameraOptions {
	attribute CameraCropStyles crop;
	attribute String filename;
	attribute String format;
	attribute String index;
	attribute Number videoMaximumDuration;
	attribute Boolean optimize;
	attribute String resolution;
	attribute PopPosition popover;
}

属性：

CameraCropStyles

裁剪图片设置项

说明：

注意：HBuilderX3.1.19及以上版本支持。

属性：

PopPosition

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

属性：

CameraSuccessCallback

调用摄像头操作成功回调


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

说明：

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

参数：

返回值：

void : 无

CameraErrorCallback

摄像头操作失败回调


void onError( error ) {
	// Handle camera error
	var code = error.code; // 错误编码
	var message = error.message; // 错误描述信息
}

参数：

返回值：

void : 无