===== Capture ===== ==== 설명 ==== * 디바이스의 오디오, 이미지, 비디오 캡쳐를 위한 기능을 제공한다.


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

==== 제약사항 ==== * Capture API의 플랫폼별 제약사항은 다음과 같다. === Android === == MediaFile.getFormatData == * 미디어 파일의 포맷 정보를 수집하는 API에 대해 제한이 있어, 일부 MediaFileData 속성을 지원하지 않는다. * MediaFileData : codecs, bitrate 을 지원하지 않는다. == CaptureAudioOptions == * duration 파라미터를 지원하지 않는다. * 프로그램적으로 녹음 시간을 제한할 수 없다. * mode 파라미터를 지원하지 않는다. * 오디오 녹음 포맷을 프로그램적으로 정의할 수 없다. * 오디오 녹음의 포맷은 audio/amr 만을 사용할 수 있다. == CaptureImageOptions == * mode 파라미터를 지원하지 않는다. * 이미지의 크기와 포맷을 프로그램적으로 정의할 수 없다. * 하지만 단말기 사용자가 이미지의 크기는 지정할 수 있다. * 이미지는 JPEG (image/jpeg) 로 저장된다. == CaptureVideoOptions == * duration 파라미터를 지원하지 않는다. * 비디오 촬영 크기를 프로그램적으로 제한할 수 없다. * mode 파라미터를 지원하지 않는다. * 비디오의 크기와 파라미터를 프로그램적으로 정의할 수 없다. * 비디오는 3GPP (videp/3gpp) 로 기본적으로 촬영된다. === iOS === == capture.captureAudio == * iOS는 단순한 유저 인터페이스를 가지기 때문에 기본적으로 오디오 녹음을 지원하지 않는다. == MediaFile.getFormatData == * 미디어 파일의 포맷 정보를 수집하는 API에 대해 제한이 있어, 일부 MediaFileData 속성을 지원하지 않는다. * MediaFileData : codecs을 지원하지 않는다. * MediaFileData : bitrate 는 iOS4 에서만 지원한다. == CaptureAudioOptions == * limit 파라미터를 지원하지 않는다. * 한 번에 하나의 녹음만 실행할 수 있다. * 오디오 녹음 포맷을 프로그램적으로 정의할 수 없다. * 오디오 녹음의 포맷은 audio/wav 만을 사용할 수 있다. == CaptureImageOptions == * limit 파라미터를 지원하지 않는다. * 한 번에 하나의 이미지만을 캡처할 수 있다 * mode 파라미터를 지원하지 않는다. * 이미지의 크기와 포맷을 프로그램적으로 정의할 수 없다. * 이미지는 JPEG (image/jpeg) 로 저장된다. == CaptureVideoOptions == * limit 파라미터는 지원하지 않는다. * 한 번에 하나의 비디오 촬영만 할 수 있다. * duration 파라미터를 지원하지 않는다. * 비디오 촬영 크기를 프로그램적으로 제한할 수 없다. * mode 파라미터를 지원하지 않는다. * 비디오의 크기와 파라미터를 프로그램적으로 정의할 수 없다. * 비디오는 MOV (video/quicktime) 로 기본적으로 촬영된다. ==== 환경 설정 ==== === Android === * app/res/xml/config.xml

* app/AndroidManifest

=== iOS === * App/Supporting Files/config.xml

==== 속성 ==== === supportedAudioModes === * 디바이스에서 제공하는 오디오 녹음 포맷. * ConfigurationData[] === supportedImageModes === * 디바이스에서 제공하는 이미지 사이즈와 포맷 * ConfigurationData[] === supportedVideoModes === * 디바이스에서 제공하는 비디오 포맷 * ConfigurationData[] ==== 관련 함수 ==== === capture.captureAudio === * 단말기의 녹음 프로그램을 호출하여 녹음을 하고, 녹음을 완료하면 녹음한 데이터(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});

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


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});

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


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 === * 미디어 파일의 포맷 정보를 가져온다.


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

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


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

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


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


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
    }
};

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


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

* Quick Example


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

=== ConfigurationData === * 디바이스에서 지원하는 캡처 속성들을 기록할 수 있는 객체. * 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;
    }
}