7 uap mobile api referenceuap_plug_apiuexcamera

1、uexCamera1、简介 2、API概览 3、更新历史 1、简介照相机插件 1.1 、说明调用设备照相机拍摄照片,成功后返回相关图片存储地址. 自定义相机功能接口只适用安卓平台系统,其他接口功能支持跨平台使用 注意! Android因内存问题,调用系统相机会导致APP,需调用自定义相机接口或使用参数压缩下图片. 主要是因为,系统相机和调用系统相机的APP不在同一进程,因内存过低,系统将APP杀死.1.2 、UI展示1.3 、开源源码插件测试用例与源码下载:点击插件中心至插件详情页 (插件测试用例与插件源码已经提供)1.4 、平台版本支持本插件的所有API默认支持Android4.0+和iOS

2、7.0+操作系统. 有特殊版本要求的API会在文档中额外说明.1.5 、接口有效性本插件所有API默认在插件版本4.0.0+可用. 在后续版本中新添加的接口会在文档中额外说明.2、API概览2.1、方法open /调用系统相机uexCamera.open(comtextareass, quality, callbackFunction)openopenInternalopenViewCameraremoveViewCameraFromWindowchangeFlashModechangeCameraPosition说明:通过此方法调用系统相机,进入拍照界面.参数:参数名称参数类型是否必选说明c

3、omtextareassNumber类型图片是否压缩,0表示压缩,非0或者不传表示不压缩可选qualityNumber类型图片压缩质量,comtextareass为0时有效,取值范围0,100可选callbackFunction回调函数,用来获取相关业务数据 函数必选回调参数:var callbackFunction = function(picPath)参数名称类型说明picPathString拍照完成后图片的存储路径 示例:var comtextareass = 0; var quality = 100;uexCamera.open(comtextareass, quality, func

4、tion(picPath) alert(picPath););openInternal /打开自定义相机uexCamera.openInternal(comtextareass, quality, callbackFunction)说明:通过此方法打开自定义相机,进入拍照界面.参数:参数名称参数类型是否必选说明comtextareassNumber类型图片是否压缩,0表示压缩,非0或者不传表示不压缩可选qualityNumber类型图片压缩质量,comtextareass为0时有效,取值范围0,100可选callbackFunction回调函数,用来获取拍照后图片的存储路径 函数必选回调参数:

5、var callbackFunction = function(picPath)参数名称类型说明picPathString拍照完成后图片的存储路径 示例:var comtextareass = 0; var quality = 100;uexCamera.openInternal(comtextareass, quality, function(data) alert(data););openViewCamera /打开自定义View照相机uexCamera.openViewCamera(x, y, width, heigth, label, quality, callbackFunction

6、)说明:通过此方法打开自定义View照相机.参数:参数名称参数类型是否必选说明xNumber类型照相机View起始位置x坐标,x为0时有效,取值范围0,屏幕分辨率最大宽度必选yNumber类型照相机View起始位置y坐标,y为0时有效,取值范围0,屏幕分辨率最大高度必选widthNumber类型照相机View宽度,width为0时有效,取值范围0,屏幕分辨率最大宽度必选heigthNumber类型照相机View起始位置y坐标,y为0时有效,取值范围0,屏幕分辨率最大高度必选labelString类型必选拍照时显示在界面中的提示语或标签 qualityNumber类型图片压缩质量,comtext

7、areass为0时有效,取值范围0,100必选callbackFunction回调函数,用来获取拍照后图片的存储路径 函数必选回调参数:var callbackFunction = function(data)参数名称类型说明dataObject返回的图片信息,形式见下:var data = photoPath: /storage/emulated/0/widgetone/apps/11352882/uexViewCameraPhotos/2016-06-06_19-52-13.jpg, location: 奥格瑞玛,label: 奥格瑞玛 /拍照时显示在界面中的提示语或标签 示例:uexCa

8、mera.openViewCamera(x, y, w, h,label,quality, function(data) alert(JSON.stringify(data););removeViewCameraFromWindow /从屏幕上移除自定义View相机uexCamera.removeViewCameraFromWindow()说明:通过此方法从屏幕上移除自定义View相机.参数:无示例:uexCamera.removeViewCameraFromWindow();changeFlashMode /改变自定义相机View的闪光灯模式uexCamera.changeFlashMode

9、(flashMode)说明:通过此方法将改变自定义相机View的闪光灯模式,0代表自动,1代表打开闪光灯,2代表关闭闪光灯.如果设置changeCameraPosition为 前置摄像头则闪光灯无效.参数:参数名称参数类型是否必选说明flashModeNumber照相机View的闪光灯模式,x为0、1、2时有效,取值范围0,2.是返回值:Number类型,更改闪光灯模式成功后当前闪光灯模式.示例:var mode = uexCamera.changeFlashMode(0); alert(mode);changeCameraPosition /改变自定义相机View的摄像头位置uexCamer

10、a.changeCameraPosition(cameraPosition)说明:通过此方法改变自定义相机View的摄像头位置,0代表后置,1代表前置.参数:cameraPosition:(Number类型) 必选 照相机View的摄像头位置,x为0、1时有效,取值范围0,1.返回值:Number类型,返回更改前后摄像头成功后当前摄像头的位置.示例:var position = uexCamera.changeCameraPosition(cameraPosition); alert(position);3、更新历史iOSAPI版本: uexCamera-4.0.3最近更新时间: 2017-06-08历史发布版本更新内容4.0.3openViewCamera支持JSON传参 历史发布版本更新内容4.0.2修复横屏打开展示图