cordova-plugin-camera/doc/pl/index.md

org.apache.cordova.camera

Wtyczka dostarcza API do robienia zdjęć i wybór zdjęć z biblioteki obrazu systemu.

cordova plugin add org.apache.cordova.camera

navigator.camera.getPicture

Pobiera zdjęcia za pomocą aparatu lub z galerii zdjęć w urządzeniu. Obraz jest przekazywany do funkcji zwrotnej success jako String kodowany za pomocą base64 lub jako URI do pliku. Sama metoda zwraca obiekt CameraPopoverHandle, który może służyć do zmiany położenia wyskakującego okna wyboru pliku.

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

Opis

Funkcja camera.getPicture otwiera na urządzeniu domyślną aplikację aparatu, która pozwala użytkownikowi zrobić zdjęcie. To zachowanie występuje domyślnie, gdy Camera.sourceType jest równe Camera.PictureSourceType.CAMERA. Gdy użytkownik wykona zdjęcie, aplikacja aparatu zakończy działanie i nastąpi powrót do głównej aplikacji.

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łana do funkcji zwrotnej cameraSuccess w jednym z następujących formatów, w zależności od określonego parametru cameraOptions:

• Jako String zawierający obraz zakodowany przy użyciu base64.

• Jako String reprezentujący lokację pliku obrazu w lokalnym magazynie (domyślnie).

Z zakodowanym obrazem lub URI możesz zrobić co zechcesz, na przykład:

• Przedstawia obraz w tagu <img>, jak w przykładzie poniżej

• Zapisuje dane lokalnie (LocalStorage, Lawnchair, etc.)

• Wysyła dane na zdalny serwer

Uwaga: zdjęcie rozdzielczości na nowsze urządzenia jest bardzo dobry. Zdjęcia wybrane z galerii urządzenia nie są skalowane do niższej jakości, nawet jeśli określono parametr quality. Aby uniknąć typowych problemów z pamięcią lepiej ustawićCamera.destinationType na FILE_URI niż DATA_URL.

Obsługiwane platformy

• Amazon ogień OS
• Android
• Jeżyna 10
• Przeglądarka
• Firefox OS
• iOS
• Tizen
• Windows Phone 7 i 8
• Windows 8

Preferencje (iOS)

• 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 dziwactwa

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 takim scenariuszu obrazy mogą nie być wyświetlane po przywróceniu aktywności Cordovy.

Android dziwactwa

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.

Quirks przeglądarki

Może zwracać tylko zdjęcia jako obraz w formacie algorytmem base64.

Firefox OS dziwactwa

Aparat plugin jest obecnie implementowane za pomocą Działania sieci Web.

iOS dziwactwa

Tym JavaScript alert() w jednej z wywołania zwrotnego funkcji może powodować problemy. Owinąć alert w setTimeout() umożliwia wybór obrazu iOS lub popover całkowicie zamknąć zanim wyświetli alert:

setTimeout(function() {
    // do your thing here!
}, 0);

Windows Phone 7 dziwactwa

Wywoływanie aparat native aplikacji, podczas gdy urządzenie jest podłączone przez Zune nie działa i powoduje błąd wywołania zwrotnego.

Osobliwości Tizen

Tizen obsługuje tylko destinationType z Camera.DestinationType.FILE_URI i sourceType zCamera.PictureSourceType.PHOTOLIBRARY.

Przykład

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);
}

CameraOptions

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 };

Opcje

• jakość: jakość zapisany obraz, wyrażona jako zakres od 0 do 100, gdzie 100 jest zazwyczaj pełnej rozdzielczości bez utraty z kompresji plików. Wartością domyślną jest 50. (Liczba) (Należy zauważyć, że informacje o rozdzielczość kamery jest niedostępny).

• 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: umożliwia łatwą edycję obrazu przed zaznaczeniem. (Wartość logiczna)

• 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 na obraz skali. Musi być używany z targetHeight. Współczynnik proporcji pozostaje stała. (Liczba)

• targetHeight: wysokość w pikselach na obraz skali. Musi być używany z targetWidth. Współczynnik proporcji pozostaje stała. (Liczba)

• mediaType: zestaw typ nośnika, do wyboru. Działa tylko, gdy PictureSourceType jest PHOTOLIBRARY lub SAVEDPHOTOALBUM . Zdefiniowane w nagivator.camera.MediaType (numer)

  Camera.MediaType = {
      PICTURE: 0,    // allow selection of still pictures only. DOMYŚLNIE. 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: obracanie obrazu dla orientacji urządzenia podczas przechwytywania. (Wartość logiczna)

• saveToPhotoAlbum: Zapisz obraz do albumu fotograficznego na urządzenie po przechwytywania. (Wartość logiczna)

• popoverOptions: tylko do iOS opcje, które określają położenie popover w iPad. Zdefiniowane wCameraPopoverOptions.

• 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
  };
  

