openEventsPlatformApp/plugins/cordova-plugin-camera/doc/pl/index.md
plugins/cordova-plugin-camera/doc/pl/index.mdRaw
1<!---
2 Licensed to the Apache Software Foundation (ASF) under one
3 or more contributor license agreements. See the NOTICE file
4 distributed with this work for additional information
5 regarding copyright ownership. The ASF licenses this file
6 to you under the Apache License, Version 2.0 (the
7 "License"); you may not use this file except in compliance
8 with the License. You may obtain a copy of the License at
9
10 http://www.apache.org/licenses/LICENSE-2.0
11
12 Unless required by applicable law or agreed to in writing,
13 software distributed under the License is distributed on an
14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 KIND, either express or implied. See the License for the
16 specific language governing permissions and limitations
17 under the License.
18-->
19
20# cordova-plugin-camera
21
22Ten plugin definiuje obiekt globalny `navigator.camera`, który dostarcza API do robienia zdjęć i wybór zdjęć z biblioteki obrazów systemu.
23
24Mimo, że obiekt jest dołączony do globalnego zakresu `navigator`, to nie dostępne dopiero po zdarzeniu `deviceready`.
25
26 document.addEventListener("deviceready", onDeviceReady, false);
27 function onDeviceReady() {
28 console.log(navigator.camera);
29 }
30
31
32## Instalacja
33
34 cordova plugin add cordova-plugin-camera
35
36
37## navigator.camera.getPicture
38
39Ma 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.
40
41 navigator.camera.getPicture( cameraSuccess, cameraError, cameraOptions );
42
43
44### Opis
45
46Funkcja `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.
47
48Jeś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.
49
50Zwracana 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`:
51
52* `String` zawierający obraz zakodowany przy pomocy base64.
53
54* `String` reprezentujący lokalizację pliku obrazu w lokalnym magazynie (domyślnie).
55
56Może rób, co chcesz z zakodowany obraz lub identyfikatora URI, na przykład:
57
58* Przedstawić obraz w tagu `<img>`, jak w przykładzie poniżej
59
60* Zapisać lokalnie dane (`LocalStorage`, [Lawnchair][1], etc.)
61
62* Wysłać dane na zdalny serwer
63
64 [1]: http://brianleroux.github.com/lawnchair/
65
66**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`.
67
68### Obsługiwane platformy
69
70* Amazon Fire OS
71* Android
72* BlackBerry 10
73* Przeglądarka
74* Firefox OS
75* iOS
76* Tizen
77* Windows Phone 7 i 8
78* Windows 8
79
80### Preferencje (iOS)
81
82* **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.
83
84 <preference name="CameraUsesGeolocation" value="false" />
85
86
87### Amazon ogień OS dziwactwa
88
89Amazon 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.
90
91### Dziwactwa Androida
92
93Android 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.
94
95### Quirks przeglądarki
96
97Może zwracać tylko zdjęcia jako obraz w formacie algorytmem base64.
98
99### Firefox OS dziwactwa
100
101Aparat plugin jest obecnie implementowane za pomocą [Działania sieci Web][2].
102
103 [2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
104
105### Dziwactwa iOS
106
107W 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:
108
109 setTimeout(function() {
110 // do your thing here!
111 }, 0);
112
113
114### Dziwactwa Windows Phone 7
115
116Wywoływanie aparat native aplikacji, podczas gdy urządzenie jest podłączone przez Zune nie działa i powoduje błąd wywołania zwrotnego.
117
118### Dziwactwa Tizen
119
120Tizen obsługuje tylko `destinationType` z `Camera.DestinationType.FILE_URI` i `sourceType` z `Camera.PictureSourceType.PHOTOLIBRARY`.
121
122### Przykład
123
124Zrób zdjęcie i pobrać go jako kodowane algorytmem base64 obrazu:
125
126 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
127 destinationType: Camera.DestinationType.DATA_URL
128 });
129
130 function onSuccess(imageData) {
131 var image = document.getElementById('myImage');
132 image.src = "data:image/jpeg;base64," + imageData;
133 }
134
135 function onFail(message) {
136 alert('Failed because: ' + message);
137 }
138
139
140Zrób zdjęcie i pobrać lokalizacji pliku obrazu:
141
142 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
143 destinationType: Camera.DestinationType.FILE_URI });
144
145 function onSuccess(imageURI) {
146 var image = document.getElementById('myImage');
147 image.src = imageURI;
148 }
149
150 function onFail(message) {
151 alert('Failed because: ' + message);
152 }
153
154
155## CameraOptions
156
157Opcjonalne parametry, aby dostosować ustawienia aparatu.
158
159 { quality : 75,
160 destinationType : Camera.DestinationType.DATA_URL,
161 sourceType : Camera.PictureSourceType.CAMERA,
162 allowEdit : true,
163 encodingType: Camera.EncodingType.JPEG,
164 targetWidth: 100,
165 targetHeight: 100,
166 popoverOptions: CameraPopoverOptions,
167 saveToPhotoAlbum: false };
168
169
170### Opcje
171
172* **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.)
173
174* **destinationType**: Wybierz format zwracanej wartości. Wartością domyślną jest FILE_URI. Zdefiniowane w `navigator.camera.DestinationType` *(numer)*
175
176 Camera.DestinationType = {
177 DATA_URL : 0, // Return image as base64-encoded string
178 FILE_URI : 1, // Return image file URI
179 NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
180 };
181
182
183* **sourceType**: Ustaw źródło obrazu. Wartością domyślną jest aparat fotograficzny. Zdefiniowane w `navigator.camera.PictureSourceType` *(numer)*
184
185 Camera.PictureSourceType = {
186 PHOTOLIBRARY : 0,
187 CAMERA : 1,
188 SAVEDPHOTOALBUM : 2
189 };
190
191
192* **allowEdit**: Pozwala na prostą edycję obrazu przed zaznaczeniem. *(Boolean)*
193
194* **encodingType**: Wybierz plik obrazu zwracany jest kodowanie. Domyślnie jest JPEG. Zdefiniowane w `navigator.camera.EncodingType` *(numer)*
195
196 Camera.EncodingType = {
197 JPEG : 0, // Return JPEG encoded image
198 PNG : 1 // Return PNG encoded image
199 };
200
201
202* **targetWidth**: Szerokość w pikselach skalowanego obrazu. Musi być użyte z **targetHeight**. Współczynnik proporcji pozostaje stały. *(Liczba)*
203
204* **targetHeight**: Wysokość w pikselach skalowanego obrazu. Musi być użyte z **targetWidth**. Współczynnik proporcji pozostaje stały. *(Liczba)*
205
206* **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)*
207
208 Camera.MediaType = {
209 PICTURE: 0, // allow selection of still pictures only. DEFAULT. Will return format specified via DestinationType
210 VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI
211 ALLMEDIA : 2 // allow selection from all media types
212 };
213
214
215* **correctOrientation**: Obraca obraz aby skorygować orientację urządzenia podczas przechwytywania. *(Boolean)*
216
217* **saveToPhotoAlbum**: Po przechwyceniu zapisuje na urządzeniu obraz w albumie na zdjęcia. *(Boolean)*
218
219* **popoverOptions**: Opcja tylko dla platformy iOS, która określa położenie wyskakującego okna na iPadzie. Zdefiniowane w `CameraPopoverOptions`.
220
221* **cameraDirection**: Wybierz aparat do korzystania (lub z powrotem przodem). Wartością domyślną jest z powrotem. Zdefiniowane w `navigator.camera.Direction` *(numer)*
222
223 Camera.Direction = {
224 BACK : 0, // Use the back-facing camera
225 FRONT : 1 // Use the front-facing camera
226 };
227
228
229### Amazon ogień OS dziwactwa
230
231* Jakakolwiek wartość w `cameraDirection` skutkuje użyciem tylnej kamery.
232
233* Parametr `allowEdit` jest ignorowany.
234
235* Oba parametry `Camera.PictureSourceType.PHOTOLIBRARY` oraz `Camera.PictureSourceType.SAVEDPHOTOALBUM` wyświetlają ten sam album ze zdjęciami.
236
237### Dziwactwa Androida
238
239* Jakakolwiek wartość w `cameraDirection` skutkuje użyciem tylnej kamery.
240
241* Parametr `allowEdit` jest ignorowany.
242
243* Oba parametry `Camera.PictureSourceType.PHOTOLIBRARY` oraz `Camera.PictureSourceType.SAVEDPHOTOALBUM` wyświetlają ten sam album ze zdjęciami.
244
245### Jeżyna 10 dziwactwa
246
247* Parametr `quality` jest ignorowany.
248
249* Parametr `allowEdit` jest ignorowany.
250
251* Nie jest wspierane `Camera.MediaType`.
252
253* Parametr `correctOrientation` jest ignorowany.
254
255* Parametr `cameraDirection` jest ignorowany.
256
257### Firefox OS dziwactwa
258
259* Parametr `quality` jest ignorowany.
260
261* `Camera.DestinationType`jest ignorowane i jest równa `1` (plik obrazu URI)
262
263* Parametr `allowEdit` jest ignorowany.
264
265* Ignoruje `PictureSourceType` parametr (użytkownik wybiera go w oknie dialogowym)
266
267* Ignoruje`encodingType`
268
269* Ignoruje `targetWidth` i`targetHeight`
270
271* Nie jest wspierane `Camera.MediaType`.
272
273* Parametr `correctOrientation` jest ignorowany.
274
275* Parametr `cameraDirection` jest ignorowany.
276
277### Dziwactwa iOS
278
279* Ustaw `quality` poniżej 50 aby uniknąć błędów pamięci na niektórych urządzeniach.
280
281* Podczas korzystania z `destinationType.FILE_URI` , zdjęcia są zapisywane w katalogu tymczasowego stosowania. Zawartość katalogu tymczasowego stosowania jest usuwany po zakończeniu aplikacji.
282
283### Dziwactwa Tizen
284
285* opcje nie są obsługiwane
286
287* zawsze zwraca FILE URI
288
289### Windows Phone 7 i 8 dziwactwa
290
291* Parametr `allowEdit` jest ignorowany.
292
293* Parametr `correctOrientation` jest ignorowany.
294
295* Parametr `cameraDirection` jest ignorowany.
296
297* 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]
298
299* Ignoruje `mediaType` Właściwość `cameraOptions` jako SDK Windows Phone nie umożliwiają wybór filmów z PHOTOLIBRARY.
300
301 [3]: https://issues.apache.org/jira/browse/CB-2083
302
303## CameraError
304
305funkcja wywołania zwrotnego PrzyBłędzie, która zawiera komunikat o błędzie.
306
307 function(message) {
308 // Show a helpful message
309 }
310
311
312### Parametry
313
314* **message**: Natywny kod komunikatu zapewniany przez urządzenie. *(Ciąg znaków)*
315
316## cameraSuccess
317
318onSuccess funkcji wywołania zwrotnego, który dostarcza dane obrazu.
319
320 function(imageData) {
321 // Do something with the image
322 }
323
324
325### Parametry
326
327* **imageData**: Dane obrazu kodowane przy pomocy Base64 *lub* URI pliku obrazu, w zależności od użycia `cameraOptions`. *(Ciąg znaków)*
328
329### Przykład
330
331 // Show image
332 //
333 function cameraCallback(imageData) {
334 var image = document.getElementById('myImage');
335 image.src = "data:image/jpeg;base64," + imageData;
336 }
337
338
339## CameraPopoverHandle
340
341Uchwyt do okna dialogowego popover, stworzony przez `navigator.camera.getPicture`.
342
343### Metody
344
345* **setPosition**: Ustawia pozycję wyskakującego okna.
346
347### Obsługiwane platformy
348
349* iOS
350
351### setPosition
352
353Ustaw pozycję popover.
354
355**Parametry**:
356
357* `cameraPopoverOptions`: `CameraPopoverOptions`, która określa nową pozycję
358
359### Przykład
360
361 var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
362 { destinationType: Camera.DestinationType.FILE_URI,
363 sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
364 popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)
365 });
366
367 // Reposition the popover if the orientation changes.
368 window.onorientationchange = function() {
369 var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
370 cameraPopoverHandle.setPosition(cameraPopoverOptions);
371 }
372
373
374## CameraPopoverOptions
375
376tylko do iOS parametrami, które określić kotwicy element lokalizacji i strzałka kierunku popover, przy wyborze zdjęć z iPad biblioteki lub album.
377
378 { x : 0,
379 y : 32,
380 width : 320,
381 height : 480,
382 arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
383 };
384
385
386### CameraPopoverOptions
387
388* **x**: współrzędna piksela x elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
389
390* **y**: współrzędna piksela y elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
391
392* **width**: szerokość w pikselach elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
393
394* **height**: wysokość w pikselach elementu ekranu, na którym zakotwiczone jest wyskakujące okno. *(Liczba)*
395
396* **arrowDir**: Kierunek, który powinna wskazywać strzałka na wyskakującym oknie. Zdefiniowane w `Camera.PopoverArrowDirection` *(Liczba)*
397
398 Camera.PopoverArrowDirection = {
399 ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
400 ARROW_DOWN : 2,
401 ARROW_LEFT : 4,
402 ARROW_RIGHT : 8,
403 ARROW_ANY : 15
404 };
405
406
407Należ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.
408
409## navigator.camera.cleanup
410
411Usuwa pośrednie zdjęcia zrobione przez aparat z czasowego składowania.
412
413 navigator.camera.cleanup( cameraSuccess, cameraError );
414
415
416### Opis
417
418Usuwa 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`.
419
420### Obsługiwane platformy
421
422* iOS
423
424### Przykład
425
426 navigator.camera.cleanup(onSuccess, onFail);
427
428 function onSuccess() {
429 console.log("Camera cleanup success.")
430 }
431
432 function onFail(message) {
433 alert('Failed because: ' + message);
434 }