PhoneGap API帮助文档翻译—Camera (摄像头)

phonegap 专栏收录该内容
10 篇文章 0 订阅

PhoneGap API帮助文档翻译—Camera (摄像头)

camera对象提供对设备默认摄像头应用程序的访问。
方法:
  • camera.getPicture
参数:
  • cameraSuccess
  • cameraError
  • cameraOptions

camera.getPicture
 
选择使用摄像头拍照,或从设备相册中获取一张照片。图片以base64编码的字符串或图片URI形式返回。

简单的范例:
说明:
camera.getPicture函数打开设备的默认摄像头应用程序,使用户可以拍照(如果    Camera.sourceType 设置为 Camera.PictureSourceType.CAMERA,这也是默认值)。一旦拍照结束,摄像头应用程序会关闭并恢复用户应用程序。
如果Camera.sourceType    = Camera.PictureSourceType.PHOTOLIBRARY或Camera.PictureSourceType.SAVEDPHOTOALBUM,系统弹出照片选择对话框,用户可以从相集中选择照片。
返回值会按照用户通过cameraOptions参数所设定的下列格式之一发送给cameraSuccess回调函数:
  • 一个字符串,包含Base64编码的照片图像(默认情况)。
  • 一个字符串,表示在本地存储的图像文件位置
你可以对编码的图片或URI做任何处理,例如:
  • 通过标签渲染图片(参看后续范例)
  • 存储为本地数据(LocalStorage,Lawnchair*等)
  • 将数据发送到远程服务器
备注 :较新的设备上使用摄像头拍摄的照片的质量是相当不错的,使用Base64对这些照片进行编码已导致其中的一些设备出现内存问题(如IPHONE4、BlackBerry    Torch 9800)。因此,强烈建议将“Camera.destinationType”设为FILE_URI。
支持的平台:
  • Android
  • BlackBerry WebWorks (OS 5.0或更高版本)
  • iOS
简单的范例:
拍照并获取Base64编码的图像:
拍照并获取图像文件路径:
完整的范例:

提供图像数据的onSuccess回调函数。
参数:
  • imageData:根据cameraOptions的设定值,为Base64编码的图像数据或图像文件的URI。(字符串类型)
范例:

提供错误信息的onError回调函数。
参数:
  • message:设备本地代码提供的错误信息。(字符串类型)
定制摄像头设置的可选参数。
选项:
  • quality:存储图像的质量,范围是[0,100]。(数字类型)
  • destinationType:选择返回数据的格式。通过navigator.camera.DestinationType进行定义。(数字类型)
  • sourceType:设定图片来源。通过nagivator.camera.PictureSourceType进行定义。(数字类型)
  • allowEdit:在选择图片进行操作之前允许对其进行简单编辑。(布尔类型)
  • EncodingType:选择返回图像文件的编码方式,通过navigator.camera.EncodingType进行定义。(数字类型)
  • targetWidth:以像素为单位的图像缩放宽度,必须和targetHeight同时使用。相应的宽高比保持不变。(数字类型)
  • targetHeight:以像素为单位的图像缩放高度,必须和targetWidth同时使用。相应的宽高比保持不变。(数字类型)
Android的特异情况:
  • 忽略allowEdit参数。
  • Camera.PictureSourceType.PHOTOLIBRARY 或 Camera.PictureSourceType.SAVEDPHOTOALBUM 都会显示同一个相集。
  • Camera.EncodingType不被支持。
BlackBerry的特异情况:
  • 忽略quality参数。
  • 忽略sourceType参数。
  • 忽略allowEdit参数。
  • 当拍照结束后,应用程序必须有按键注入权限才能关闭本地Camera应用程序。
  • 使用大图像尺寸,可能会导致新近带有高分辨率摄像头的型号设备无法对图像进行编码(如:Torch 9800)。
Palm的特异情况:
  • 忽略quality参数。
  • 忽略sourceType参数。
  • 忽略allowEdit参数。
iPhone的特异情况:
  • 为了避免部分设备上出现内存错误,quality的设定值要低于50。
  • 当使用destinationType.FILE_URI时,使用摄像头拍摄的和编辑过的照片会存储到应用程序的Documents/tmp目录。
  • 应用程序结束的时候,应用程序的Documents/tmp目录会被删除。如果存储空间大小非常关键的时候,开发者也可以通过navigator.fileMgr的接口来删除该目录。


  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

©️2021 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值