cameraQQ

来自于:AC模块工作室立即使用

概述

本模块封装了摄像头拍照的模块,调用 open 接口(相当于打开一个 Window),然后模块会弹出一个自带UI效果的拍照界面,在此界面,用户可切换前后摄像头,打开关闭闪关灯、确定拍照以及取消退出。本拍照模块有自动对焦功能,用户也可以手指点击某点对焦。

截图如下:

open

打开固定 UI 的相机页面

open({params}, callback(ret))

params

save:

  • 类型:JSON 对象
  • 描述:(可选项)拍摄的图片保存信息
  • 内部字段:
{
    path: '',       //(可选项)字符串类型;拍摄结果保存路径,要求本地路径(fs://),如:fs://camerWeibo
    name: ''        //(可选项)字符串类型;拍摄结果保存的文件名
}

album:

  • 类型:布尔
  • 描述:(可选项)拍照成功后是否将所拍图片存入系统相册
  • 默认:false

animation:

  • 类型:布尔
  • 描述:(可选项)打开拍照页面时是否带有动画效果
  • 默认:true

quality:

  • 类型:字符串
  • 描述:(可选项)所拍照片质量
  • 默认:medium
  • 取值范围:
    • high:超清
    • medium:高清
    • low:普通

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
{
    eventType: 'takePhoto', //字符串类型;交互事件类型,取值范围如下:
                              // takePhoto 拍照事件
                              // show 相机打开事件
                              // close 相机关闭事件
    imagePath: '',          // 字符串类型;所拍图片的保存的绝对路径,仅当 eventType 为 takePhoto 时有效
    albumPath: ''           //字符串类型;保存到相册后的图片路径,仅当 eventType 为 takePhoto 且 album 为 true时有效
}

示例代码

var cameraQQ = api.require('cameraQQ');
cameraQQ.open({
    save: {
       path: 'fs://cameraQQ'
       name: 'photo'
    },
    album: true ,
    quality: 'medium'
}, function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

cancel

取消/关闭拍照页面

cancel({params})

params

animation:

  • 类型:布尔
  • 描述:(可选项)关闭拍照页面时是否带有动画效果
  • 默认:true

示例代码

var cameraQQ = api.require('cameraQQ');
cameraQQ.cancel({
  animation: true
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本