openEventsPlatformApp/plugins/cordova-plugin-camera/doc/ko/index.md
plugins/cordova-plugin-camera/doc/ko/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
22이 플러그인 시스템의 이미지 라이브러리에서 이미지를 선택 및 사진 촬영을 위한 API를 제공 하는 글로벌 `navigator.camera` 개체를 정의 합니다.
23
24개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.
25
26 document.addEventListener("deviceready", onDeviceReady, false);
27 function onDeviceReady() {
28 console.log(navigator.camera);
29 }
30
31
32## 설치
33
34 cordova plugin add cordova-plugin-camera
35
36
37## navigator.camera.getPicture
38
39카메라를 사용 하 여 사진을 걸립니다 또는 소자의 이미지 갤러리에서 사진을 검색 합니다. 이미지는 성공 콜백에 전달 base64 인코딩된 `문자열` 또는 URI로 이미지 파일에 대 한. 방법 자체는 파일 선택 popover 위치를 사용할 수 있는 `CameraPopoverHandle` 개체를 반환 합니다.
40
41 navigator.camera.getPicture( cameraSuccess, cameraError, cameraOptions );
42
43
44### 설명
45
46`Camera.getPicture` 함수 스냅 사진을 사용자가 소자의 기본 카메라 응용 프로그램을 엽니다. 이 문제는 `Camera.sourceType` `Camera.PictureSourceType.CAMERA` 경우 기본적으로 발생 합니다. 일단 사용자 스냅 사진, 카메라 응용 프로그램 종료 하 고 응용 프로그램 복원 됩니다.
47
48`Camera.sourceType`은 `Camera.PictureSourceType.PHOTOLIBRARY` 또는 `Camera.PictureSourceType.SAVEDPHOTOALBUM`, 대화 상자가 사용자가 기존 이미지를 선택할 수 있도록 표시 됩니다. `camera.getPicture` 함수는 장치 방향 변경 될 때 이미지 선택 대화 상자, 예를 들어, 위치를 변경 하려면 사용할 수 있는 `CameraPopoverHandle` 개체를 반환 합니다.
49
50반환 값은 `cameraSuccess` 콜백 함수 지정된 `cameraOptions`에 따라 다음 형식 중 하나에 전송 됩니다.
51
52* A `String` base64 인코딩된 사진 이미지를 포함 합니다.
53
54* A `String` 로컬 저장소 (기본값)의 이미지 파일 위치를 나타내는.
55
56할 수 있는 당신이 원하는대로 인코딩된 이미지 또는 URI, 예를 들면:
57
58* 렌더링 이미지는 `<img>` 아래 예제와 같이 태그
59
60* 로컬로 데이터를 저장 ( `LocalStorage` , [Lawnchair][1], 등.)
61
62* 원격 서버에 데이터 게시
63
64 [1]: http://brianleroux.github.com/lawnchair/
65
66**참고**: 더 새로운 장치에 사진 해상도 아주 좋은. 소자의 갤러리에서 선택 된 사진 `품질` 매개 변수를 지정 하는 경우에 낮은 품질에 관하여 하지는. 일반적인 메모리 문제를 피하기 위해 `DATA_URL` 보다 `FILE_URI` `Camera.destinationType` 설정.
67
68### 지원 되는 플랫폼
69
70* 아마존 화재 운영 체제
71* 안 드 로이드
72* 블랙베리 10
73* 브라우저
74* Firefox 운영 체제
75* iOS
76* Tizen
77* Windows Phone 7과 8
78* 윈도우 8
79
80### 환경 설정 (iOS)
81
82* **CameraUsesGeolocation** (boolean, 기본값: false)입니다. 캡처 Jpeg, EXIF 헤더에 지리적 데이터를 true로 설정 합니다. 이 경우 위치 정보 사용 권한에 대 한 요청을 일으킬 것 이다 true로 설정 합니다.
83
84 <preference name="CameraUsesGeolocation" value="false" />
85
86
87### 아마존 화재 OS 단점
88
89아마존 화재 OS 의도 사용 하 여 이미지 캡처 장치에서 카메라 활동을 시작 하 고 낮은 메모리와 휴대 전화에 코르 도우 바 활동 살해 수 있습니다. 코르도바 활동 복원 되 면이 시나리오에서는 이미지가 나타나지 않을 수 있습니다.
90
91### 안 드 로이드 단점
92
93안 드 로이드 의도 사용 하 여 이미지 캡처 장치에서 카메라 활동을 시작 하 고 낮은 메모리와 휴대 전화에 코르 도우 바 활동 살해 수 있습니다. 코르도바 활동 복원 되 면이 시나리오에서는 이미지가 나타나지 않을 수 있습니다.
94
95### 브라우저 만지면
96
97수 base64 인코딩 이미지로 사진을 반환 합니다.
98
99### 파이어 폭스 OS 단점
100
101카메라 플러그인은 현재 [웹 활동][2]를 사용 하 여 구현.
102
103 [2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
104
105### iOS 단점
106
107자바 `alert()`를 포함 하 여 콜백 함수 중 하나에 문제가 발생할 수 있습니다. 포장 허용 iOS 이미지 피커 또는 popover를 완벽 하 게 경고를 표시 하기 전에 닫습니다 `setTimeout()` 내에서 경고:
108
109 setTimeout(function() {
110 // do your thing here!
111 }, 0);
112
113
114### Windows Phone 7 단점
115
116장치 Zune 통해 연결 된 동안 네이티브 카메라 응용 프로그램을 호출 하면 작동 하지 않습니다 하 고 오류 콜백 트리거합니다.
117
118### Tizen 특수
119
120`Camera.DestinationType.FILE_URI`의 `destinationType`와 `Camera.PictureSourceType.PHOTOLIBRARY`의 `sourceType` Tizen 지원.
121
122### 예를 들어
123
124촬영 및 base64 인코딩 이미지로 검색:
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
140촬영 하 고 이미지의 파일 위치를 검색:
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
157카메라 설정을 사용자 지정 하는 선택적 매개 변수.
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### 옵션
171
172* **품질**: 범위 0-100, 100은 파일 압축에서 손실 없이 일반적으로 전체 해상도 저장된 된 이미지의 품질. 기본값은 50입니다. *(수)* (Note 카메라의 해상도 대 한 정보는 사용할 수 없습니다.)
173
174* **destinationType**: 반환 값의 형식을 선택 합니다. 기본값은 FILE_URI입니다. 에 정의 된 `navigator.camera.DestinationType` *(수)*
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**: 그림의 소스를 설정 합니다. 기본값은 카메라입니다. 에 정의 된 `navigator.camera.PictureSourceType` *(수)*
184
185 Camera.PictureSourceType = {
186 PHOTOLIBRARY : 0,
187 CAMERA : 1,
188 SAVEDPHOTOALBUM : 2
189 };
190
191
192* **allowEdit**: 선택 하기 전에 이미지의 간단한 편집을 허용 합니다. *(부울)*
193
194* **encodingType**: 반환 된 이미지 파일의 인코딩을 선택 합니다. 기본값은 JPEG입니다. 에 정의 된 `navigator.camera.EncodingType` *(수)*
195
196 Camera.EncodingType = {
197 JPEG : 0, // Return JPEG encoded image
198 PNG : 1 // Return PNG encoded image
199 };
200
201
202* **targetWidth**: 스케일 이미지를 픽셀 너비. **TargetHeight**와 함께 사용 해야 합니다. 가로 세로 비율이 일정 하 게 유지 합니다. *(수)*
203
204* **targetHeight**: 스케일 이미지를 픽셀 단위로 높이. **TargetWidth**와 함께 사용 해야 합니다. 가로 세로 비율이 일정 하 게 유지 합니다. *(수)*
205
206* **mediaType**:에서 선택 미디어 유형을 설정 합니다. 때에 작동 `PictureSourceType` 는 `PHOTOLIBRARY` 또는 `SAVEDPHOTOALBUM` . 에 정의 된 `nagivator.camera.MediaType` *(수)*
207
208 Camera.MediaType = {
209 PICTURE: 0, // allow selection of still pictures only. 기본입니다. 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**: 캡처 도중 장치의 방향에 대 한 해결 하기 위해 이미지를 회전 합니다. *(부울)*
216
217* **saveToPhotoAlbum**: 캡처 후 장치에서 사진 앨범에 이미지를 저장 합니다. *(부울)*
218
219* **popoverOptions**: iPad에 popover 위치를 지정 하는 iOS 전용 옵션. 에 정의 된`CameraPopoverOptions`.
220
221* **cameraDirection**: (앞 이나 뒤로-연결)를 사용 하 여 카메라를 선택 하십시오. 기본값은 다시. 에 정의 된 `navigator.camera.Direction` *(수)*
222
223 Camera.Direction = {
224 BACK : 0, // Use the back-facing camera
225 FRONT : 1 // Use the front-facing camera
226 };
227
228
229### 아마존 화재 OS 단점
230
231* 어떤 `cameraDirection` 다시 연결 사진에 결과 값.
232
233* 무시는 `allowEdit` 매개 변수.
234
235* `Camera.PictureSourceType.PHOTOLIBRARY`그리고 `Camera.PictureSourceType.SAVEDPHOTOALBUM` 둘 다 동일한 사진 앨범을 표시 합니다.
236
237### 안 드 로이드 단점
238
239* 어떤 `cameraDirection` 다시 연결 사진에 결과 값.
240
241* 무시는 `allowEdit` 매개 변수.
242
243* `Camera.PictureSourceType.PHOTOLIBRARY`그리고 `Camera.PictureSourceType.SAVEDPHOTOALBUM` 둘 다 동일한 사진 앨범을 표시 합니다.
244
245### 블랙베리 10 단점
246
247* 무시는 `quality` 매개 변수.
248
249* 무시는 `allowEdit` 매개 변수.
250
251* `Camera.MediaType`지원 되지 않습니다.
252
253* 무시는 `correctOrientation` 매개 변수.
254
255* 무시는 `cameraDirection` 매개 변수.
256
257### 파이어 폭스 OS 단점
258
259* 무시는 `quality` 매개 변수.
260
261* `Camera.DestinationType`무시 되 고 `1` (이미지 파일 URI)
262
263* 무시는 `allowEdit` 매개 변수.
264
265* 무시는 `PictureSourceType` 매개 변수 (사용자가 선택 그것 대화 창에서)
266
267* 무시 하는`encodingType`
268
269* 무시는 `targetWidth` 와`targetHeight`
270
271* `Camera.MediaType`지원 되지 않습니다.
272
273* 무시는 `correctOrientation` 매개 변수.
274
275* 무시는 `cameraDirection` 매개 변수.
276
277### iOS 단점
278
279* 설정 `quality` 일부 장치 메모리 오류를 피하기 위해 50 아래.
280
281* 사용 하는 경우 `destinationType.FILE_URI` , 사진 응용 프로그램의 임시 디렉터리에 저장 됩니다. 응용 프로그램이 종료 될 때 응용 프로그램의 임시 디렉터리의 내용은 삭제 됩니다.
282
283### Tizen 특수
284
285* 지원 되지 않는 옵션
286
287* 항상 파일 URI를 반환 합니다.
288
289### Windows Phone 7, 8 특수
290
291* 무시는 `allowEdit` 매개 변수.
292
293* 무시는 `correctOrientation` 매개 변수.
294
295* 무시는 `cameraDirection` 매개 변수.
296
297* 무시는 `saveToPhotoAlbum` 매개 변수. 중요: 모든 이미지 API wp7/8 코르도바 카메라로 촬영 항상 복사 됩니다 휴대 전화의 카메라 롤에. 사용자의 설정에 따라이 또한 그들의 OneDrive에 자동 업로드 이미지는 의미. 이 잠재적으로 이미지는 당신의 애플 리 케이 션을 위한 보다 넓은 청중에 게 사용할 수 있는 의미. 이 경우 응용 프로그램에 대 한 차단, 당신은 msdn에 설명 대로 단말기를 구현 해야 합니다: <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx> 수 있습니다 또한 의견 또는 [이슈 트래커][3] 에서 업-투표 관련된 문제
298
299* 무시는 `mediaType` 속성을 `cameraOptions` 으로 Windows Phone SDK PHOTOLIBRARY에서 비디오를 선택 하는 방법을 제공 하지 않습니다.
300
301 [3]: https://issues.apache.org/jira/browse/CB-2083
302
303## CameraError
304
305오류 메시지를 제공 하는 onError 콜백 함수.
306
307 function(message) {
308 // Show a helpful message
309 }
310
311
312### 매개 변수
313
314* **메시지**: 메시지는 장치의 네이티브 코드에 의해 제공 됩니다. *(문자열)*
315
316## cameraSuccess
317
318이미지 데이터를 제공 하는 onSuccess 콜백 함수.
319
320 function(imageData) {
321 // Do something with the image
322 }
323
324
325### 매개 변수
326
327* **imageData**: Base64 인코딩은 이미지 데이터, *또는* 이미지 파일에 따라 URI의 `cameraOptions` 적용. *(문자열)*
328
329### 예를 들어
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
341`navigator.camera.getPicture`에 의해 만들어진 popover 대화에 대 한 핸들.
342
343### 메서드
344
345* **setPosition**:는 popover의 위치를 설정 합니다.
346
347### 지원 되는 플랫폼
348
349* iOS
350
351### setPosition
352
353popover의 위치를 설정 합니다.
354
355**매개 변수**:
356
357* `cameraPopoverOptions`:는 `CameraPopoverOptions` 새 위치를 지정 하는
358
359### 예를 들어
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
376iOS 전용 매개 변수 iPad의 보관 함 또는 앨범에서 이미지를 선택 하면 앵커 요소 위치와 화살표의 방향으로 popover 지정 하는.
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**: x는 popover 앵커는 화면 요소의 픽셀 좌표. *(수)*
389
390* **y**: y 픽셀 좌표는 popover 앵커는 화면 요소입니다. *(수)*
391
392* **폭**: 폭 (픽셀)는 popover 앵커는 화면 요소. *(수)*
393
394* **높이**: 높이 (픽셀)는 popover 앵커는 화면 요소. *(수)*
395
396* **arrowDir**: 방향 화살표는 popover 가리켜야 합니다. 에 정의 된 `Camera.PopoverArrowDirection` *(수)*
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
407참고는 popover의 크기 조정 화살표 방향 및 화면 방향 변경 될 수 있습니다. 앵커 요소 위치를 지정 하는 경우 방향 변경에 대 한 계정에 있는지 확인 합니다.
408
409## navigator.camera.cleanup
410
411제거 임시 저장소에서 카메라로 찍은 사진을 중간.
412
413 navigator.camera.cleanup( cameraSuccess, cameraError );
414
415
416### 설명
417
418`camera.getPicture`를 호출한 후 임시 저장소에 보관 됩니다 중간 이미지 파일을 제거 합니다. `Camera.sourceType` 값은 `Camera.PictureSourceType.CAMERA` 및 `Camera.destinationType`와 `Camera.DestinationType.FILE_URI` 때만 적용 됩니다..
419
420### 지원 되는 플랫폼
421
422* iOS
423
424### 예를 들어
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 }