PhoneGap API介绍:Camera
选择使用摄像头拍照,或从设备相册中获取一张照片。图片以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