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