文章分类 Classification
Camera
稿件来源: 互联网 撰稿作者: 匿名 发表日期: 2015-03-23 阅读次数: 174 查看权限: 游客查看
Camera模块管理设备的摄像头，可用于拍照、摄像操作，通过plus.camera获取摄像头管理对象。
方法：
- getCamera获取摄像头管理对象
对象：
- Camera摄像头对象
- CameraOptionJSON对象，调用摄像头的参数
- PopPositionJSON对象，弹出拍照或摄像界面指示位置
回调方法：
- CameraSuccessCallback调用摄像头操作成功回调
- CameraErrorCallback摄像头操作失败回调
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();
}
方法：
方法：-
captureImage进行拍照操作 -
startVideoCapture调用摄像头进行摄像操作 -
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
captureImage
进行拍照操作
cmr.captureImage( successCB, errorCB, option );
说明：
说明：
摄像头资源为独占资源，如果其它程序或页面已经占用摄像头，再次操作则失败。 拍照操作成功将通过successCB返回拍照获取的图片路径。 可通过option设置摄像头的各种属性参数。
参数：
参数：-
successCB (CameraSuccessCallback) 可选 拍照操作成功的回调函数 -
errorCB (CameraErrorCallback) 可选 拍照操作失败的回调函数 -
option (CameraOption) 可选 摄像头拍照参数
返回值：
返回值：
无
示例：
示例：
<!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
startVideoCapture
调用摄像头进行摄像操作
cmr.startVideoCapture( successCB, errorCB, option );
说明：
说明：
摄像头资源为独占资源，如果其它程序或页面已经占用摄像头，再次操作则失败。 拍照操作成功将通过successCB返回摄像获取的视频文件路径。 可通过option设置摄像头的各种属性参数。
参数：
参数：-
successCB (CameraSuccessCallback) 可选 摄像操作成功的回调函数 -
errorCB (CameraErrorCallback) 可选 拍摄像操作失败的回调函数 -
option (CameraOption) 可选 摄像头拍照参数
返回值：
返回值：
无
示例：
示例：
<!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
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
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
PopPosition
JSON对象，弹出拍照或摄像界面指示位置
属性：
属性：-
top：DOMString，弹出拍照或摄像窗口指示区域距离容器顶部的距离，支持像素值（如100px）和百分比（如50%）。 -
left：DOMString，弹出拍照或摄像窗口指示区域距离容器左侧的距离，支持像素值（如100px）和百分比（如50%）。 -
width：DOMString，弹出拍照或摄像窗口指示区域的宽度，支持像素值（如100px）和百分比（如50%）。 -
height：DOMString，弹出拍照或摄像窗口指示区域的高度，支持像素值（如100px）和百分比（如50%）。
CameraSuccessCallback
CameraSuccessCallback
调用摄像头操作成功回调
void onSuccess( capturedFile ) {
// Caputre image/video file code.
}
说明：
说明：
调用摄像头操作成功的回调函数，在拍照或摄像操作成功时调用，用于返回图片或视频文件的路径。
参数：
参数：-
capturedFile (DOMString) 可选 拍照或摄像操作保存的文件路径
CameraErrorCallback
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)
中搜索：
中搜索：
- 暂无评论
文章图片 article Pictrue
网友评论