UNPKG

20.7 kBMarkdownView Raw
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-media-capture
21
22이 플러그인 디바이스의 오디오, 이미지 및 비디오 캡처 기능에 대 한 액세스를 제공합니다.
23
24**경고**: 수집 및 이미지, 비디오 또는 오디오 장치의 카메라 또는 마이크를 사용 하 여 중요 한 개인 정보 보호 문제를 제기 하고있다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 같은 센서를 사용 하는 방법 및 다른 당사자와 함께 기록 된 데이터는 공유 하는 여부를 토론 해야 한다. 또한, 애플 리 케이 션의 카메라 또는 마이크를 사용 하지 않으면 명백한 사용자 인터페이스에서, 제공 해야 그냥--시간 통지 (해당 되는 경우 장치 운영 체제 이렇게 이미 하지 않는) 응용 프로그램 카메라 또는 마이크에 액세스 하기 전에. 그 통지는 (예를 들어, **확인** 및 **아니오**선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 저스트-인-타임 공지 및 카메라 또는 마이크에 액세스 하기 전에 사용자에 게 허가를 귀하의 응용 프로그램에 필요할 수 있습니다. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
25
26이 플러그인 글로벌 `navigator.device.capture` 개체를 정의합니다.
27
28전역 범위에 있지만 그것은 불가능까지 `deviceready` 이벤트 후.
29
30 document.addEventListener("deviceready", onDeviceReady, false);
31 function onDeviceReady() {
32 console.log(navigator.device.capture);
33 }
34
35
36## 설치
37
38 cordova plugin add cordova-plugin-media-capture
39
40
41## 지원 되는 플랫폼
42
43* 아마존 화재 운영 체제
44* 안 드 로이드
45* 블랙베리 10
46* iOS
47* Windows Phone 7과 8
48* 윈도우 8
49
50## 개체
51
52* 캡처
53* CaptureAudioOptions
54* CaptureImageOptions
55* CaptureVideoOptions
56* CaptureCallback
57* CaptureErrorCB
58* ConfigurationData
59* MediaFile
60* MediaFileData
61
62## 메서드
63
64* capture.captureAudio
65* capture.captureImage
66* capture.captureVideo
67* MediaFile.getFormatData
68
69## 속성
70
71* **supportedAudioModes**: 오디오 녹음 장치에 의해 지원 되는 형식. (ConfigurationData[])
72
73* **supportedImageModes**: 기록 이미지 크기 및 장치에서 지원 되는 형식. (ConfigurationData[])
74
75* **supportedVideoModes**: 녹음 비디오 해상도 및 장치에 의해 지원 되는 형식. (ConfigurationData[])
76
77## capture.captureAudio
78
79> 오디오 레코더 응용 프로그램을 시작 하 고 캡처한 오디오 클립 파일에 대 한 정보를 반환 합니다.
80
81 navigator.device.capture.captureAudio(
82 CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureAudioOptions options]
83 );
84
85
86### 설명
87
88소자의 기본 오디오 녹음 응용 프로그램을 사용 하 여 오디오 녹음을 캡처하는 비동기 작업을 시작 합니다. 작업 장치 사용자를 단일 세션에서 여러 녹화를 캡처할 수 있습니다.
89
90캡처 작업 사용자가 오디오 녹음 응용 프로그램을 종료 하거나 녹음 `CaptureAudioOptions.limit`에 의해 지정 된 최대 수에 도달 하면 끝납니다. `limit` 매개 변수 값을 지정 하지, 하나 (1), 기본 및 캡처 작업이 종료 되 면 사용자는 하나의 오디오 클립을 기록 하는 후.
91
92캡처 작업이 완료 되 면 각 캡처된 오디오 클립 파일 설명 `MediaFile` 개체의 배열과 함께 `CaptureCallback`를 실행 합니다. 사용자 전에 오디오 클립을 캡처 작업이 종료 되 면, `CaptureErrorCallback` `CaptureError.CAPTURE_NO_MEDIA_FILES` 오류 코드를 갖춘 `CaptureError` 개체를 실행 합니다.
93
94### 지원 되는 플랫폼
95
96* 아마존 화재 운영 체제
97* 안 드 로이드
98* 블랙베리 10
99* iOS
100* Windows Phone 7과 8
101* 윈도우 8
102
103### 예를 들어
104
105 // capture callback
106 var captureSuccess = function(mediaFiles) {
107 var i, path, len;
108 for (i = 0, len = mediaFiles.length; i < len; i += 1) {
109 path = mediaFiles[i].fullPath;
110 // do something interesting with the file
111 }
112 };
113
114 // capture error callback
115 var captureError = function(error) {
116 navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
117 };
118
119 // start audio capture
120 navigator.device.capture.captureAudio(captureSuccess, captureError, {limit:2});
121
122
123### iOS 단점
124
125* iOS 없으므로 기본 오디오 녹음 응용 프로그램을 간단한 사용자 인터페이스를 제공 합니다.
126
127### Windows Phone 7, 8 특수
128
129* Windows Phone 7 없으므로 기본 오디오 녹음 응용 프로그램을 간단한 사용자 인터페이스를 제공 합니다.
130
131## CaptureAudioOptions
132
133> 오디오 캡처 구성 옵션을 캡슐화합니다.
134
135### 속성
136
137* **제한**: 최대 오디오 클립 장치 사용자는 단일 캡처 작업에 기록할 수 있습니다. 값 1 (기본값: 1) 보다 크거나 같아야 합니다.
138
139* **기간**: 오디오 사운드 클립의 최대 기간 초.
140
141### 예를 들어
142
143 // limit capture operation to 3 media files, no longer than 10 seconds each
144 var options = { limit: 3, duration: 10 };
145
146 navigator.device.capture.captureAudio(captureSuccess, captureError, options);
147
148
149### 아마존 화재 OS 단점
150
151* `duration`매개 변수는 지원 되지 않습니다. 녹음 길이 프로그래밍 방식으로 제한 될 수 없습니다.
152
153### 안 드 로이드 단점
154
155* `duration`매개 변수는 지원 되지 않습니다. 녹음 길이 프로그래밍 방식으로 제한 될 수 없습니다.
156
157### 블랙베리 10 단점
158
159* `duration`매개 변수는 지원 되지 않습니다. 녹음 길이 프로그래밍 방식으로 제한 될 수 없습니다.
160* `limit`매개 변수는 지원 되지 않습니다, 그래서 하나의 기록 각 호출에 대해 만들 수 있습니다.
161
162### iOS 단점
163
164* `limit`매개 변수는 지원 되지 않습니다, 그래서 하나의 기록 각 호출에 대해 만들 수 있습니다.
165
166## capture.captureImage
167
168> 카메라 응용 프로그램을 시작 하 고 캡처된 이미지 파일에 대 한 정보를 반환 합니다.
169
170 navigator.device.capture.captureImage(
171 CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureImageOptions options]
172 );
173
174
175### 설명
176
177디바이스의 카메라 응용 프로그램을 사용 하 여 이미지를 캡처하는 비동기 작업을 시작 합니다. 작업이 단일 세션에서 하나 이상의 이미지를 캡처할 수 있습니다.
178
179캡처 작업 종료 때 카메라 응용 프로그램을 닫으면 또는 `CaptureAudioOptions.limit`에 지정 된 녹음의 최대 수에 도달 합니다. `limit` 값을 지정 하지 경우에, 하나 (1) 기본적으로 캡처 작업 종료 후 사용자 단일 이미지를 캡처합니다.
180
181캡처 작업이 완료 되 면 각 캡처된 이미지 파일 설명 `MediaFile` 개체의 배열과 함께 `CaptureCB` 콜백을 호출 합니다. 사용자 이미지를 캡처하기 전에 작업이 종료 되 면 `CaptureErrorCB` 콜백 `CaptureError.CAPTURE_NO_MEDIA_FILES` 오류 코드를 특징으로 하는 `CaptureError` 개체를 실행 합니다.
182
183### 지원 되는 플랫폼
184
185* 아마존 화재 운영 체제
186* 안 드 로이드
187* 블랙베리 10
188* iOS
189* Windows Phone 7과 8
190* 윈도우 8
191
192### Windows Phone 7 단점
193
194당신의 장치 Zune 통해 연결 하는 동안 네이티브 카메라 응용 프로그램을 호출 하면 작동 하지 않는다, 및 오류 콜백 실행.
195
196### 예를 들어
197
198 // capture callback
199 var captureSuccess = function(mediaFiles) {
200 var i, path, len;
201 for (i = 0, len = mediaFiles.length; i < len; i += 1) {
202 path = mediaFiles[i].fullPath;
203 // do something interesting with the file
204 }
205 };
206
207 // capture error callback
208 var captureError = function(error) {
209 navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
210 };
211
212 // start image capture
213 navigator.device.capture.captureImage(captureSuccess, captureError, {limit:2});
214
215
216## CaptureImageOptions
217
218> 이미지 캡처 구성 옵션을 캡슐화합니다.
219
220### 속성
221
222* **제한**: 사용자는 단일 캡처 작업에서 캡처할 수 있는 이미지의 최대 수. 값 1 (기본값: 1) 보다 크거나 같아야 합니다.
223
224### 예를 들어
225
226 // limit capture operation to 3 images
227 var options = { limit: 3 };
228
229 navigator.device.capture.captureImage(captureSuccess, captureError, options);
230
231
232### iOS 단점
233
234* **제한** 매개 변수는 지원 되지 않습니다, 그리고 하나의 이미지 호출 당 촬영.
235
236## capture.captureVideo
237
238> 비디오 레코더 응용 프로그램을 시작 하 고 캡처한 비디오 클립 파일에 대 한 정보를 반환 합니다.
239
240 navigator.device.capture.captureVideo(
241 CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureVideoOptions options]
242 );
243
244
245### 설명
246
247비디오 녹화 장치의 비디오 레코딩 응용 프로그램을 사용 하 여 캡처하는 비동기 작업을 시작 합니다. 작업을 사용 하면 단일 세션에서 하나 이상의 녹음을 캡처할 수 있습니다.
248
249캡처 작업 사용자가 비디오 레코딩 응용 프로그램 종료 또는 `CaptureVideoOptions.limit`에 지정 된 녹음의 최대 수에 도달 하면 끝납니다. `limit` 매개 변수 값을 지정 하지, 하나 (1), 기본 및 캡처 작업이 종료 되 면 사용자는 하나의 비디오 클립을 기록 하는 후.
250
251캡처 작업이 완료 되 면 `CaptureCB` 콜백 실행 각 캡처된 비디오 클립 파일을 설명 하는 `MediaFile` 개체의 배열을 사용 합니다. 사용자는 비디오 클립을 캡처하기 전에 작업이 종료 되 면 `CaptureErrorCB` 콜백 `CaptureError.CAPTURE_NO_MEDIA_FILES` 오류 코드를 특징으로 하는 `CaptureError` 개체를 실행 합니다.
252
253### 지원 되는 플랫폼
254
255* 아마존 화재 운영 체제
256* 안 드 로이드
257* 블랙베리 10
258* iOS
259* Windows Phone 7과 8
260* 윈도우 8
261
262### 예를 들어
263
264 // capture callback
265 var captureSuccess = function(mediaFiles) {
266 var i, path, len;
267 for (i = 0, len = mediaFiles.length; i < len; i += 1) {
268 path = mediaFiles[i].fullPath;
269 // do something interesting with the file
270 }
271 };
272
273 // capture error callback
274 var captureError = function(error) {
275 navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
276 };
277
278 // start video capture
279 navigator.device.capture.captureVideo(captureSuccess, captureError, {limit:2});
280
281
282### 블랙베리 10 단점
283
284* 블랙베리 10 코르도바는 **비디오 레코더** 응용 프로그램을 실행, RIM, 제공한 비디오 녹화를 잡으려고 시도 합니다. 응용 프로그램 수신는 `CaptureError.CAPTURE_NOT_SUPPORTED` 오류 코드 응용 프로그램을 장치에 설치 되어 있지 않으면.
285
286## CaptureVideoOptions
287
288> 비디오 캡처 구성 옵션을 캡슐화합니다.
289
290### 속성
291
292* **제한**: 디바이스의 사용자는 단일 캡처 작업에서 캡처할 수 있는 비디오 클립의 최대 수. 값 1 (기본값: 1) 보다 크거나 같아야 합니다.
293
294* **기간**: 비디오 클립의 최대 기간 초.
295
296### 예를 들어
297
298 // limit capture operation to 3 video clips
299 var options = { limit: 3 };
300
301 navigator.device.capture.captureVideo(captureSuccess, captureError, options);
302
303
304### 블랙베리 10 단점
305
306* **기간** 매개 변수가 지원 되지 않으므로 녹음 길이 프로그래밍 방식으로 제한 될 수 없습니다.
307
308### iOS 단점
309
310* **제한** 매개 변수는 지원 되지 않습니다. 비디오 호출 당 기록 됩니다.
311
312## CaptureCB
313
314> 성공적인 미디어 캡처 작업에 따라 호출 됩니다.
315
316 function captureSuccess( MediaFile[] mediaFiles ) { ... };
317
318
319### 설명
320
321이 함수는 성공적인 캡처 작업이 완료 된 후 실행 합니다. 미디어 파일을 캡처한이 포인트와 중에 사용자가 미디어 캡처 응용 프로그램 종료 또는 캡처 한계에 도달 했습니다.
322
323각 `MediaFile` 개체 캡처한 미디어 파일을 설명합니다.
324
325### 예를 들어
326
327 // capture callback
328 function captureSuccess(mediaFiles) {
329 var i, path, len;
330 for (i = 0, len = mediaFiles.length; i < len; i += 1) {
331 path = mediaFiles[i].fullPath;
332 // do something interesting with the file
333 }
334 };
335
336
337## CaptureError
338
339> 실패 한 미디어 캡처 작업에서 발생 하는 오류 코드를 캡슐화 합니다.
340
341### 속성
342
343* **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
344
345### 상수
346
347* `CaptureError.CAPTURE_INTERNAL_ERR`: 카메라 또는 마이크 캡처 이미지 또는 소리 하지 못했습니다.
348
349* `CaptureError.CAPTURE_APPLICATION_BUSY`: 카메라 또는 오디오 캡처 응용 프로그램은 현재 또 다른 캡처 요청을 제공 하고있다.
350
351* `CaptureError.CAPTURE_INVALID_ARGUMENT`: API 잘못 된 사용 (예를 들어, 값 `limit` 보다 작은 하나입니다).
352
353* `CaptureError.CAPTURE_NO_MEDIA_FILES`: 사용자는 아무것도 캡처하기 전에 카메라 또는 오디오 캡처 응용 프로그램을 종료 합니다.
354
355* `CaptureError.CAPTURE_NOT_SUPPORTED`: 요청 된 캡처 작업이 지원 되지 않습니다.
356
357## CaptureErrorCB
358
359> 미디어 캡처 작업 중에 오류가 발생 하면 호출 됩니다.
360
361 function captureError( CaptureError error ) { ... };
362
363
364### 설명
365
366이 함수는 오류가 발생 하면 실행 하려고 할 때 미디어 캡처 작업을 실행 합니다. 실패 시나리오 등 캡처 응용 프로그램이, 캡처 작업은 이미 일어나 고, 또는 어떤 미디어 파일 캡처 전에 사용자가 작업을 취소 합니다.
367
368이 함수를 실행 하는 적절 한 오류 `code`를 포함 하는 `CaptureError` 개체와 함께.
369
370### 예를 들어
371
372 // capture error callback
373 var captureError = function(error) {
374 navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
375 };
376
377
378## ConfigurationData
379
380> 장치가 지 원하는 미디어 캡처 매개 변수 집합을 캡슐화 합니다.
381
382### 설명
383
384장치에서 지 원하는 미디어 캡처 모드를 설명 합니다. 구성 데이터는 MIME 유형 및 비디오 또는 이미지 캡처 캡처 크기 포함 됩니다.
385
386MIME 형식 [RFC2046][1]을 준수 해야 합니다. 예:
387
388 [1]: http://www.ietf.org/rfc/rfc2046.txt
389
390* `video/3gpp`
391* `video/quicktime`
392* `image/jpeg`
393* `audio/amr`
394* `audio/wav`
395
396### 속성
397
398* **유형**: 미디어 형식을 나타내는 ASCII로 인코딩 소문자 문자열. (DOMString)
399
400* **높이**: 이미지 또는 비디오 픽셀에서의 높이 있습니다. 사운드 클립에 대 한 0입니다. (수)
401
402* **폭**: 이미지 또는 비디오 픽셀에서의 너비. 사운드 클립에 대 한 0입니다. (수)
403
404### 예를 들어
405
406 // retrieve supported image modes
407 var imageModes = navigator.device.capture.supportedImageModes;
408
409 // Select mode that has the highest horizontal resolution
410 var width = 0;
411 var selectedmode;
412 for each (var mode in imageModes) {
413 if (mode.width > width) {
414 width = mode.width;
415 selectedmode = mode;
416 }
417 }
418
419
420모든 플랫폼에서 지원 되지 않습니다. 모든 구성 데이터 배열이 비어 있습니다.
421
422## MediaFile.getFormatData
423
424> 검색은 미디어 캡처 파일에 대 한 정보를 서식을 지정 합니다.
425
426 mediaFile.getFormatData(
427 MediaFileDataSuccessCB successCallback,
428 [MediaFileDataErrorCB errorCallback]
429 );
430
431
432### 설명
433
434이 함수는 비동기적으로 미디어 파일에 대 한 형식 정보를 검색 하려고 합니다. 성공 하면 `MediaFileData` 개체와 `MediaFileDataSuccessCB` 콜백을 호출 합니다. 시도가 실패 하는 경우이 함수는 `MediaFileDataErrorCB` 콜백을 호출 합니다.
435
436### 지원 되는 플랫폼
437
438* 아마존 화재 운영 체제
439* 안 드 로이드
440* 블랙베리 10
441* iOS
442* Windows Phone 7과 8
443* 윈도우 8
444
445### 아마존 화재 OS 단점
446
447미디어 파일 형식 정보에 액세스할 수 API는 제한, 그래서 모든 `MediaFileData` 속성이 지원 됩니다.
448
449### 블랙베리 10 단점
450
451그래서 모든 `MediaFileData` 개체 기본값으로 반환 미디어 파일에 대 한 정보에 대 한 API를 제공 하지 않습니다.
452
453### 안 드 로이드 단점
454
455미디어 파일 형식 정보에 액세스할 수 API는 제한, 그래서 모든 `MediaFileData` 속성이 지원 됩니다.
456
457### iOS 단점
458
459미디어 파일 형식 정보에 액세스할 수 API는 제한, 그래서 모든 `MediaFileData` 속성이 지원 됩니다.
460
461## MediaFile
462
463> 미디어 캡처 파일의 속성을 캡슐화합니다.
464
465### 속성
466
467* **이름**: 경로 정보 없이 파일 이름. (DOMString)
468
469* **fullPath**: 이름을 포함 한 파일의 전체 경로. (DOMString)
470
471* **유형**: 파일의 mime 형식 (DOMString)
472
473* **lastModifiedDate**: 날짜 및 시간 파일을 마지막으로 수정한. (날짜)
474
475* **크기**: 바이트에서 파일의 크기. (수)
476
477### 메서드
478
479* **MediaFile.getFormatData**: 미디어 파일의 형식 정보를 검색 합니다.
480
481## MediaFileData
482
483> 미디어 파일에 대 한 형식 정보를 캡슐화합니다.
484
485### 속성
486
487* **코덱**: 실제 형식의 오디오 및 비디오 콘텐츠. (DOMString)
488
489* **비트 레이트**: 콘텐츠의 평균 비트 전송률. 값은 이미지에 대 한 0. (수)
490
491* **높이**: 이미지 또는 비디오 픽셀에서의 높이 있습니다. 오디오 클립에 대 한 0입니다. (수)
492
493* **폭**: 이미지 또는 비디오 픽셀에서의 너비. 오디오 클립에 대 한 0입니다. (수)
494
495* **기간**: 초에 비디오 또는 사운드 클립의 길이. 값은 이미지에 대 한 0. (수)
496
497### 블랙베리 10 단점
498
499`MediaFileData` 개체 `MediaFile.getFormatData` 기능에 의해 다음 기본 값을 반환 없음 API 미디어 파일에 대 한 형식 정보를 제공 합니다.
500
501* **코덱**: 안 지원, 및 반환`null`.
502
503* **비트 레이트**: 안 지원, 및 0을 반환 합니다.
504
505* **높이**: 안 지원, 및 0을 반환 합니다.
506
507* **폭**: 안 지원, 및 0을 반환 합니다.
508
509* **기간**: 안 지원, 및 0을 반환 합니다.
510
511### 아마존 화재 OS 단점
512
513지원 되는 `MediaFileData` 속성:
514
515* **코덱**: 안 지원, 및 반환`null`.
516
517* **비트 레이트**: 안 지원, 및 0을 반환 합니다.
518
519* **높이**: 지원: 이미지 및 비디오 파일에만.
520
521* **폭**: 지원: 이미지 및 비디오 파일에만.
522
523* **기간**: 지원: 오디오 및 비디오 파일을
524
525### 안 드 로이드 단점
526
527지원 되는 `MediaFileData` 속성:
528
529* **코덱**: 안 지원, 및 반환`null`.
530
531* **비트 레이트**: 안 지원, 및 0을 반환 합니다.
532
533* **높이**: 지원: 이미지 및 비디오 파일에만.
534
535* **폭**: 지원: 이미지 및 비디오 파일에만.
536
537* **기간**: 지원: 오디오 및 비디오 파일을.
538
539### iOS 단점
540
541지원 되는 `MediaFileData` 속성:
542
543* **코덱**: 안 지원, 및 반환`null`.
544
545* **비트 레이트**: iOS4 장치 오디오 전용에 대 한 지원. 이미지 및 비디오에 대 한 반환 0입니다.
546
547* **높이**: 지원: 이미지 및 비디오 파일에만.
548
549* **폭**: 지원: 이미지 및 비디오 파일에만.
550
551* **기간**: 지원: 오디오 및 비디오 파일을.