camera

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

方法：

• getCamera: 获取摄像头管理对象

对象：

• Camera: 摄像头对象
• CameraOption: JSON对象，调用摄像头的参数
• PopPosition: JSON对象，弹出拍照或摄像界面指示位置

回调方法：

• CameraSuccessCallback: 调用摄像头操作成功回调
• CameraErrorCallback: 摄像头操作失败回调

权限：

permissions

"Camera": {
	"description": "访问摄像头设备"
}
			

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: 字符串数组，摄像头支持的拍照分辨率
• supportedVideoResolutions: 字符串数组，摄像头支持的摄像分辨率
• supportedImageFormats: 字符串数组，摄像头支持的拍照文件格式
• supportedVideoFormats: 字符串数组，摄像头支持的摄像文件格式

方法：

• captureImage: 进行拍照操作
• startVideoCapture: 调用摄像头进行摄像操作
• stopVideoCapture: 结束摄像操作

CameraOption

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

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

属性：

• filename: (DOMString 类型 )拍照或摄像文件保存的路径
  

  可设置具体文件名，也可只设置路径，如果以“/”结尾则表明是路径，如未设置文件名称或设置的文件名冲突则文件名由程序程序自动生成。

• 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 ) 必选 摄像头操作的错误信息
  

返回值：