forked from public/cordova-plugin-camera
CB-7700 cordova-plugin-camera documentation translation: cordova-plugin-camera
This commit is contained in:
+68
-68
@@ -39,17 +39,17 @@ Jeśli `Camera.sourceType` jest równe `Camera.PictureSourceType.PHOTOLIBRARY` l
|
||||
|
||||
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.
|
||||
* `String` zawierający obraz zakodowany przy pomocy base64.
|
||||
|
||||
* Jako `String` reprezentujący lokację pliku obrazu w lokalnym magazynie (domyślnie).
|
||||
* `String` reprezentujący lokalizację 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
|
||||
* Przedstawić obraz w tagu `<img>`, jak w przykładzie poniżej
|
||||
|
||||
* Zapisuje dane lokalnie (`LocalStorage`, [Lawnchair][1], etc.)
|
||||
* Zapisać lokalnie dane (`LocalStorage`, [Lawnchair][1], etc.)
|
||||
|
||||
* Wysyła dane na zdalny serwer
|
||||
* Wysłać dane na zdalny serwer
|
||||
|
||||
[1]: http://brianleroux.github.com/lawnchair/
|
||||
|
||||
@@ -57,9 +57,9 @@ Z zakodowanym obrazem lub URI możesz zrobić co zechcesz, na przykład:
|
||||
|
||||
### Obsługiwane platformy
|
||||
|
||||
* Amazon ogień OS
|
||||
* Amazon Fire OS
|
||||
* Android
|
||||
* Jeżyna 10
|
||||
* BlackBerry 10
|
||||
* Przeglądarka
|
||||
* Firefox OS
|
||||
* iOS
|
||||
@@ -78,9 +78,9 @@ Z zakodowanym obrazem lub URI możesz zrobić co zechcesz, na przykład:
|
||||
|
||||
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
|
||||
### Dziwactwa Androida
|
||||
|
||||
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.
|
||||
Android używa Intencji (Intents) do uruchomienia aktywności aparatu i na urządzeniach z małą ilością dostępnej pamięci aktywność Cordova może zostać przerwana. W tym scenariuszu obraz mogą nie być wyświetlane po przywróceniu aktywności Cordova.
|
||||
|
||||
### Quirks przeglądarki
|
||||
|
||||
@@ -92,26 +92,26 @@ Aparat plugin jest obecnie implementowane za pomocą [Działania sieci Web][2].
|
||||
|
||||
[2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
|
||||
|
||||
### iOS dziwactwa
|
||||
### Dziwactwa iOS
|
||||
|
||||
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:
|
||||
Umieszczenie w funkcji zwrotnej wywołania `alert()` w JavaScript może powodować problemy. Aby umożliwić systemowi iOS na całkowite zamknięcie okna wyboru obrazu lub wyskakującego powiadomienia przed wyświetleniem alarmu należy opakować go w `setTimeout()`:
|
||||
|
||||
setTimeout(function() {
|
||||
// do your thing here!
|
||||
}, 0);
|
||||
|
||||
|
||||
### Windows Phone 7 dziwactwa
|
||||
### Dziwactwa Windows Phone 7
|
||||
|
||||
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
|
||||
### Dziwactwa Tizen
|
||||
|
||||
Tizen obsługuje tylko `destinationType` z `Camera.DestinationType.FILE_URI` i `sourceType` z`Camera.PictureSourceType.PHOTOLIBRARY`.
|
||||
Tizen obsługuje tylko parametr `destinationType` jako `Camera.DestinationType.FILE_URI` oraz `sourceType` jako `Camera.PictureSourceType.PHOTOLIBRARY`.
|
||||
|
||||
### Przykład
|
||||
|
||||
Zrób zdjęcie i pobrać go jako kodowane algorytmem base64 obrazu:
|
||||
Zrobienie zdjęcia i pobranie go jako obraz zakodowany base64:
|
||||
|
||||
navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
|
||||
destinationType: Camera.DestinationType.DATA_URL
|
||||
@@ -127,7 +127,7 @@ Zrób zdjęcie i pobrać go jako kodowane algorytmem base64 obrazu:
|
||||
}
|
||||
|
||||
|
||||
Zrób zdjęcie i pobrać lokalizacji pliku obrazu:
|
||||
Zrobienie zdjęcia i pobranie lokacji pliku obrazu:
|
||||
|
||||
navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
|
||||
destinationType: Camera.DestinationType.FILE_URI });
|
||||
@@ -144,7 +144,7 @@ Zrób zdjęcie i pobrać lokalizacji pliku obrazu:
|
||||
|
||||
## CameraOptions
|
||||
|
||||
Opcjonalne parametry, aby dostosować ustawienia aparatu.
|
||||
Opcjonalne parametry dostosowania ustawień aparatu.
|
||||
|
||||
{ quality : 75,
|
||||
destinationType : Camera.DestinationType.DATA_URL,
|
||||
@@ -159,7 +159,7 @@ Opcjonalne parametry, aby dostosować ustawienia aparatu.
|
||||
|
||||
### 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).
|
||||
* **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)*
|
||||
|
||||
@@ -179,7 +179,7 @@ Opcjonalne parametry, aby dostosować ustawienia aparatu.
|
||||
};
|
||||
|
||||
|
||||
* **allowEdit**: umożliwia łatwą edycję obrazu przed zaznaczeniem. *(Wartość logiczna)*
|
||||
* **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)*
|
||||
|
||||
@@ -189,68 +189,68 @@ Opcjonalne parametry, aby dostosować ustawienia aparatu.
|
||||
};
|
||||
|
||||
|
||||
* **targetWidth**: szerokość w pikselach na obraz skali. Musi być używany z **targetHeight**. Współczynnik proporcji pozostaje stała. *(Liczba)*
|
||||
* **targetWidth**: Szerokość w pikselach skalowanego obrazu. Musi być użyte z **targetHeight**. Współczynnik proporcji pozostaje stały. *(Liczba)*
|
||||
|
||||
* **targetHeight**: wysokość w pikselach na obraz skali. Musi być używany z **targetWidth**. Współczynnik proporcji pozostaje stała. *(Liczba)*
|
||||
* **targetHeight**: Wysokość w pikselach skalowanego obrazu. Musi być użyte z **targetWidth**. Współczynnik proporcji pozostaje stały. *(Liczba)*
|
||||
|
||||
* **mediaType**: zestaw typ nośnika, do wyboru. Działa tylko, gdy `PictureSourceType` jest `PHOTOLIBRARY` lub `SAVEDPHOTOALBUM` . Zdefiniowane w `nagivator.camera.MediaType` *(numer)*
|
||||
* **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. DOMYŚLNIE. Will return format specified via DestinationType
|
||||
PICTURE: 0, // umożliwia wybór tylko zdjęcia. 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)*
|
||||
* **correctOrientation**: Obraca obraz aby skorygować orientację urządzenia podczas przechwytywania. *(Boolean)*
|
||||
|
||||
* **saveToPhotoAlbum**: Zapisz obraz do albumu fotograficznego na urządzenie po przechwytywania. *(Wartość logiczna)*
|
||||
* **saveToPhotoAlbum**: Po przechwyceniu zapisuje na urządzeniu obraz w albumie na zdjęcia. *(Boolean)*
|
||||
|
||||
* **popoverOptions**: tylko do iOS opcje, które określają położenie popover w iPad. Zdefiniowane w`CameraPopoverOptions`.
|
||||
* **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
|
||||
BACK : 0, // Używa tylnej kamery
|
||||
FRONT : 1 // Używa przedniej kamery
|
||||
};
|
||||
|
||||
|
||||
### Amazon ogień OS dziwactwa
|
||||
|
||||
* Wszelkie `cameraDirection` wartość wyników w zdjęcie tyłu do kierunku jazdy.
|
||||
* Jakakolwiek wartość w `cameraDirection` skutkuje użyciem tylnej kamery.
|
||||
|
||||
* Ignoruje `allowEdit` parametr.
|
||||
* Parametr `allowEdit` jest ignorowany.
|
||||
|
||||
* `Camera.PictureSourceType.PHOTOLIBRARY`i `Camera.PictureSourceType.SAVEDPHOTOALBUM` wyświetlać ten sam album zdjęć.
|
||||
* Oba parametry `Camera.PictureSourceType.PHOTOLIBRARY` oraz `Camera.PictureSourceType.SAVEDPHOTOALBUM` wyświetlają ten sam album ze zdjęciami.
|
||||
|
||||
### Android dziwactwa
|
||||
### Dziwactwa Androida
|
||||
|
||||
* Wszelkie `cameraDirection` wartość wyników w zdjęcie tyłu do kierunku jazdy.
|
||||
* Jakakolwiek wartość w `cameraDirection` skutkuje użyciem tylnej kamery.
|
||||
|
||||
* Ignoruje `allowEdit` parametr.
|
||||
* Parametr `allowEdit` jest ignorowany.
|
||||
|
||||
* `Camera.PictureSourceType.PHOTOLIBRARY`i `Camera.PictureSourceType.SAVEDPHOTOALBUM` wyświetlać ten sam album zdjęć.
|
||||
* Oba parametry `Camera.PictureSourceType.PHOTOLIBRARY` oraz `Camera.PictureSourceType.SAVEDPHOTOALBUM` wyświetlają ten sam album ze zdjęciami.
|
||||
|
||||
### Jeżyna 10 dziwactwa
|
||||
|
||||
* Ignoruje `quality` parametr.
|
||||
* Parametr `quality` jest ignorowany.
|
||||
|
||||
* Ignoruje `allowEdit` parametr.
|
||||
* Parametr `allowEdit` jest ignorowany.
|
||||
|
||||
* `Camera.MediaType`nie jest obsługiwane.
|
||||
* Nie jest wspierane `Camera.MediaType`.
|
||||
|
||||
* Ignoruje `correctOrientation` parametr.
|
||||
* Parametr `correctOrientation` jest ignorowany.
|
||||
|
||||
* Ignoruje `cameraDirection` parametr.
|
||||
* Parametr `cameraDirection` jest ignorowany.
|
||||
|
||||
### Firefox OS dziwactwa
|
||||
|
||||
* Ignoruje `quality` parametr.
|
||||
* Parametr `quality` jest ignorowany.
|
||||
|
||||
* `Camera.DestinationType`jest ignorowane i jest równa `1` (plik obrazu URI)
|
||||
|
||||
* Ignoruje `allowEdit` parametr.
|
||||
* Parametr `allowEdit` jest ignorowany.
|
||||
|
||||
* Ignoruje `PictureSourceType` parametr (użytkownik wybiera go w oknie dialogowym)
|
||||
|
||||
@@ -258,31 +258,31 @@ Opcjonalne parametry, aby dostosować ustawienia aparatu.
|
||||
|
||||
* Ignoruje `targetWidth` i`targetHeight`
|
||||
|
||||
* `Camera.MediaType`nie jest obsługiwane.
|
||||
* Nie jest wspierane `Camera.MediaType`.
|
||||
|
||||
* Ignoruje `correctOrientation` parametr.
|
||||
* Parametr `correctOrientation` jest ignorowany.
|
||||
|
||||
* Ignoruje `cameraDirection` parametr.
|
||||
* Parametr `cameraDirection` jest ignorowany.
|
||||
|
||||
### iOS dziwactwa
|
||||
### Dziwactwa iOS
|
||||
|
||||
* Zestaw `quality` poniżej 50 do uniknięcia błędy pamięci na niektóre urządzenia.
|
||||
* 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.
|
||||
|
||||
### Osobliwości Tizen
|
||||
### Dziwactwa Tizen
|
||||
|
||||
* opcje nie są obsługiwane
|
||||
|
||||
* zawsze zwraca identyfikator URI pliku
|
||||
* zawsze zwraca FILE URI
|
||||
|
||||
### Windows Phone 7 i 8 dziwactwa
|
||||
|
||||
* Ignoruje `allowEdit` parametr.
|
||||
* Parametr `allowEdit` jest ignorowany.
|
||||
|
||||
* Ignoruje `correctOrientation` parametr.
|
||||
* Parametr `correctOrientation` jest ignorowany.
|
||||
|
||||
* Ignoruje `cameraDirection` parametr.
|
||||
* 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][3]
|
||||
|
||||
@@ -292,7 +292,7 @@ Opcjonalne parametry, aby dostosować ustawienia aparatu.
|
||||
|
||||
## CameraError
|
||||
|
||||
funkcja wywołania zwrotnego PrzyBłędzie, która zawiera komunikat o błędzie.
|
||||
Funkcja zwrotna onError, która zawiera komunikat o błędzie.
|
||||
|
||||
function(message) {
|
||||
// Show a helpful message
|
||||
@@ -301,11 +301,11 @@ funkcja wywołania zwrotnego PrzyBłędzie, która zawiera komunikat o błędzie
|
||||
|
||||
### Parametry
|
||||
|
||||
* **wiadomość**: wiadomość jest świadczone przez urządzenie w kodzie macierzystym. *(String)*
|
||||
* **message**: Natywny kod komunikatu zapewniany przez urządzenie. *(Ciąg znaków)*
|
||||
|
||||
## cameraSuccess
|
||||
|
||||
onSuccess funkcji wywołania zwrotnego, który dostarcza dane obrazu.
|
||||
Funkcja zwrotna onSuccess, która dostarcza dane obrazu.
|
||||
|
||||
function(imageData) {
|
||||
// Do something with the image
|
||||
@@ -314,7 +314,7 @@ onSuccess funkcji wywołania zwrotnego, który dostarcza dane obrazu.
|
||||
|
||||
### Parametry
|
||||
|
||||
* **imageData**: kodowanie Base64 danych obrazu, *lub* plik obrazu URI, w zależności od `cameraOptions` w życie. *(String)*
|
||||
* **imageData**: Dane obrazu kodowane przy pomocy Base64 *lub* URI pliku obrazu, w zależności od użycia `cameraOptions`. *(Ciąg znaków)*
|
||||
|
||||
### Przykład
|
||||
|
||||
@@ -332,7 +332,7 @@ Uchwyt do okna dialogowego popover, stworzony przez`navigator.camera.getPicture`
|
||||
|
||||
### Metody
|
||||
|
||||
* **setPosition**: Ustaw pozycję popover.
|
||||
* **setPosition**: Ustawia pozycję wyskakującego okna.
|
||||
|
||||
### Obsługiwane platformy
|
||||
|
||||
@@ -340,11 +340,11 @@ Uchwyt do okna dialogowego popover, stworzony przez`navigator.camera.getPicture`
|
||||
|
||||
### setPosition
|
||||
|
||||
Ustaw pozycję popover.
|
||||
Ustawia pozycję wyskakującego okna.
|
||||
|
||||
**Parametry**:
|
||||
|
||||
* `cameraPopoverOptions`: `CameraPopoverOptions` , określ nowe położenie
|
||||
* `cameraPopoverOptions`: `CameraPopoverOptions`, która określa nową pozycję
|
||||
|
||||
### Przykład
|
||||
|
||||
@@ -363,7 +363,7 @@ Ustaw pozycję popover.
|
||||
|
||||
## 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.
|
||||
Parametry dotyczące tylko platformy iOS, które określają pozycję zakotwiczenia elementu oraz kierunek strzałki wyskakującego okna podczas wybierania obrazów z biblioteki lub albumu iPada.
|
||||
|
||||
{ x : 0,
|
||||
y : 32,
|
||||
@@ -375,15 +375,15 @@ tylko do iOS parametrami, które określić kotwicy element lokalizacji i strza
|
||||
|
||||
### CameraPopoverOptions
|
||||
|
||||
* **x**: x współrzędnych pikseli ekran element na którym kotwica popover. *(Liczba)*
|
||||
* **x**: współrzędna piksela x elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
|
||||
|
||||
* **y**: Współrzędna y pikseli ekran element na którym kotwica popover. *(Liczba)*
|
||||
* **y**: współrzędna piksela y elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
|
||||
|
||||
* **szerokość**: szerokość w pikselach, ekran element na którym kotwica popover. *(Liczba)*
|
||||
* **width**: szerokość w pikselach elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
|
||||
|
||||
* **wysokość**: wysokość w pikselach elementów ekranu na którym kotwica popover. *(Liczba)*
|
||||
* **height**: wysokość w pikselach elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
|
||||
|
||||
* **arrowDir**: kierunek strzałki na popover powinien wskazywać. Zdefiniowane w `Camera.PopoverArrowDirection` *(numer)*
|
||||
* **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
|
||||
@@ -394,18 +394,18 @@ tylko do iOS parametrami, które określić kotwicy element lokalizacji i strza
|
||||
};
|
||||
|
||||
|
||||
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.
|
||||
Pamiętaj, że wielkość wyskakującego okna może ulec zmianie by dostosować się do kierunku strzałki oraz orientacji ekranu. Upewnij się co do zmiany orientacji podczas określania położenia zakotwiczenia elementu.
|
||||
|
||||
## Navigator.Camera.CleanUp
|
||||
|
||||
Usuwa pośrednie zdjęcia zrobione przez aparat z czasowego składowania.
|
||||
Usuwa pośrednie zdjęcia zrobione przez aparat z tymczasowego magazynu.
|
||||
|
||||
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ówna`Camera.DestinationType.FILE_URI`.
|
||||
Usuwa pośrednie pliki graficzne, które po wywołaniu `camera.getPicture` są przechowywane w tymczasowym magazynie. Ma zastosowanie tylko, gdy wartość `Camera.sourceType` jest równa `Camera.PictureSourceType.CAMERA` i `Camera.destinationType` jest równa `Camera.DestinationType.FILE_URI`.
|
||||
|
||||
### Obsługiwane platformy
|
||||
|
||||
|
||||
Reference in New Issue
Block a user