Amazon ogień OS dziwactwa

• Wszelkie cameraDirection wartość wyników w zdjęcie tyłu do kierunku jazdy.

• Ignoruje allowEdit parametr.

• Camera.PictureSourceType.PHOTOLIBRARYi Camera.PictureSourceType.SAVEDPHOTOALBUM wyświetlać ten sam album zdjęć.

Android dziwactwa

• Wszelkie cameraDirection wartość wyników w zdjęcie tyłu do kierunku jazdy.

• Ignoruje allowEdit parametr.

• Camera.PictureSourceType.PHOTOLIBRARYi Camera.PictureSourceType.SAVEDPHOTOALBUM wyświetlać ten sam album zdjęć.

Jeżyna 10 dziwactwa

• Ignoruje quality parametr.

• Ignoruje allowEdit parametr.

• Camera.MediaTypenie jest obsługiwane.

• Ignoruje correctOrientation parametr.

• Ignoruje cameraDirection parametr.

Firefox OS dziwactwa

• Ignoruje quality parametr.

• Camera.DestinationTypejest ignorowane i jest równa 1 (plik obrazu URI)

• Ignoruje allowEdit parametr.

• Ignoruje PictureSourceType parametr (użytkownik wybiera go w oknie dialogowym)

• IgnorujeencodingType

• Ignoruje targetWidth itargetHeight

• Camera.MediaTypenie jest obsługiwane.

• Ignoruje correctOrientation parametr.

• Ignoruje cameraDirection parametr.

iOS dziwactwa

• Zestaw quality poniżej 50 do uniknięcia błędy pamięci na niektóre urządzenia.

• Podczas korzystania z destinationType.FILE_URI , zdjęcia są zapisywane w katalogu tymczasowego stosowania. Zawartość katalogu tymczasowego stosowania jest usuwany po zakończeniu aplikacji.

Osobliwości Tizen

• opcje nie są obsługiwane

• zawsze zwraca identyfikator URI pliku

Windows Phone 7 i 8 dziwactwa

• Ignoruje allowEdit parametr.

• Ignoruje correctOrientation parametr.

• Ignoruje cameraDirection parametr.

• 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.

CameraError

funkcja wywołania zwrotnego PrzyBłędzie, która zawiera komunikat o błędzie.

function(message) {
    // Show a helpful message
}

Parametry

• wiadomość: wiadomość jest świadczone przez urządzenie w kodzie macierzystym. (String)

cameraSuccess

onSuccess funkcji wywołania zwrotnego, który dostarcza dane obrazu.

function(imageData) {
    // Do something with the image
}

Parametry

• imageData: kodowanie Base64 danych obrazu, lub plik obrazu URI, w zależności od cameraOptions w życie. (String)

Przykład

// Show image
//
function cameraCallback(imageData) {
    var image = document.getElementById('myImage');
    image.src = "data:image/jpeg;base64," + imageData;
}

CameraPopoverHandle

Uchwyt do okna dialogowego popover, stworzony przeznavigator.camera.getPicture.

Metody

• setPosition: Ustaw pozycję popover.

Obsługiwane platformy

• iOS

setPosition

Ustaw pozycję popover.

Parametry:

• cameraPopoverOptions: CameraPopoverOptions , określ nowe położenie

Przykład

 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

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
};

CameraPopoverOptions

• x: x współrzędnych pikseli ekran element na którym kotwica popover. (Liczba)

• y: Współrzędna y pikseli ekran element na którym kotwica popover. (Liczba)

• szerokość: szerokość w pikselach, ekran element na którym kotwica popover. (Liczba)

• wysokość: wysokość w pikselach elementów ekranu na którym kotwica popover. (Liczba)

• arrowDir: kierunek strzałki na popover powinien wskazywać. Zdefiniowane w Camera.PopoverArrowDirection (numer)

      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.

Navigator.Camera.CleanUp

Usuwa pośrednie zdjęcia zrobione przez aparat z czasowego składowania.

navigator.camera.cleanup( cameraSuccess, cameraError );

Opis

Usuwa pośrednie plików obrazów, które są przechowywane w pamięci tymczasowej po camera.getPicture . Stosuje się tylko wtedy, gdy wartość Camera.sourceType jest równa Camera.PictureSourceType.CAMERA i Camera.destinationType jest równaCamera.DestinationType.FILE_URI.

Obsługiwane platformy

• iOS

Przykład

navigator.camera.cleanup(onSuccess, onFail);

function onSuccess() {
    console.log("Camera cleanup success.")
}

function onFail(message) {
    alert('Failed because: ' + message);
}