Capture

• 디바이스의 오디오, 이미지, 비디오 캡쳐를 위한 기능을 제공한다.

// The global capture object
var capture = navigator.device.capture;

• Capture API의 플랫폼별 제약사항은 다음과 같다.

• 미디어 파일의 포맷 정보를 수집하는 API에 대해 제한이 있어, 일부 MediaFileData 속성을 지원하지 않는다.
• MediaFileData : codecs, bitrate 을 지원하지 않는다.

• duration 파라미터를 지원하지 않는다.
• 프로그램적으로 녹음 시간을 제한할 수 없다.
• mode 파라미터를 지원하지 않는다.
• 오디오 녹음 포맷을 프로그램적으로 정의할 수 없다.
• 오디오 녹음의 포맷은 audio/amr 만을 사용할 수 있다.

• mode 파라미터를 지원하지 않는다.
• 이미지의 크기와 포맷을 프로그램적으로 정의할 수 없다.
• 하지만 단말기 사용자가 이미지의 크기는 지정할 수 있다.
• 이미지는 JPEG (image/jpeg) 로 저장된다.

• duration 파라미터를 지원하지 않는다.
• 비디오 촬영 크기를 프로그램적으로 제한할 수 없다.
• mode 파라미터를 지원하지 않는다.
• 비디오의 크기와 파라미터를 프로그램적으로 정의할 수 없다.
• 비디오는 3GPP (videp/3gpp) 로 기본적으로 촬영된다.

• iOS는 단순한 유저 인터페이스를 가지기 때문에 기본적으로 오디오 녹음을 지원하지 않는다.

• 미디어 파일의 포맷 정보를 수집하는 API에 대해 제한이 있어, 일부 MediaFileData 속성을 지원하지 않는다.
• MediaFileData : codecs을 지원하지 않는다.
• MediaFileData : bitrate 는 iOS4 에서만 지원한다.

• limit 파라미터를 지원하지 않는다.
• 한 번에 하나의 녹음만 실행할 수 있다.
• 오디오 녹음 포맷을 프로그램적으로 정의할 수 없다.
• 오디오 녹음의 포맷은 audio/wav 만을 사용할 수 있다.

• limit 파라미터를 지원하지 않는다.
• 한 번에 하나의 이미지만을 캡처할 수 있다
• mode 파라미터를 지원하지 않는다.
• 이미지의 크기와 포맷을 프로그램적으로 정의할 수 없다.
• 이미지는 JPEG (image/jpeg) 로 저장된다.

• limit 파라미터는 지원하지 않는다.
• 한 번에 하나의 비디오 촬영만 할 수 있다.
• duration 파라미터를 지원하지 않는다.
• 비디오 촬영 크기를 프로그램적으로 제한할 수 없다.
• mode 파라미터를 지원하지 않는다.
• 비디오의 크기와 파라미터를 프로그램적으로 정의할 수 없다.
• 비디오는 MOV (video/quicktime) 로 기본적으로 촬영된다.

• app/res/xml/config.xml

<plugin name="Capture" value="org.apache.cordova.Capture"/>

• app/AndroidManifest

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

• App/Supporting Files/config.xml

    <feature name="Capture">
        <param name="ios-package" value="CDVCapture"/>
    </feature>

• 디바이스에서 제공하는 오디오 녹음 포맷.
• ConfigurationData[]

• 디바이스에서 제공하는 이미지 사이즈와 포맷
• ConfigurationData[]

• 디바이스에서 제공하는 비디오 포맷
• ConfigurationData[]

• 단말기의 녹음 프로그램을 호출하여 녹음을 하고, 녹음을 완료하면 녹음한 데이터(clip) 를 가져온다.

navigator.device.capture.captureAudio( 
    CaptureCB captureSuccess, CaptureErrorCB captureError,  [CaptureAudioOptions options]
);

• Quick Example

