生活随笔
收集整理的這篇文章主要介紹了
PhoneGap API帮助文档翻译—Camera (摄像头)
小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.
摘要: “camera對象提供對設(shè)備默認(rèn)攝像頭應(yīng)用程序的訪問。方法：camera.getPicture 參數(shù)：cameraSuccesscameraErrorcameraOptions camera.getPicture 選擇使用攝像頭拍照，或從設(shè)備相冊中獲取一張照片。圖片以base64 ...
| “ | camera對象提供對設(shè)備默認(rèn)攝像頭應(yīng)用程序的訪問。 |
方法：
參數(shù)： - cameraSuccess
- cameraError
- cameraOptions
選擇使用攝像頭拍照，或從設(shè)備相冊中獲取一張照片。圖片以base64編碼的字符串或圖片URI形式返回。
簡單的范例：
navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] );?? 復(fù)制代碼
說明：
camera.getPicture函數(shù)打開設(shè)備的默認(rèn)攝像頭應(yīng)用程序，使用戶可以拍照（如果 Camera.sourceType 設(shè)置為 Camera.PictureSourceType.CAMERA，這也是默認(rèn)值）。一旦拍照結(jié)束，攝像頭應(yīng)用程序會關(guān)閉并恢復(fù)用戶應(yīng)用程序。
如果Camera.sourceType = Camera.PictureSourceType.PHOTOLIBRARY或Camera.PictureSourceType.SAVEDPHOTOALBUM，系統(tǒng)彈出照片選擇對話框，用戶可以從相集中選擇照片。
返回值會按照用戶通過cameraOptions參數(shù)所設(shè)定的下列格式之一發(fā)送給cameraSuccess回調(diào)函數(shù)：
- 一個字符串，包含Base64編碼的照片圖像（默認(rèn)情況）。
- 一個字符串，表示在本地存儲的圖像文件位置。
你可以對編碼的圖片或URI做任何處理，例如：
- 通過標(biāo)簽渲染圖片（參看后續(xù)范例）
- 存儲為本地數(shù)據(jù)（LocalStorage，Lawnchair*等）
- 將數(shù)據(jù)發(fā)送到遠(yuǎn)程服務(wù)器
備注：較新的設(shè)備上使用攝像頭拍攝的照片的質(zhì)量是相當(dāng)不錯的，使用Base64對這些照片進(jìn)行編碼已導(dǎo)致其中的一些設(shè)備出現(xiàn)內(nèi)存問題 （如IPHONE4、BlackBerry Torch 9800）。因此，強烈建議將“Camera.destinationType”設(shè)為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);??
? ? }?? 復(fù)制代碼 拍照并獲取圖像文件路徑：
? ? 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);??
? ? }?? 復(fù)制代碼 完整的范例：
? ? <!DOCTYPE html>??
? ? <html>??
? ? <head>??
? ? <title>Capture Photo</title>??
? ?? ?
? ? <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>??
? ? <script type="text/javascript" charset="utf-8">??
? ?? ?
? ?? ???var pictureSource;? ?? ?//圖片來源??
? ?? ???var destinationType;? ?? ???//設(shè)置返回值的格式??
? ?? ?? ??
? ?? ???// 等待PhoneGap連接設(shè)備??
? ?? ???document.addEventListener("deviceready",onDeviceReady,false);??
? ?? ?? ??
? ?? ???// PhoneGap準(zhǔn)備就緒，可以使用！??
? ?? ???function onDeviceReady() {??
? ?? ?? ?? ?pictureSource=navigator.camera.PictureSourceType;??
? ?? ?? ?? ?destinationType=navigator.camera.DestinationType;??
? ?? ???}??
? ?? ?? ??
? ?? ???// 當(dāng)成功獲得一張照片的Base64編碼數(shù)據(jù)后被調(diào)用??
? ?? ???function onPhotoDataSuccess(imageData) {??
? ?? ?? ??
? ?? ?? ?? ?// 取消注釋以查看Base64編碼的圖像數(shù)據(jù)??
? ?? ?? ?? ?// console.log(imageData);??
? ?? ?? ?? ?// 獲取圖像句柄??
? ?? ?? ?? ?var smallImage = document.getElementById('smallImage');??
? ?? ?? ?? ?? ?? ??
? ?? ?? ?? ?// 取消隱藏的圖像元素??
? ?? ?? ?? ?smallImage.style.display = 'block';??
? ?? ?? ?? ???
? ?? ?? ?? ?// 顯示拍攝的照片??
? ?? ?? ?? ?// 使用內(nèi)嵌CSS規(guī)則來縮放圖片??
? ?? ?? ?? ?smallImage.src = "data:image/jpeg;base64," + imageData;??
? ?? ???}??
? ?? ?? ?? ??
? ?? ? // 當(dāng)成功得到一張照片的URI后被調(diào)用??
? ?? ? function onPhotoURISuccess(imageURI) {??
? ?? ?? ??
? ?? ?? ?? ?// 取消注釋以查看圖片文件的URI??
? ?? ?? ?? ?// console.log(imageURI);??
? ?? ?? ?? ?// 獲取圖片句柄??
? ?? ?? ?? ?var largeImage = document.getElementById('largeImage');??
? ?? ?? ?? ?? ?
? ?? ?? ?? ?// 取消隱藏的圖像元素??
? ?? ?? ?? ?largeImage.style.display = 'block';??
? ?? ?? ??
? ?? ?? ?? ?// 顯示拍攝的照片??
? ?? ?? ?? ?// 使用內(nèi)嵌CSS規(guī)則來縮放圖片??
? ?? ?? ?? ?largeImage.src = imageURI;??
? ?? ???}??
? ?? ?? ?? ??
? ?? ? // “Capture Photo”按鈕點擊事件觸發(fā)函數(shù)??
? ?? ? function capturePhoto() {??
? ?? ?
? ?? ?? ?? ?// 使用設(shè)備上的攝像頭拍照，并獲得Base64編碼字符串格式的圖像??
? ?? ?? ?? ?navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 50 });??
? ?? ? }??
? ?? ?? ?
? ?? ? // “Capture Editable Photo”按鈕點擊事件觸發(fā)函數(shù)??
? ?? ? function capturePhotoEdit() {??
? ?? ?
? ?? ?? ?? ?// 使用設(shè)備上的攝像頭拍照，并獲得Base64編碼字符串格式的可編輯圖像??
? ?? ?? ?? ?navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 20, allowEdit: true });??
? ?? ? }??
? ?? ?? ?? ??
? ?? ? //“From Photo Library”/“From Photo Album”按鈕點擊事件觸發(fā)函數(shù)??
? ?? ? function getPhoto(source) {??
? ?? ?? ?
? ?? ?? ?? ?// 從設(shè)定的來源處獲取圖像文件URI??
? ?? ?? ?? ?navigator.camera.getPicture(onPhotoURISuccess, onFail, { quality: 50,??
? ?? ?? ?? ?destinationType: destinationType.FILE_URI,sourceType: source });??
? ?? ? }??
? ?? ?
? ?? ? // 當(dāng)有錯誤發(fā)生時觸發(fā)此函數(shù)??
? ?? ? function onFail(mesage) {??
? ?? ?? ?? ?alert('Failed because: ' + message);??
? ?? ? }??
? ?? ?? ??
? ? </script>??
? ?? ?
? ? </head>??
? ? <body>??
? ?? ???<button οnclick="capturePhoto();">Capture Photo</button> <br>??
? ?? ???<button οnclick="capturePhotoEdit();">Capture Editable Photo</button> <br>??
? ?? ???<button οnclick="getPhoto(pictureSource.PHOTOLIBRARY);">From Photo Library</button><br>??
? ?? ???<button οnclick="getPhoto(pictureSource.SAVEDPHOTOALBUM);">From Photo Album</button><br>??
? ?? ???<img style="display:none;width:60px;height:60px;" id="smallImage" src="" />??
? ?? ???<img style="display:none;" id="largeImage" src="" />??
? ?? ???</body>??
? ? </html>?? 復(fù)制代碼 提供圖像數(shù)據(jù)的onSuccess回調(diào)函數(shù)。
? ? function(imageData) {??
? ?? ? // 對圖像進(jìn)行處理??
? ? }?? 復(fù)制代碼 參數(shù)： - imageData：根據(jù)cameraOptions的設(shè)定值，為Base64編碼的圖像數(shù)據(jù)或圖像文件的URI。（字符串類型）
范例：
? ? // 顯示圖片??
? ? function cameraCallback(imageData) {??
? ?? ???var image = document.getElementById('myImage');??
? ?? ???image.src = "data:image/jpeg;base64," + imageData;??
? ? }?? 復(fù)制代碼 提供錯誤信息的onError回調(diào)函數(shù)。
? ? function(message) {??
? ?? ? // 顯示有用信息??
? ? }?? 復(fù)制代碼 參數(shù)： - message：設(shè)備本地代碼提供的錯誤信息。（字符串類型）
定制攝像頭設(shè)置的可選參數(shù)。
? ? {? ?quality : 75,??
? ?? ???destinationType : Camera.DestinationType.DATA_URL,??
? ?? ???sourceType : Camera.PictureSourceType.CAMERA,??
? ?? ???allowEdit : true,??
? ?? ???encodingType : Camera.EncodingType.JPEG,??
? ?? ???targetWidth : 100,??
? ?? ???targetHeight : 100};?? 復(fù)制代碼 選項： - quality：存儲圖像的質(zhì)量，范圍是[0,100]。（數(shù)字類型）
- destinationType：選擇返回數(shù)據(jù)的格式。通過navigator.camera.DestinationType進(jìn)行定義。（數(shù)字類型）
? ? Camera.DestinationType = {??
? ?? ???DATA_URL : 0,? ?//返回Base64編碼字符串的圖像數(shù)據(jù)??
? ?? ???FILE_URI : 1? ? //返回圖像文件的URI??
? ? }?? 復(fù)制代碼 - sourceType：設(shè)定圖片來源。通過nagivator.camera.PictureSourceType進(jìn)行定義。（數(shù)字類型）
? ? Camera.PictureSourceType = {??
? ?? ???PHOTOLIBRARY : 0,??
? ?? ???CAMERA : 1,??
? ?? ???SAVEDPHOTOALBUM : 2??
? ? }?? 復(fù)制代碼 - allowEdit：在選擇圖片進(jìn)行操作之前允許對其進(jìn)行簡單編輯。（布爾類型）
- EncodingType：選擇返回圖像文件的編碼方式，通過navigator.camera.EncodingType進(jìn)行定義。（數(shù)字類型）
? ? Camera.EncodingType = {??
? ?? ???JPEG : 0,? ?? ? // 返回JPEG格式圖片??
? ?? ???PNG : 1? ?? ?? ?// 返回PNG格式圖片??
? ? };?? 復(fù)制代碼
- targetWidth：以像素為單位的圖像縮放寬度，必須和targetHeight同時使用。相應(yīng)的寬高比保持不變。（數(shù)字類型）
- targetHeight：以像素為單位的圖像縮放高度，必須和targetWidth同時使用。相應(yīng)的寬高比保持不變。（數(shù)字類型）
Android的特異情況： - 忽略allowEdit參數(shù)。
- Camera.PictureSourceType.PHOTOLIBRARY 或 Camera.PictureSourceType.SAVEDPHOTOALBUM 都會顯示同一個相集。
- Camera.EncodingType不被支持。
BlackBerry的特異情況： - 忽略quality參數(shù)。
- 忽略sourceType參數(shù)。
- 忽略allowEdit參數(shù)。
- 當(dāng)拍照結(jié)束后，應(yīng)用程序必須有按鍵注入權(quán)限才能關(guān)閉本地Camera應(yīng)用程序。
- 使用大圖像尺寸，可能會導(dǎo)致新近帶有高分辨率攝像頭的型號設(shè)備無法對圖像進(jìn)行編碼（如：Torch 9800）。
Palm的特異情況： - 忽略quality參數(shù)。
- 忽略sourceType參數(shù)。
- 忽略allowEdit參數(shù)。
iPhone的特異情況： - 為了避免部分設(shè)備上出現(xiàn)內(nèi)存錯誤，quality的設(shè)定值要低于50。
- 當(dāng)使用destinationType.FILE_URI時，使用攝像頭拍攝的和編輯過的照片會存儲到應(yīng)用程序的Documents/tmp目錄。
- 應(yīng)用程序結(jié)束的時候，應(yīng)用程序的Documents/tmp目錄會被刪除。如果存儲空間大小非常關(guān)鍵的時候，開發(fā)者也可以通過navigator.fileMgr的接口來刪除該目錄。
本文來自：http://blog.csdn.net/phonegapcn |
轉(zhuǎn)載于:https://www.cnblogs.com/huidaoli/articles/3613389.html
總結(jié)
以上是生活随笔為你收集整理的PhoneGap API帮助文档翻译—Camera (摄像头)的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。
