当前位置:首页 > Windows程序 > 正文

PhoneGap API介绍:Camera

2021-05-24 Windows程序

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

简单的范例

navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] );

说明

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编码的图像:

navigator.camera.getPicture(onSuccess, onFail, { quality: 50 }); function onSuccess(imageData) { var image = document.getElementById(‘myImage‘); image.src = "data:image/jpeg;base64," + imageData; } function onFail(message) { alert(‘Failed because: ‘ + message); }

拍照并获取图像文件路径:

navigator.camera.getPicture(onSuccess, onFail, { quality: 50, destinationType: Camera.DestinationType.FILE_URI }); function onSuccess(imageURI) { var image = document.getElementById(‘myImage‘); image.src = imageURI; } function onFail(message) { alert(‘Failed because: ‘ + message); }

完整的范例:

<!DOCTYPE html> <html> <head> <title>Capture Photo</title> <script type="text/javascript" charset="utf-8" src="http://www.mamicode.com/phonegap.js"></script> <script type="text/javascript" charset="utf-8"> var pictureSource; //图片来源 var destinationType; //设置返回值的格式 // 等待PhoneGap连接设备 document.addEventListener("deviceready",onDeviceReady,false); // PhoneGap准备就绪,可以使用! function onDeviceReady() { pictureSource=navigator.camera.PictureSourceType; destinationType=navigator.camera.DestinationType; } // 当成功获得一张照片的Base64编码数据后被调用 function onPhotoDataSuccess(imageData) { // 取消注释以查看Base64编码的图像数据 // console.log(imageData); // 获取图像句柄 var smallImage = document.getElementById(‘smallImage‘); // 取消隐藏的图像元素 smallImage.style.display = ‘block‘; // 显示拍摄的照片 // 使用内嵌CSS规则来缩放图片 smallImage.src = "data:image/jpeg;base64," + imageData; } // 当成功得到一张照片的URI后被调用 function onPhotoURISuccess(imageURI) { // 取消注释以查看图片文件的URI // console.log(imageURI); // 获取图片句柄 var largeImage = document.getElementById(‘largeImage‘); // 取消隐藏的图像元素 largeImage.style.display = ‘block‘; // 显示拍摄的照片 // 使用内嵌CSS规则来缩放图片 largeImage.src = imageURI; } // “Capture Photo”按钮点击事件触发函数 function capturePhoto() { // 使用设备上的摄像头拍照,并获得Base64编码字符串格式的图像 navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 50 }); } // “Capture Editable Photo”按钮点击事件触发函数 function capturePhotoEdit() { // 使用设备上的摄像头拍照,并获得Base64编码字符串格式的可编辑图像 navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 20, allowEdit: true }); } //“From Photo Library”/“From Photo Album”按钮点击事件触发函数 function getPhoto(source) { // 从设定的来源处获取图像文件URI navigator.camera.getPicture(onPhotoURISuccess, onFail, { quality: 50, destinationType: destinationType.FILE_URI,sourceType: source }); } // 当有错误发生时触发此函数 function onFail(mesage) { alert(‘Failed because: ‘ + message); } </script> </head> <body> <button>Capture Photo</button> <br> <button>Capture Editable Photo</button> <br> <button>From Photo Library</button><br> <button>From Photo Album</button><br> <img src="" /> <img src="" /> </body> </html>

cameraSuccess

提供图像数据的onSuccess回调函数。

function(imageData) { // 对图像进行处理 }

参数

imageData:根据cameraOptions的设定值,为Base64编码的图像数据或图像文件的URI。(字符串类型)

范例

// 显示图片 function cameraCallback(imageData) { var image = document.getElementById(‘myImage‘); image.src = "data:image/jpeg;base64," + imageData; }

cameraError

提供错误信息的onError回调函数。

function(message) { // 显示有用信息 }

参数

message:设备本地代码提供的错误信息。(字符串类型)

cameraOptions

定制摄像头设置的可选参数。

温馨提示: 本文由Jm博客推荐,转载请保留链接: https://www.jmwww.net/file/70374.html