// capture callback
var captureSuccess = function(mediaFiles) {
    var i, path, len;
    for (i = 0, len = mediaFiles.length; i < len; i += 1) {
        path = mediaFiles[i].fullPath;
        // do something interesting with the file
    }
};

// capture error callback
var captureError = function(error) {
    navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};

// start audio capture
navigator.device.capture.captureAudio(captureSuccess, captureError, {limit:2});

• 단말기의 카메라 프로그램을 호출하여 사진을 찍고 찍은 이미지를 가져온다.
• 캡쳐된 이미지 파일에 대한 정보를 가져온다.

navigator.device.capture.captureImage( 
    CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureImageOptions options]
);

• Quick Example

// capture callback
var captureSuccess = function(mediaFiles) {
    var i, path, len;
    for (i = 0, len = mediaFiles.length; i < len; i += 1) {
        path = mediaFiles[i].fullPath;
        // do something interesting with the file
    }
};

// capture error callback
var captureError = function(error) {
    navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};

// start image capture
navigator.device.capture.captureImage(captureSuccess, captureError, {limit:2});

• 단말기의 카메라 프로그램을 호출하여 동영상을 촬영하고 촬영한 비디오를 가져온다.

navigator.device.capture.captureVideo( 
    CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureVideoOptions options]
);

• Quick Example

// capture callback
var captureSuccess = function(mediaFiles) {
    var i, path, len;
    for (i = 0, len = mediaFiles.length; i < len; i += 1) {
        path = mediaFiles[i].fullPath;
        // do something interesting with the file
    }
};

// capture error callback
var captureError = function(error) {
    navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};

// start video capture
navigator.device.capture.captureVideo(captureSuccess, captureError, {limit:2});

• 미디어 파일의 포맷 정보를 가져온다.

mediaFile.getFormatData( 
    MediaFileDataSuccessCB successCallback, 
    [MediaFileDataErrorCB errorCallback]
);

• 녹음을 지원하는 captureAudio() 메소드에 대한 옵션 객체.

var options = { limit: 3, duration: 10 };

navigator.device.capture.captureAudio(captureSuccess, captureError, options);

• 이미지 촬영을 지원하는 captureImage() 메소드에 대한 옵션 객체.

navigator.device.capture.captureImage( 
    CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureImageOptions options]
);

• 동영상 촬영을 지원하는 captureVideo() 메소드에 대한 옵션 객체.

var options = { limit: 3 };

navigator.device.capture.captureVideo(captureSuccess, captureError, options);

• 미디어 촬영 중에 발생할 수 있는 오류코드를 기록하는 객체.

• 미디어 활영에 성공했을 때 실행하는 함수.

function captureSuccess( MediaFile[] mediaFiles ) { ... };

• Quick Example

function captureSuccess(mediaFiles) {
    var i, path, len;
    for (i = 0, len = mediaFiles.length; i < len; i += 1) {
        path = mediaFiles[i].fullPath;
        // do something interesting with the file
    }
};

• 미디어 촬영에 실패했을 때 실행하는 함수.

function captureError( CaptureError error ) { ... };

• Quick Example

var captureError = function(error) {
    navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
};

• 디바이스에서 지원하는 캡처 속성들을 기록할 수 있는 객체.
• video/3gpp, video/quicktime, image/jpeg, audio/amr, audio/wav

• Quick Example

var imageModes = navigator.device.capture.supportedImageModes;

var width = 0;
var selectedmode;
for each (var mode in imageModes) {
    if (mode.width > width) {
        width = mode.width;
        selectedmode = mode;
    }
}

• 캡처한 파일의 속성들을 기록할 수 있는 객체.
• MediaFile.getFormatData

• 미디어 파일에 대한 포맷 정보를 나타내는 객체.

• 지원 속성

• Phonegap : http://docs.phonegap.com/en/2.9.0/cordova_media_capture_capture.md.html#Capture 새 창 열림