Ten plugin definiuje obiekt globalny navigator.camera, który dostarcza API do robienia zdjęć i wybór zdjęć z biblioteki obrazów systemu.
Mimo, że obiekt jest dołączony do globalnego zakresu navigator, to nie dostępne dopiero po zdarzeniu deviceready.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.camera);
}
cordova plugin add cordova-plugin-camera
Ma zdjęcia za pomocą aparatu, lub pobiera zdjęcia z urządzenia Galeria zdjęć. Obraz jest przekazywany do wywołania zwrotnego sukces jako kodowane algorytmem base64 ciąg, lub identyfikator URI dla pliku obrazu. Sama metoda zwraca obiekt CameraPopoverHandle, który może służyć do zmiany położenia pliku wyboru popover.
navigator.camera.getPicture(cameraSuccess, cameraError, cameraOptions);
Funkcja camera.getPicture otwiera urządzenia domyślnej aplikacji aparat fotograficzny ów pozwala użytkownik wobec chwycić zębami kino. To zachowanie występuje domyślnie, gdy Camera.sourceType jest równa Camera.PictureSourceType.CAMERA. Gdy użytkownik zaskoczy zdjęcie, ten aparat fotograficzny applicationâ zamyka i aplikacji jest przywracany.
Jeśli Camera.sourceType jest równe Camera.PictureSourceType.PHOTOLIBRARY lub Camera.PictureSourceType.SAVEDPHOTOALBUM, wtedy zostanie wyświetlone okno dialogowe pozwalające użytkownikowi na wybór istniejącego obrazu. Funkcja camera.getPicture zwraca obiekt CameraPopoverHandle, który obsługuje zmianę położenia okna wyboru obrazu, np. po zmianie orientacji urządzenia.
Zwracana wartość jest wysyłany do funkcji wywołania zwrotnego cameraSuccess, w jednym z następujących formatów, w zależności od określonego cameraOptions:
String zawierający obraz zakodowany przy pomocy base64.
String reprezentujący lokalizację pliku obrazu w lokalnym magazynie (domyślnie).
Może rób, co chcesz z zakodowany obraz lub identyfikatora URI, na przykład:
Przedstawić obraz w tagu <img>, jak w przykładzie poniżej
Zapisać lokalnie dane (LocalStorage, Lawnchair, etc.)
Wysłać dane na zdalny serwer
Uwaga: zdjęcie rozdzielczości na nowsze urządzenia jest bardzo dobry. Zdjęcia wybrane z galerii urządzenia są nie przeskalowanych w dół do niższej jakości, nawet jeśli określono parametr quality. Aby uniknąć typowych problemów z pamięci, zestaw Camera.destinationType FILE_URI zamiast DATA_URL.
Zrób zdjęcie i pobrać go jako kodowane algorytmem base64 obrazu:
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);
}
Zrób zdjęcie i pobrać lokalizacji pliku obrazu:
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);
}
CameraUsesGeolocation (boolean, wartość domyślna to false). Do przechwytywania JPEG, zestaw do true, aby uzyskać danych geolokalizacyjnych w nagłówku EXIF. To spowoduje wniosek o geolokalizacji uprawnienia, jeśli zestaw na wartość true.
<preference name="CameraUsesGeolocation" value="false" />
Amazon ogień OS używa intencje do rozpoczęcia działalności aparatu na urządzenie do przechwytywania obrazów, i na telefony z pamięci, Cordova aktywność może zostać zabity. W tym scenariuszu obraz mogą nie być wyświetlane po przywróceniu aktywności cordova.
Android używa intencje do rozpoczęcia działalności aparatu na urządzenie do przechwytywania obrazów, i na telefony z pamięci, Cordova aktywność może zostać zabity. W tym scenariuszu obraz mogą nie być wyświetlane po przywróceniu aktywności Cordova.
Może zwracać tylko zdjęcia jako obraz w formacie algorytmem base64.
Aparat plugin jest obecnie implementowane za pomocą Działania sieci Web.
W jednej z funkcji wywołania zwrotnego w tym JavaScript alert() może powodować problemy. Owinąć w setTimeout() umożliwia wybór obrazu iOS lub popover całkowicie zamknąć zanim wyświetli alert alert:
setTimeout(function() {
// do your thing here!
}, 0);
Wywoływanie aparat native aplikacji, podczas gdy urządzenie jest podłączone przez Zune nie działa i powoduje błąd wywołania zwrotnego.
Tizen obsługuje tylko destinationType z Camera.DestinationType.FILE_URI i sourceType z Camera.PictureSourceType.PHOTOLIBRARY.
Opcjonalne parametry, aby dostosować ustawienia aparatu.
{ quality : 75,
destinationType : Camera.DestinationType.DATA_URL,
sourceType : Camera.PictureSourceType.CAMERA,
allowEdit : true,
encodingType: Camera.EncodingType.JPEG,
targetWidth: 100,
targetHeight: 100,
popoverOptions: CameraPopoverOptions,
saveToPhotoAlbum: false };
quality: Jakość zapisywanego obrazu, wyrażona w przedziale 0-100, gdzie 100 zazwyczaj jest maksymalną rozdzielczością bez strat w czasie kompresji pliku. Wartością domyślną jest 50. (Liczba) (Pamiętaj, że informacja o rozdzielczości aparatu jest niedostępna.)
destinationType: Wybierz format zwracanej wartości. Wartością domyślną jest FILE_URI. Zdefiniowane w navigator.camera.DestinationType (numer)
Camera.DestinationType = {
DATA_URL : 0, // Return image as base64-encoded string
FILE_URI : 1, // Return image file URI
NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
};
sourceType: Ustaw źródło obrazu. Wartością domyślną jest aparat fotograficzny. Zdefiniowane w navigator.camera.PictureSourceType (numer)
Camera.PictureSourceType = {
PHOTOLIBRARY : 0,
CAMERA : 1,
SAVEDPHOTOALBUM : 2
};
allowEdit: Pozwala na prostą edycję obrazu przed zaznaczeniem. (Boolean)
encodingType: Wybierz plik obrazu zwracany jest kodowanie. Domyślnie jest JPEG. Zdefiniowane w navigator.camera.EncodingType (numer)
Camera.EncodingType = {
JPEG : 0, // Return JPEG encoded image
PNG : 1 // Return PNG encoded image
};
targetWidth: Szerokość w pikselach skalowanego obrazu. Musi być użyte z targetHeight. Współczynnik proporcji pozostaje stały. (Liczba)
targetHeight: Wysokość w pikselach skalowanego obrazu. Musi być użyte z targetWidth. Współczynnik proporcji pozostaje stały. (Liczba)
mediaType: Ustawia typ nośnika, z którego będzie wybrany. Działa tylko wtedy, gdy PictureSourceType jest PHOTOLIBRARY lub SAVEDPHOTOALBUM. Zdefiniowane w nagivator.camera.MediaType (Liczba)
Camera.MediaType = {
PICTURE: 0, // allow selection of still pictures only. DEFAULT. 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: Obraca obraz aby skorygować orientację urządzenia podczas przechwytywania. (Boolean)
saveToPhotoAlbum: Po przechwyceniu zapisuje na urządzeniu obraz w albumie na zdjęcia. (Boolean)
popoverOptions: Opcja tylko dla platformy iOS, która określa położenie wyskakującego okna na iPadzie. Zdefiniowane w CameraPopoverOptions.
cameraDirection: Wybierz aparat do korzystania (lub z powrotem przodem). Wartością domyślną jest z powrotem. Zdefiniowane w navigator.camera.Direction (numer)
Camera.Direction = {
BACK : 0, // Use the back-facing camera
FRONT : 1 // Use the front-facing camera
};
Jakakolwiek wartość w cameraDirection skutkuje użyciem tylnej kamery.
Parametr allowEdit jest ignorowany.
Oba parametry Camera.PictureSourceType.PHOTOLIBRARY oraz Camera.PictureSourceType.SAVEDPHOTOALBUM wyświetlają ten sam album ze zdjęciami.
Jakakolwiek wartość w cameraDirection skutkuje użyciem tylnej kamery.
Android również używa aktywność upraw dla allowEdit, choć upraw powinien pracować i faktycznie przejść przycięte zdjęcie Wróć do Cordova, ten tylko jeden który działa konsekwentnie jest ten, wiązany z aplikacji Google Plus zdjęcia. Inne rośliny mogą nie działać.
Oba parametry Camera.PictureSourceType.PHOTOLIBRARY oraz Camera.PictureSourceType.SAVEDPHOTOALBUM wyświetlają ten sam album ze zdjęciami.
Parametr quality jest ignorowany.
Parametr allowEdit jest ignorowany.
Nie jest wspierane Camera.MediaType.
Parametr correctOrientation jest ignorowany.
Parametr cameraDirection jest ignorowany.
Parametr quality jest ignorowany.
Camera.DestinationTypejest ignorowane i jest równa 1 (plik obrazu URI)
Parametr allowEdit jest ignorowany.
Ignoruje PictureSourceType parametr (użytkownik wybiera go w oknie dialogowym)
IgnorujeencodingType
Ignoruje targetWidth itargetHeight
Nie jest wspierane Camera.MediaType.
Parametr correctOrientation jest ignorowany.
Parametr cameraDirection jest ignorowany.
Ustaw quality poniżej 50 aby uniknąć błędów pamięci na niektórych urządzeniach.
Podczas korzystania z destinationType.FILE_URI , zdjęcia są zapisywane w katalogu tymczasowego stosowania. Zawartość katalogu tymczasowego stosowania jest usuwany po zakończeniu aplikacji.
opcje nie są obsługiwane
zawsze zwraca FILE URI
Parametr allowEdit jest ignorowany.
Parametr correctOrientation jest ignorowany.
Parametr cameraDirection jest ignorowany.
Ignoruje saveToPhotoAlbum parametr. Ważne: Wszystkie zdjęcia zrobione aparatem wp7/8 cordova API są zawsze kopiowane do telefonu w kamerze. W zależności od ustawień użytkownika może to też oznaczać że obraz jest automatycznie przesłane do ich OneDrive. Potencjalnie może to oznaczać, że obraz jest dostępne dla szerszego grona odbiorców niż Twoja aplikacja przeznaczona. Jeśli ten bloker aplikacji, trzeba będzie wdrożenie CameraCaptureTask, opisane na msdn: http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx można także komentarz lub górę głosowanie powiązanych kwestii w śledzenia błędów
Ignoruje mediaType Właściwość cameraOptions jako SDK Windows Phone nie umożliwiają wybór filmów z PHOTOLIBRARY.
funkcja wywołania zwrotnego PrzyBłędzie, która zawiera komunikat o błędzie.
function(message) {
// Show a helpful message
}
onSuccess funkcji wywołania zwrotnego, który dostarcza dane obrazu.
function(imageData) {
// Do something with the image
}
cameraOptions. (Ciąg znaków)// Show image
//
function cameraCallback(imageData) {
var image = document.getElementById('myImage');
image.src = "data:image/jpeg;base64," + imageData;
}
Uchwyt do okna dialogowego popover, stworzony przez navigator.camera.getPicture.
CameraPopoverOptions that specify the new position.
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);
}
tylko do iOS parametrami, które określić kotwicy element lokalizacji i strzałka kierunku popover, przy wyborze zdjęć z iPad biblioteki lub album.
{ x : 0,
y : 32,
width : 320,
height : 480,
arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
};
x: współrzędna piksela x elementu ekranu, na którym zakotwiczone jest wyskakujące okno. (Liczba)
y: współrzędna piksela y elementu ekranu, na którym zakotwiczone jest wyskakujące okno. (Liczba)
width: szerokość w pikselach elementu ekranu, na którym zakotwiczone jest wyskakujące okno. (Liczba)
height: wysokość w pikselach elementu ekranu, na którym zakotwiczone jest wyskakujące okno. (Liczba)
arrowDir: Kierunek, który powinna wskazywać strzałka na wyskakującym oknie. Zdefiniowane w Camera.PopoverArrowDirection (Liczba)
Camera.PopoverArrowDirection = {
ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
ARROW_DOWN : 2,
ARROW_LEFT : 4,
ARROW_RIGHT : 8,
ARROW_ANY : 15
};
Należy pamiętać, że rozmiar popover może zmienić aby zmienić kierunek strzałki i orientacji ekranu. Upewnij się uwzględnić zmiany orientacji podczas określania położenia elementu kotwicy.
Usuwa pośrednie zdjęcia zrobione przez aparat z czasowego składowania.
navigator.camera.cleanup( cameraSuccess, cameraError );
Usuwa pliki obrazów pośrednich, które są przechowywane w pamięci tymczasowej po wywołaniu camera.getPicture. Ma zastosowanie tylko, gdy wartość Camera.sourceType jest równa Camera.PictureSourceType.CAMERA i Camera.destinationType jest równa Camera.DestinationType.FILE_URI.
navigator.camera.cleanup(onSuccess, onFail);
function onSuccess() {
console.log("Camera cleanup success.")
}
function onFail(message) {
alert('Failed because: ' + message);
}