openEventsPlatformApp/plugins/cordova-plugin-camera/doc/ko/README.md
plugins/cordova-plugin-camera/doc/ko/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
24이 플러그인 시스템의 이미지 라이브러리에서 이미지를 선택 및 사진 촬영을 위한 API를 제공 하는 글로벌 `navigator.camera` 개체를 정의 합니다.
25
26개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.
27
28 document.addEventListener("deviceready", onDeviceReady, false);
29 function onDeviceReady() {
30 console.log(navigator.camera);
31 }
32
33
34## 설치
35
36 cordova plugin add cordova-plugin-camera
37
38
39## API
40
41 * 카메라
42 * navigator.camera.getPicture(success, fail, options)
43 * CameraOptions
44 * CameraPopoverHandle
45 * CameraPopoverOptions
46 * navigator.camera.cleanup
47
48## navigator.camera.getPicture
49
50카메라를 사용 하 여 사진을 걸립니다 또는 소자의 이미지 갤러리에서 사진을 검색 합니다. 이미지는 성공 콜백에 전달 base64 인코딩된 `문자열` 또는 URI로 이미지 파일에 대 한. 방법 자체는 파일 선택 popover 위치를 사용할 수 있는 `CameraPopoverHandle` 개체를 반환 합니다.
51
52 navigator.camera.getPicture(cameraSuccess, cameraError, cameraOptions);
53
54
55#### 설명
56
57`Camera.getPicture` 함수 스냅 사진을 사용자가 소자의 기본 카메라 응용 프로그램을 엽니다. 이 문제는 `Camera.sourceType` `Camera.PictureSourceType.CAMERA` 경우 기본적으로 발생 합니다. 일단 사용자 스냅 사진, 카메라 응용 프로그램 종료 하 고 응용 프로그램 복원 됩니다.
58
59`Camera.sourceType`은 `Camera.PictureSourceType.PHOTOLIBRARY` 또는 `Camera.PictureSourceType.SAVEDPHOTOALBUM`, 대화 상자가 사용자가 기존 이미지를 선택할 수 있도록 표시 됩니다. `camera.getPicture` 함수는 장치 방향 변경 될 때 이미지 선택 대화 상자, 예를 들어, 위치를 변경 하려면 사용할 수 있는 `CameraPopoverHandle` 개체를 반환 합니다.
60
61반환 값은 `cameraSuccess` 콜백 함수 지정된 `cameraOptions`에 따라 다음 형식 중 하나에 전송 됩니다.
62
63 * A `String` base64 인코딩된 사진 이미지를 포함 합니다.
64
65 * A `String` 로컬 저장소 (기본값)의 이미지 파일 위치를 나타내는.
66
67할 수 있는 당신이 원하는대로 인코딩된 이미지 또는 URI, 예를 들면:
68
69 * 렌더링 이미지는 `<img>` 아래 예제와 같이 태그
70
71 * 로컬로 데이터를 저장 ( `LocalStorage` , [Lawnchair](http://brianleroux.github.com/lawnchair/), 등.)
72
73 * 원격 서버에 데이터 게시
74
75**참고**: 더 새로운 장치에 사진 해상도 아주 좋은. 소자의 갤러리에서 선택 된 사진 `품질` 매개 변수를 지정 하는 경우에 낮은 품질에 관하여 하지는. 일반적인 메모리 문제를 피하기 위해 `DATA_URL` 보다 `FILE_URI` `Camera.destinationType` 설정.
76
77#### 지원 되는 플랫폼
78
79        
80
81#### 예를 들어
82
83촬영 및 base64 인코딩 이미지로 검색:
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
99촬영 하 고 이미지의 파일 위치를 검색:
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#### 환경 설정 (iOS)
115
116 * **CameraUsesGeolocation** (boolean, 기본값: false)입니다. 캡처 Jpeg, EXIF 헤더에 지리적 데이터를 true로 설정 합니다. 이 경우 위치 정보 사용 권한에 대 한 요청을 일으킬 것 이다 true로 설정 합니다.
117
118 <preference name="CameraUsesGeolocation" value="false" />
119
120
121#### 아마존 화재 OS 단점
122
123아마존 화재 OS 의도 사용 하 여 이미지 캡처 장치에서 카메라 활동을 시작 하 고 낮은 메모리와 휴대 전화에 코르 도우 바 활동 살해 수 있습니다. 코르도바 활동 복원 되 면이 시나리오에서는 이미지가 나타나지 않을 수 있습니다.
124
125#### 안 드 로이드 단점
126
127안 드 로이드 의도 사용 하 여 이미지 캡처 장치에서 카메라 활동을 시작 하 고 낮은 메모리와 휴대 전화에 코르 도우 바 활동 살해 수 있습니다. 코르도바 활동 복원 되 면이 시나리오에서는 이미지가 나타나지 않을 수 있습니다.
128
129#### 브라우저 만지면
130
131수 base64 인코딩 이미지로 사진을 반환 합니다.
132
133#### 파이어 폭스 OS 단점
134
135카메라 플러그인은 현재 [웹 활동](https://hacks.mozilla.org/2013/01/introducing-web-activities/)를 사용 하 여 구현.
136
137#### iOS 단점
138
139자바 `alert()`를 포함 하 여 콜백 함수 중 하나에 문제가 발생할 수 있습니다. 포장 허용 iOS 이미지 피커 또는 popover를 완벽 하 게 경고를 표시 하기 전에 닫습니다 `setTimeout()` 내에서 경고:
140
141 setTimeout(function() {
142 // do your thing here!
143 }, 0);
144
145
146#### Windows Phone 7 단점
147
148장치 Zune 통해 연결 된 동안 네이티브 카메라 응용 프로그램을 호출 하면 작동 하지 않습니다 하 고 오류 콜백 트리거합니다.
149
150#### Tizen 특수
151
152`Camera.DestinationType.FILE_URI`의 `destinationType`와 `Camera.PictureSourceType.PHOTOLIBRARY`의 `sourceType` Tizen 지원.
153
154## CameraOptions
155
156카메라 설정을 사용자 지정 하는 선택적 매개 변수.
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 * **품질**: 범위 0-100, 100은 파일 압축에서 손실 없이 일반적으로 전체 해상도 저장된 된 이미지의 품질. 기본값은 50입니다. *(수)* (Note 카메라의 해상도 대 한 정보는 사용할 수 없습니다.)
170
171 * **destinationType**: 반환 값의 형식을 선택 합니다. 기본값은 FILE_URI입니다. 에 정의 된 `navigator.camera.DestinationType` *(수)*
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**: 그림의 소스를 설정 합니다. 기본값은 카메라입니다. 에 정의 된 `navigator.camera.PictureSourceType` *(수)*
181
182 Camera.PictureSourceType = {
183 PHOTOLIBRARY : 0,
184 CAMERA : 1,
185 SAVEDPHOTOALBUM : 2
186 };
187
188
189 * **allowEdit**: 선택 하기 전에 이미지의 간단한 편집을 허용 합니다. *(부울)*
190
191 * **encodingType**: 반환 된 이미지 파일의 인코딩을 선택 합니다. 기본값은 JPEG입니다. 에 정의 된 `navigator.camera.EncodingType` *(수)*
192
193 Camera.EncodingType = {
194 JPEG : 0, // Return JPEG encoded image
195 PNG : 1 // Return PNG encoded image
196 };
197
198
199 * **targetWidth**: 스케일 이미지를 픽셀 너비. **TargetHeight**와 함께 사용 해야 합니다. 가로 세로 비율이 일정 하 게 유지 합니다. *(수)*
200
201 * **targetHeight**: 스케일 이미지를 픽셀 단위로 높이. **TargetWidth**와 함께 사용 해야 합니다. 가로 세로 비율이 일정 하 게 유지 합니다. *(수)*
202
203 * **mediaType**:에서 선택 미디어 유형을 설정 합니다. 때에 작동 `PictureSourceType` 는 `PHOTOLIBRARY` 또는 `SAVEDPHOTOALBUM` . 에 정의 된 `nagivator.camera.MediaType` *(수)*
204
205 Camera.MediaType = {
206 PICTURE: 0, // allow selection of still pictures only. 기본입니다. 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**: 캡처 도중 장치의 방향에 대 한 해결 하기 위해 이미지를 회전 합니다. *(부울)*
213
214 * **saveToPhotoAlbum**: 캡처 후 장치에서 사진 앨범에 이미지를 저장 합니다. *(부울)*
215
216 * **popoverOptions**: iPad에 popover 위치를 지정 하는 iOS 전용 옵션. 에 정의 된`CameraPopoverOptions`.
217
218 * **cameraDirection**: (앞 이나 뒤로-연결)를 사용 하 여 카메라를 선택 하십시오. 기본값은 다시. 에 정의 된 `navigator.camera.Direction` *(수)*
219
220 Camera.Direction = {
221 BACK : 0, // Use the back-facing camera
222 FRONT : 1 // Use the front-facing camera
223 };
224
225
226#### 아마존 화재 OS 단점
227
228 * 어떤 `cameraDirection` 다시 연결 사진에 결과 값.
229
230 * 무시는 `allowEdit` 매개 변수.
231
232 * `Camera.PictureSourceType.PHOTOLIBRARY`그리고 `Camera.PictureSourceType.SAVEDPHOTOALBUM` 둘 다 동일한 사진 앨범을 표시 합니다.
233
234#### 안 드 로이드 단점
235
236 * 어떤 `cameraDirection` 다시 연결 사진에 결과 값.
237
238 * 안 드 로이드도 사용 자르기 활동 allowEdit, 비록 작물 작업과 실제로 코르도바, 유일 하 게 작품 지속적으로 구글 플러스 사진 응용 프로그램과 함께 번들로 제공 하는 것은 등을 맞댄 자른된 이미지를 전달 해야 합니다. 다른 작물은 작동 하지 않을 수 있습니다.
239
240 * `Camera.PictureSourceType.PHOTOLIBRARY`그리고 `Camera.PictureSourceType.SAVEDPHOTOALBUM` 둘 다 동일한 사진 앨범을 표시 합니다.
241
242#### 블랙베리 10 단점
243
244 * 무시는 `quality` 매개 변수.
245
246 * 무시는 `allowEdit` 매개 변수.
247
248 * `Camera.MediaType`지원 되지 않습니다.
249
250 * 무시는 `correctOrientation` 매개 변수.
251
252 * 무시는 `cameraDirection` 매개 변수.
253
254#### 파이어 폭스 OS 단점
255
256 * 무시는 `quality` 매개 변수.
257
258 * `Camera.DestinationType`무시 되 고 `1` (이미지 파일 URI)
259
260 * 무시는 `allowEdit` 매개 변수.
261
262 * 무시는 `PictureSourceType` 매개 변수 (사용자가 선택 그것 대화 창에서)
263
264 * 무시 하는`encodingType`
265
266 * 무시는 `targetWidth` 와`targetHeight`
267
268 * `Camera.MediaType`지원 되지 않습니다.
269
270 * 무시는 `correctOrientation` 매개 변수.
271
272 * 무시는 `cameraDirection` 매개 변수.
273
274#### iOS 단점
275
276 * 설정 `quality` 일부 장치 메모리 오류를 피하기 위해 50 아래.
277
278 * 사용 하는 경우 `destinationType.FILE_URI` , 사진 응용 프로그램의 임시 디렉터리에 저장 됩니다. 응용 프로그램이 종료 될 때 응용 프로그램의 임시 디렉터리의 내용은 삭제 됩니다.
279
280#### Tizen 특수
281
282 * 지원 되지 않는 옵션
283
284 * 항상 파일 URI를 반환 합니다.
285
286#### Windows Phone 7, 8 특수
287
288 * 무시는 `allowEdit` 매개 변수.
289
290 * 무시는 `correctOrientation` 매개 변수.
291
292 * 무시는 `cameraDirection` 매개 변수.
293
294 * 무시는 `saveToPhotoAlbum` 매개 변수. 중요: 모든 이미지 API wp7/8 코르도바 카메라로 촬영 항상 복사 됩니다 휴대 전화의 카메라 롤에. 사용자의 설정에 따라이 또한 그들의 OneDrive에 자동 업로드 이미지는 의미. 이 잠재적으로 이미지는 당신의 애플 리 케이 션을 위한 보다 넓은 청중에 게 사용할 수 있는 의미. 이 경우 응용 프로그램에 대 한 차단, 당신은 msdn에 설명 대로 단말기를 구현 해야 합니다: <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx> 수 있습니다 또한 의견 또는 [이슈 트래커](https://issues.apache.org/jira/browse/CB-2083) 에서 업-투표 관련된 문제
295
296 * 무시는 `mediaType` 속성을 `cameraOptions` 으로 Windows Phone SDK PHOTOLIBRARY에서 비디오를 선택 하는 방법을 제공 하지 않습니다.
297
298## CameraError
299
300오류 메시지를 제공 하는 onError 콜백 함수.
301
302 function(message) {
303 // Show a helpful message
304 }
305
306
307#### 설명
308
309 * **메시지**: 메시지는 장치의 네이티브 코드에 의해 제공 됩니다. *(문자열)*
310
311## cameraSuccess
312
313이미지 데이터를 제공 하는 onSuccess 콜백 함수.
314
315 function(imageData) {
316 // Do something with the image
317 }
318
319
320#### 설명
321
322 * **imageData**: Base64 인코딩은 이미지 데이터, *또는* 이미지 파일에 따라 URI의 `cameraOptions` 적용. *(문자열)*
323
324#### 예를 들어
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
336`navigator.camera.getPicture`에 의해 만들어진 popover 대화에 대 한 핸들.
337
338#### 설명
339
340 * **setPosition**: Set the position of the popover. Takes the `CameraPopoverOptions` that specify the new position.
341
342#### 지원 되는 플랫폼
343
344        
345
346#### 예를 들어
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
363iOS 전용 매개 변수 iPad의 보관 함 또는 앨범에서 이미지를 선택 하면 앵커 요소 위치와 화살표의 방향으로 popover 지정 하는.
364
365 { x : 0,
366 y : 32,
367 width : 320,
368 height : 480,
369 arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
370 };
371
372
373#### 설명
374
375 * **x**: x는 popover 앵커는 화면 요소의 픽셀 좌표. *(수)*
376
377 * **y**: y 픽셀 좌표는 popover 앵커는 화면 요소입니다. *(수)*
378
379 * **폭**: 폭 (픽셀)는 popover 앵커는 화면 요소. *(수)*
380
381 * **높이**: 높이 (픽셀)는 popover 앵커는 화면 요소. *(수)*
382
383 * **arrowDir**: 방향 화살표는 popover 가리켜야 합니다. 에 정의 된 `Camera.PopoverArrowDirection` *(수)*
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
394참고는 popover의 크기 조정 화살표 방향 및 화면 방향 변경 될 수 있습니다. 앵커 요소 위치를 지정 하는 경우 방향 변경에 대 한 계정에 있는지 확인 합니다.
395
396## navigator.camera.cleanup
397
398제거 임시 저장소에서 카메라로 찍은 사진을 중간.
399
400 navigator.camera.cleanup( cameraSuccess, cameraError );
401
402
403#### 설명
404
405`camera.getPicture`를 호출한 후 임시 저장소에 보관 됩니다 중간 이미지 파일을 제거 합니다. `Camera.sourceType` 값은 `Camera.PictureSourceType.CAMERA` 및 `Camera.destinationType`와 `Camera.DestinationType.FILE_URI` 때만 적용 됩니다..
406
407#### 지원 되는 플랫폼
408
409        
410
411#### 예를 들어
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 }