14 KiB
org.apache.cordova.camera
이 플러그인 사진 촬영을 위한 및 시스템의 이미지 라이브러리에서 이미지를 선택 하기 위한 API를 제공 합니다.
cordova plugin add org.apache.cordova.camera
navigator.camera.getPicture
카메라를 사용 하 여 사진을 걸립니다 또는 소자의 이미지 갤러리에서 사진을 검색 합니다. 이미지 base64 인코딩으로 성공 콜백에 전달 됩니다 String , 또는 이미지 파일에 대 한 URI로. 방법 자체는 반환 합니다 한 CameraPopoverHandle 개체 파일 선택 popover를 재배치 하는 데 사용할 수 있습니다.
navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] );
설명
camera.getPicture기능 스냅 사진을 사용자가 디바이스의 기본 카메라 응용 프로그램을 엽니다. 이 동작은 기본적으로 발생 할 때 Camera.sourceType 와 Camera.PictureSourceType.CAMERA . 일단 사용자 스냅 사진, 카메라 응용 프로그램 종료 하 고 응용 프로그램 복원 됩니다.
경우 Camera.sourceType 은 Camera.PictureSourceType.PHOTOLIBRARY 또는 Camera.PictureSourceType.SAVEDPHOTOALBUM , 사용자가 기존 이미지를 선택할 수 있도록 다음 대화 상자 표시. camera.getPicture반환 함수는 CameraPopoverHandle 장치 방향 변경 될 때 이미지 선택 대화 상자, 예를 들어, 위치를 변경 하려면 사용할 수 있는 개체.
반환 값에 전송 되는 cameraSuccess 콜백 함수에 따라 지정 된 다음 형식 중 하나에 cameraOptions :
-
A
Stringbase64 인코딩된 사진 이미지를 포함 합니다. -
A
String로컬 저장소 (기본값)의 이미지 파일 위치를 나타내는.
할 수 있는 당신이 원하는대로 인코딩된 이미지 또는 URI, 예를 들면:
-
렌더링 이미지는
<img>아래 예제와 같이 태그 -
로컬로 데이터를 저장 (
LocalStorage, Lawnchair, 등.) -
원격 서버에 데이터 게시
참고: 더 새로운 장치에 사진 해상도 아주 좋은. 소자의 갤러리에서 선택 된 사진을 하지 낮은 품질에 관하여는 경우에는 quality 매개 변수를 지정 합니다. 일반적인 메모리 문제를 방지 하려면 설정 Camera.destinationType 을 FILE_URI 보다는DATA_URL.
지원 되는 플랫폼
- 아마존 화재 운영 체제
- 안 드 로이드
- 블랙베리 10
- Firefox 운영 체제
- iOS
- Tizen
- Windows Phone 7과 8
- 윈도우 8
아마존 화재 OS 단점
아마존 화재 OS 의도 사용 하 여 이미지 캡처 장치에서 카메라 활동을 시작 하 고 낮은 메모리와 휴대 전화에 코르 도우 바 활동 살해 수 있습니다. 코르도바 활동 복원 되 면이 시나리오에서는 이미지가 나타나지 않을 수 있습니다.
안 드 로이드 단점
안 드 로이드 의도 사용 하 여 이미지 캡처 장치에서 카메라 활동을 시작 하 고 낮은 메모리와 휴대 전화에 코르 도우 바 활동 살해 수 있습니다. 코르도바 활동 복원 되 면이 시나리오에서는 이미지가 나타나지 않을 수 있습니다.
파이어 폭스 OS 단점
카메라 플러그인은 현재 웹 활동 를 사용 하 여 구현.
iOS 단점
자바 스크립트를 포함 하 여 alert() 함수는 콜백 중에 문제를 일으킬 수 있습니다. 내 경고를 래핑하는 setTimeout() 허용 iOS 이미지 피커 또는 popover를 완벽 하 게 경고를 표시 하기 전에 닫습니다:
setTimeout(function() {/ / 여기 짓!}, 0);
Windows Phone 7 단점
장치 Zune 통해 연결 된 동안 네이티브 카메라 응용 프로그램을 호출 하면 작동 하지 않습니다 하 고 오류 콜백 트리거합니다.
Tizen 특수
Tizen만 지원 한 destinationType 의 Camera.DestinationType.FILE_URI 와 sourceType 의Camera.PictureSourceType.PHOTOLIBRARY.
예를 들어
촬영 및 base64 인코딩 이미지로 검색:
navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
destinationType: Camera.DestinationType.DATA_URL
});
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);
}
CameraOptions
카메라 설정을 사용자 지정 하는 선택적 매개 변수.
{품질: 75, destinationType: Camera.DestinationType.DATA_URL, sourceType: Camera.PictureSourceType.CAMERA, allowEdit: 사실, encodingType: Camera.EncodingType.JPEG, targetWidth: 100, targetHeight: 100, popoverOptions: CameraPopoverOptions, saveToPhotoAlbum: false};
옵션
-
품질: 범위 0-100, 100은 파일 압축에서 손실 없이 일반적으로 전체 해상도 저장된 된 이미지의 품질. (수) (Note 카메라의 해상도 대 한 정보는 사용할 수 없습니다.)
-
destinationType: 반환 값의 형식을 선택 합니다. 에 정의 된
navigator.camera.DestinationType(수)Camera.DestinationType = {DATA_URL: 0, / / base64 인코딩된 문자열로 FILE_URI 이미지를 반환: 1, / / 이미지 파일 URI NATIVE_URI 반환: 2 / / 반환 이미지 기본 URI (예를 들어, 자산 라이브러리: / / iOS 또는 콘텐츠: / / 안 드 로이드에)}; -
sourceType: 그림의 소스를 설정 합니다. 에 정의 된
navigator.camera.PictureSourceType(수)Camera.PictureSourceType = {PHOTOLIBRARY: 0, 카메라: 1, SAVEDPHOTOALBUM: 2}; -
allowEdit: 선택 하기 전에 이미지의 간단한 편집을 허용 합니다. (부울)
-
encodingType: 반환 된 이미지 파일의 인코딩을 선택 합니다. 에 정의 된
navigator.camera.EncodingType(수)Camera.EncodingType = {JPEG: 0, / / 반환 JPEG로 인코딩된 PNG 이미지: 1 / 반환 PNG 이미지 인코딩 /}; -
targetWidth: 스케일 이미지를 픽셀 너비. TargetHeight와 함께 사용 해야 합니다. 가로 세로 비율이 일정 하 게 유지 합니다. (수)
-
targetHeight: 스케일 이미지를 픽셀 단위로 높이. TargetWidth와 함께 사용 해야 합니다. 가로 세로 비율이 일정 하 게 유지 합니다. (수)
-
mediaType:에서 선택 미디어 유형을 설정 합니다. 때에 작동
PictureSourceType는PHOTOLIBRARY또는SAVEDPHOTOALBUM. 에 정의 된nagivator.camera.MediaType(수)Camera.MediaType = {그림: 0, / / 아직 사진만의 선택을 허용 합니다. 기본입니다. Will return format specified via DestinationType VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI ALLMEDIA : 2 // allow selection from all media types }; -
correctOrientation: 캡처 도중 장치의 방향에 대 한 해결 하기 위해 이미지를 회전 합니다. (부울)
-
saveToPhotoAlbum: 캡처 후 장치에서 사진 앨범에 이미지를 저장 합니다. (부울)
-
popoverOptions: iPad에 popover 위치를 지정 하는 iOS 전용 옵션. 에 정의 된
CameraPopoverOptions. -
cameraDirection: (앞 이나 뒤로-연결)를 사용 하 여 카메라를 선택 하십시오. 에 정의 된
navigator.camera.Direction(수)Camera.Direction = {다시: 0, / / 앞 뒤 방향 카메라를 사용: 1 / 전면을 향하는 카메라를 사용 하 여 /};
아마존 화재 OSQuirks
-
어떤
cameraDirection다시 연결 사진에 결과 값. -
무시는
allowEdit매개 변수. -
Camera.PictureSourceType.PHOTOLIBRARY그리고Camera.PictureSourceType.SAVEDPHOTOALBUM둘 다 동일한 사진 앨범을 표시 합니다.
안 드 로이드 단점
-
어떤
cameraDirection다시 연결 사진에 결과 값. -
무시는
allowEdit매개 변수. -
Camera.PictureSourceType.PHOTOLIBRARY그리고Camera.PictureSourceType.SAVEDPHOTOALBUM둘 다 동일한 사진 앨범을 표시 합니다.
블랙베리 10 단점
-
무시는
quality매개 변수. -
무시는
sourceType매개 변수. -
무시는
allowEdit매개 변수. -
Camera.MediaType지원 되지 않습니다. -
무시는
correctOrientation매개 변수. -
무시는
cameraDirection매개 변수.
파이어 폭스 OS 단점
-
무시는
quality매개 변수. -
Camera.DestinationType무시 되 고1(이미지 파일 URI) -
무시는
allowEdit매개 변수. -
무시는
PictureSourceType매개 변수 (사용자가 선택 그것 대화 창에서) -
무시 하는
encodingType -
무시는
targetWidth와targetHeight -
Camera.MediaType지원 되지 않습니다. -
무시는
correctOrientation매개 변수. -
무시는
cameraDirection매개 변수.
iOS 단점
-
설정
quality일부 장치 메모리 오류를 피하기 위해 50 아래. -
사용 하는 경우
destinationType.FILE_URI, 사진 응용 프로그램의 임시 디렉터리에 저장 됩니다. 사용 하 여이 디렉터리의 내용을 삭제할 수 있는navigator.fileMgrApi 저장 공간이 중요 한 경우.
Tizen 특수
-
지원 되지 않는 옵션
-
항상 파일 URI를 반환 합니다.
Windows Phone 7, 8 특수
-
무시는
allowEdit매개 변수. -
무시는
correctOrientation매개 변수. -
무시는
cameraDirection매개 변수. -
무시는
mediaType속성을cameraOptions으로 Windows Phone SDK PHOTOLIBRARY에서 비디오를 선택 하는 방법을 제공 하지 않습니다.
CameraError
오류 메시지를 제공 하는 onError 콜백 함수.
function(message) {
// Show a helpful message
}
매개 변수
- 메시지: 메시지는 장치의 네이티브 코드에 의해 제공 됩니다. (문자열)
cameraSuccess
이미지 데이터를 제공 하는 onSuccess 콜백 함수.
function(imageData) {
// Do something with the image
}
매개 변수
- imageData: Base64 인코딩은 이미지 데이터, 또는 이미지 파일에 따라 URI의
cameraOptions적용. (문자열)
예를 들어
// Show image
//
function cameraCallback(imageData) {
var image = document.getElementById('myImage');
image.src = "data:image/jpeg;base64," + imageData;
}
CameraPopoverHandle
에 의해 만들어진 popover 대화에 대 한 핸들navigator.camera.getPicture.
메서드
- setPosition:는 popover의 위치를 설정 합니다.
지원 되는 플랫폼
- iOS
setPosition
popover의 위치를 설정 합니다.
매개 변수:
cameraPopoverOptions:는CameraPopoverOptions새 위치를 지정 하는
예를 들어
var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
{ destinationType: Camera.DestinationType.FILE_URI,
sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)
});
// Reposition the popover if the orientation changes.
window.onorientationchange = function() {
var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
cameraPopoverHandle.setPosition(cameraPopoverOptions);
}
CameraPopoverOptions
iOS 전용 매개 변수 iPad의 보관 함 또는 앨범에서 이미지를 선택 하면 앵커 요소 위치와 화살표의 방향으로 popover 지정 하는.
{x: 0, y: 32, 폭: 320, 높이: 480, arrowDir: Camera.PopoverArrowDirection.ARROW_ANY};
CameraPopoverOptions
-
x: x는 popover 앵커는 화면 요소의 픽셀 좌표. (수)
-
y: y 픽셀 좌표는 popover 앵커는 화면 요소입니다. (수)
-
폭: 폭 (픽셀)는 popover 앵커는 화면 요소. (수)
-
높이: 높이 (픽셀)는 popover 앵커는 화면 요소. (수)
-
arrowDir: 방향 화살표는 popover 가리켜야 합니다. 에 정의 된
Camera.PopoverArrowDirection(수)Camera.PopoverArrowDirection = {ARROW_UP: 1, / / iOS UIPopoverArrowDirection 상수 ARROW_DOWN 일치: 2, ARROW_LEFT: 4, ARROW_RIGHT: 8, ARROW_ANY: 15};
참고는 popover의 크기 조정 화살표 방향 및 화면 방향 변경 될 수 있습니다. 앵커 요소 위치를 지정 하는 경우 방향 변경에 대 한 계정에 있는지 확인 합니다.
navigator.camera.cleanup
제거 임시 저장소에서 카메라로 찍은 사진을 중간.
navigator.camera.cleanup( cameraSuccess, cameraError );
설명
제거 중간 전화 후 임시 저장소에 보관 된 이미지 파일 camera.getPicture . 경우에만 적용의 값 Camera.sourceType 와 Camera.PictureSourceType.CAMERA 와 Camera.destinationType 같음Camera.DestinationType.FILE_URI.
지원 되는 플랫폼
- iOS
예를 들어
navigator.camera.cleanup(onSuccess, onFail);
function onSuccess() {
console.log("Camera cleanup success.")
}
function onFail(message) {
alert('Failed because: ' + message);
}