옵션

다음 표는 camera.setOptions 및 camera.getOptions로 설정하고 가져올 수 있는 모든 옵션을 보여줍니다. 해당 지원이 비어 있거나 옵션을 하나만 포함하는 경우 옵션을 변경할 수 없습니다.

이름 유형 설명 읽기/쓰기
captureMode 문자열 현재 캡처 모드입니다. 기본 설정: image. rw
captureModeSupport 문자열 배열 현재 사용할 수 있는 캡처 모드 목록입니다. API 수준 1의 최소 요구사항은 ["image"], API 수준 2의 최소 요구사항은 ["image", "interval"]입니다. 여기서 "interval"는 특정 간격으로 간격이 있는 일련의 이미지를 캡처하는 모드를 나타냅니다. captureInterval 및 captureIntervalSupport도 참고하세요. 두 가지 추가 모드 ("video" and "walkaround")가 API 수준 2에서 지원되므로 API 수준 2에서 지원하는 전체 설정은 ["image", "interval", "video", "walkaround"]입니다. 여기서 "video"는 동영상 캡처 모드를 나타내며 "walkaround"는 두 이미지를 순서대로 캡처하는 모드를 나타냅니다. 첫 번째 모드는 사용자가 카메라 반대편 (첫 번째 스탠딩 포인트를 기준으로)에 서 있는 모드입니다. 이렇게 하면 카메라는 두 이미지를 결합하여 최종 이미지에서 사용자를 삭제할 수 있습니다. "walkaround"가 카메라에서 지원되고 현재 캡처 모드로 설정된 경우 클라이언트는 두 개의 TakePicture 명령어를 카메라에 전송할 것으로 예상해야 합니다. 여기서 첫 번째 명령어의 응답 (완료 시)은 카메라가 두 번째 이미지를 촬영할 준비가 되었음을 나타내고 두 번째 명령어는 완료 시 최종 이미지를 반환해야 합니다.

아직 지원되지 않는 캡처 모드를 추가하려면 공급업체별 모드 앞에 밑줄 ( _)을 붙이세요.

이 옵션은 API 수준 2에서 수정되었습니다.

 r
captureStatus 문자열 현재 캡처 상태입니다. 기본값은 "idle"입니다. 이는 앱에 처음 연결할 때 카메라 상태를 확인하는 데 유용합니다. 카메라를 동영상 촬영 중인 경우 다른 작업을 지시하기 전에 카메라를 중지해야 할 수 있습니다. 예를 들어 다시 촬영하기로 했습니다.

이 옵션은 API 수준 2.1에 추가되었습니다.

 rw
captureStatusSupport 문자열 배열 현재 사용 가능한 캡처 상태 목록입니다. 동영상 촬영이 지원되면 기본적으로 ["idle", "shooting"]로 설정되어 있어야 합니다. 다른 조각상도 제공할 수 있습니다(예: "downloading"

이 옵션은 API 수준 2.1에 추가되었습니다.

 r
exposureProgram 숫자 현재 노출 프로그램입니다. rw
exposureProgramSupport 숫자 배열 현재 이용 가능한 노출 프로그램 목록 예: [0, 1, 2, 3, 4] 각 정수는 서로 다른 노출 프로그램을 나타냅니다. <ph type="x-smartling-placeholder">
    </ph>
  • 0 = 정의되지 않음
  • 1 = 수동
  • 2 = 일반 프로그램
  • 3 = 조리개 우선
  • 4 = 셔터 우선순위
를 통해 개인정보처리방침을 정의할 수 있습니다. ExposureProgram에 대한 자세한 내용을 다운로드하려면 다음 링크를 선택하세요. 		r
iso 숫자 현재 ISO 속도 설정입니다. rw
isoSupport 숫자 배열

API 수준 1: 현재 사용 가능한 ISO 설정 목록입니다. 예를 들어 auto 모드인 경우 [100, 200, 400, 800,1600] 또는 []입니다.

API 수준 2: 현재 사용 가능한 ISO 설정 목록입니다. 예를 들어 [0, 100, 200, 400, 800, 1600]입니다. 여기서 0는 auto 모드를 나타냅니다.

이 옵션은 API 수준 2에서 수정되었습니다.

 r
shutterSpeed 숫자 현재 셔터 속도 설정입니다. rw
shutterSpeedSupport 숫자 배열

API 수준 1: 현재 사용 가능한 셔터 속도 목록입니다. 예를 들어 auto 모드인 경우 [0.067, 0.033, 0.017,0.008] 또는 []입니다.

API 수준 2: 현재 사용 가능한 셔터 속도 목록입니다. 예를 들어 [0, 0.067, 0.033, 0.017, 0.008]입니다. 여기서 0는 auto 모드를 나타냅니다.

이 옵션은 API 수준 2에서 수정되었습니다.

 r
aperture 숫자 현재 조리개 설정(f-스톱)입니다. rw
apertureSupport 숫자 배열

API 수준 1: 현재 사용 가능한 조리개 설정 목록(f/number로 표시) 대상: 예를 들어 auto 모드인 경우 [1.4, 2, 2.8, 4, 5.6, 8, 11] 또는 []입니다.

API 수준 2: 현재 사용 가능한 조리개 설정 목록(f/number로 표시) 예를 들어 [0, 1.4, 2, 2.8, 4, 5.6, 8, 11]입니다. 여기서 0는 auto 모드를 나타냅니다.

 r
whiteBalance 문자열 현재 화이트 밸런스 설정 예: daylight 기본값은 auto입니다. rw
whiteBalanceSupport 문자열 배열 현재 사용 가능한 화이트 밸런스 설정 목록은 사전 정의된 목록의 하위 집합일 수 있습니다. [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"] 각 값: <ph type="x-smartling-placeholder">
    </ph>
  • incandescent, 약 320만
  • fluorescent, 약 4000K
  • datalight, 약 520만
  • cloudy-daylight, 약 6000K
  • shade, 약 7000K
  • twilight, 약 12000K
를 통해 개인정보처리방침을 정의할 수 있습니다. 공급업체별 설정 이름 앞에 밑줄을 붙입니다. 예: _vendor-setting		 r
exposureCompensation 숫자 현재 노출 보정입니다. rw
exposureCompensationSupport 숫자 배열 현재 사용 가능한 노출 보정 목록(일반적으로 0.33단계 또는 0.5; 예: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat 객체

현재 파일 형식 및 해상도 형식에는 captureMode의 현재 값이 반영되어야 합니다. 예를 들어 captureMode가 image이면 적절한 응답은 다음과 같을 수 있습니다.

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
captureMode가 video이면 적절한 응답은 다음과 같을 수 있습니다. 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

이 옵션은 API 수준 2에서 수정되었습니다.

 rw
fileFormatSupport 객체 배열

현재 사용 가능한 파일 형식의 목록입니다. 예를 들면 다음과 같습니다.

[
    {
    "type": "jpeg",
    "width": 2000,
    "height": 1000
    },
    {
    "type": "jpeg",
    "width": 200,
    "height": 100
    },
    {
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 24
    },
    {
    "type": "mp4",
    "width": 1280,
    "height": 720,
    "framerate": 30
    },
    ...
]
모든 유형에 대해 자세히 알아보려면 다음 링크를 선택하세요.

이 옵션은 API 수준 2에서 수정되었습니다.

 r
exposureDelay 숫자 takePicture 명령어와 노출이 시작된 시점 사이의 현재 지연 시간(초)입니다. rw
exposureDelaySupport 숫자 배열 현재 사용 가능한 노출 지연 목록(초) 예: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay 숫자 카메라가 절전 모드로 전환되기 전의 현재 지연 시간(초)입니다. rw
sleepDelaySupport 숫자 배열 현재 사용 가능한 절전 모드 지연 목록(초) 예를 들어 [30, 60, 120, 300, 600, 1800, 65535]의 경우 65535에서 수면 모드를 사용 중지하며 (전원이 꺼질 때까지 카메라가 절전 모드로 전환되지 않음) 지원되어야 합니다. r
offDelay 숫자 카메라가 꺼지기 전까지의 현재 지연 시간(초)입니다. rw
offDelaySupport 숫자 배열 현재 사용 가능한 전원 끄기 지연 목록(초) 예를 들어 [1800, 3600, 7200, 65535]. 여기서 65535는 전원 끄기 모드를 사용 중지하며 (배터리가 소진되거나 수동으로 꺼질 때까지 카메라가 꺼지지 않음) 지원되어야 합니다. r
totalSpace 숫자 읽기 전용: 총 스토리지의 바이트 수입니다. r
remainingSpace 숫자 읽기 전용: 무료 저장용량(바이트)입니다. r
remainingPictures 숫자 읽기 전용: 현재 캡처를 기준으로 남은 예상 사진 수 설정을 변경합니다. r
gpsInfo 객체

현재 GPS 정보입니다. 휴대전화 GPS를 사용하여 setOptions을(를) 사용하여 설정:

{
    "lat": 23.532,
    "lng": -132.35
}
lat 및 lng 속성은 십진수 도이며 범위 내 lat, [-180, 180] 범위 내 [-90, 90], lng입니다. 휴대전화로 제공되는 경우 각 GPS 위치는 다음 업데이트까지 기다려야 합니다. 휴대전화에서 업데이트 시기를 결정해야 함 GPS 위치 예를 들어 각 takePicture 명령어 바로 앞에 추가할 수 있습니다. 65535에서 카메라에 현재 GPS 위치가 유효하지 않다고 알립니다. 카메라는 이를 무시하고 자체 GPS가 있는 경우 이를 사용해야 합니다. 예를 들어 setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}})는 GPS 위치가 잘못되었습니다.		 rw
dateTimeZone 문자열 현재 날짜 및 시간 정보입니다. 휴대전화의 날짜, 시간, 시간대를 사용하여 setOptions에 의해 설정됩니다. 형식은 YYYY:MM:DD HH:MM:SS+(-)HH:MM입니다. 시간은 24시간 형식이며 날짜와 시간은 공백으로 구분됩니다. andtime Zone은 UTC 시간으로부터의 오프셋입니다. 예를 들어 2014:05:18 01:04:29+8:00은 중국 시간대 (UTC+8:00)입니다. rw
hdr

API 수준 1: 불리언

API 수준 2: 문자열

API 수준 1: HDR 캡처 모드를 사용 설정/사용 중지합니다. HDR을 사용 설정하려면 값은 true, 사용 중지하려면 false입니다. 기본값은 false입니다. hdrSupport도 true인 경우에만 true로 설정할 수 있습니다.

API 수준 2: 문자열 유형의 현재 HDR 모드입니다.

이 옵션은 API 수준 2에서 수정되었습니다.

 rw
hdrSupport

API 수준 1: 불리언

API 수준 2: 문자열 배열

API 수준 1: 값이 true이면 카메라가 HDR을 지원함을 나타냅니다. false 설정은 HDR이 적용되지 않는 카메라를 식별합니다.

API 수준 2: HDR 모드를 지원하지 않는 경우 [“off”] 하나의 HDR 모드를 지원하면 [“off”, “hdr”]이며 여러 HDR 모드 (다른 알고리즘 기반)가 지원되는 경우 [“off”, “hdr”, “hdr1”, “hdr2”, ...]입니다.

이 옵션은 API 수준 2에서 수정되었습니다.

 r
exposureBracket 객체 현재 노출 브래킷 설정입니다. hdrSupport == true (API 수준 1) 또는 hdrSupport에 HDR 모드(API 수준 2)가 하나 이상 포함된 경우에만 사용할 수 있습니다. 카메라에서 수동 노출 브라케팅을 사용하는 경우 객체에는 다음 두 항목이 포함됩니다. <ph type="x-smartling-placeholder">
    </ph>
  1. shots: 촬영할 샷 수를 포함하는 정수입니다.
  2. increment: 장면 간 EV 증가를 포함하는 숫자입니다.
를 통해 개인정보처리방침을 정의할 수 있습니다. 예를 들면 다음과 같습니다. 
{
    "shots": 3,
    "increment": 1.33
}
카메라에서 자동 노출 브라케팅을 사용하는 경우 피사체에 다음이 포함됩니다. <ph type="x-smartling-placeholder"> 
{
    "autoMode": true
}
</ph>

API 수준 1: hdrSupport == false인 경우 기본적으로 빈 {}가 됩니다. hdr이 true인 경우 제조업체에서 기본값 (예: 자동 노출 브라케팅)을 결정합니다.

API 레벨 2: hdrSupport에 "off"만 포함된 경우 기본적으로 비어 있는 {}로 설정됩니다. 그렇지 않으면 제조업체에서 기본값을 결정합니다 (예: 자동 노출 브라케팅).

이 옵션은 API 수준 2에서 수정되었습니다.

 rw
exposureBracketSupport 객체

현재 노출 브래킷 설정 사용 가능, 예를 들면 다음과 같습니다.

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

API 수준 1: hdrSupport == false인 경우 기본값은 빈 {}입니다. hdrSupport == true이지만 자동 노출 브라케팅이 지원되지 않는 경우 autoMode는 false입니다.

API 수준 2: hdrSupport에 "off"만 포함된 경우 기본적으로 빈 {}가 됩니다. hdrSupport에 HDR 모드가 포함되어 있지만 자동 노출 브라케팅이 지원되지 않는 경우 autoMode는 false이 됩니다.

이 옵션은 API 수준 2에서 수정되었습니다.

 r
gyro 불리언 카메라의 자이로스코프 모듈을 사용 설정하려면 true로 설정하고 이 기능을 사용 중지하려면 false로 설정합니다. 카메라에서 지원하는 경우 기본값은 true이고 지원되지 않으면 false입니다. 이 설정은 gyroSupport == true인 경우에만 true로 지정할 수 있습니다. rw
gyroSupport 불리언 카메라에 자이로스코프가 있으면 이 값은 true여야 하고 그렇지 않으면 false입니다. r
gps 불리언 카메라 GPS 모듈을 사용 설정/사용 중지합니다. 사용 설정하려면 값이 true, 중지하려면 false여야 합니다. 기본값은 카메라가 지원하는 경우 true, 지원하지 않으면 false입니다. gpsSupport == true인 경우에만 true로 설정됩니다. rw
gpsSupport 불리언 이 값은 카메라에 자체 GPS 모듈이 있는 경우 true, 그렇지 않은 경우 false입니다. r
imageStabilization 문자열 현재 이미지 떨림 보정 작업입니다. 예: off rw
imageStabilizationSupport 문자열 배열 현재 이미지 떨림 보정 옵션을 사용할 수 있습니다. 사전 정의된 목록은 ["off", "on"]입니다.카메라가 이미지 흔들림 보정을 지원하지 않으면 ["off"]을 반환하고 그렇지 않으면 ["off", "on"]를 반환합니다. 공급업체별 문자열 앞에 밑줄 ( _ )을 붙입니다. 예: [ "off", "_horizontal_stabilization", "_vibration_correction" ] r
wifiPassword 문자열
공백 없이 문자, 숫자, 기호를 포함하는 8자 이상이어야 합니다. 카메라가 클라이언트 기기에 연결된 경우에만 변경할 수 있습니다. 변경되면 카메라 연결이 해제되어야 하므로 사용자는 새 wifiPassword를 사용하여 다시 연결해야 합니다.
비밀번호를 잊어버린 경우에 대비해 카메라에서 재설정 메커니즘을 제공해야 합니다. 예를 들어 초기화 버튼이 있어야 합니다.
 w
previewFormat 객체

현재 실시간 미리보기 해상도 예를 들면 다음과 같습니다.

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

이 옵션은 API 수준 2에 추가되었습니다.

 rw
previewFormatSupport 객체 배열

현재 지원되는 실시간 미리보기 형식 예를 들면 다음과 같습니다.

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

이 옵션은 API 수준 2에 추가되었습니다.

 r
captureInterval 숫자 seconds에서 연속하는 두 이미지 캡처 간의 현재 간격입니다.

이 옵션은 API 수준 2에 추가되었습니다.

 rw
captureIntervalSupport 객체

연속하는 두 이미지 캡처 간에 허용되는 최소 및 최대 간격(초) 예를 들면 다음과 같습니다.

{
    "minInterval": 10,
    "maxInterval": 60
}
fileFormat에 따라 다를 수 있습니다.

이 옵션은 API 수준 2에 추가되었습니다.

 r
captureNumber 숫자 하나의 인터벌 캡처 세션 동안 캡처할 이미지의 수입니다. 기본값은 0입니다. 즉, stopCapture 명령어로 캡처를 명시적으로 종료해야 합니다. 그렇지 않으면 지정된 번호의 이미지를 캡처한 후 캡처가 자동으로 중지됩니다. 카메라 배터리가 소진되거나 의도적으로 꺼졌을 때도 캡처가 중단될 수 있습니다.

이 옵션은 API 수준 2에 추가되었습니다.

 rw
captureNumberSupport 객체

인터벌 캡처 중에 캡처할 수 있는 이미지의 최소 및 최대 수 예를 들면 다음과 같습니다.

{
    "minNumber": 2,
    "maxNumber": 50
}
남은 저장용량에 따라 변경될 수 있습니다.

이 옵션은 API 수준 2에 추가되었습니다.

 r
remainingVideoSeconds 숫자 현재 캡처 설정을 기준으로 남은 동영상의 예상 seconds 수입니다.

이 옵션은 API 수준 2에 추가되었습니다.

 r
pollingDelay 숫자 연속하는 두 상태 폴링 요청 사이의 최소 간격(초)입니다. 클라이언트는 이 필드를 사용하여 상태 폴링 동작을 안내해야 합니다. 예를 들어 이미지를 연결할 때 클라이언트는 병합이 완료되었는지 확인하기 위해 카메라를 정기적으로 폴링해야 할 수 있습니다. 카메라에 따라 지원이 다릅니다. 예를 들어 일부 카메라는 1초마다 상태 폴링을 처리할 수 있고 다른 카메라는 더 긴 간격을 지원합니다.

이 옵션은 API 수준 2에 추가되었습니다.

 r
delayProcessing 불리언 처리 (예: 병합)가 캡처보다 우선순위가 낮을 때 True, 즉 이전에 캡처된 이미지의 처리가 완료되기 전에 다른 캡처가 허용됩니다. 특히 처리 시간이 오래 걸리는 카메라의 경우 이 방법을 사용하는 것이 좋습니다.

이 옵션은 API 수준 2에 추가되었습니다.

 rw
delayProcessingSupport 부울 배열

[true]: 처리 (예: 병합)의 우선순위가 캡처보다 낮으며 기본적으로 항상 지연됨을 의미합니다.

[false]는 캡처 직후에 처리가 진행된다는 것을 의미합니다.

[true, false]은 이 두 가지 모드 중에서 선택할 수 있음을 의미합니다.

이 옵션은 API 수준 2에 추가되었습니다.

 r
clientVersion 숫자

클라이언트가 사용하기로 결정한 API 수준입니다. 다음과 같은 경우 기본값은 1입니다. 카메라는 API 수준 1과 2를 모두 지원하므로 API 수준 1은 변경 없이 계속 카메라에서 작동합니다. 기본값 카메라가 API 수준 2만 지원하는 경우에는 2로 설정해야 합니다. API 수준 2로 이전하기 전에 권장되는 사항입니다. 카메라가 API 수준 2만 지원하므로 1로 설정하려는 요청이 있습니다 clientVersion가 2로 설정되어 있고 지원 중단된 명령어가 요청되면 오류 코드 unknownCommand와 함께 실패합니다.

이 옵션은 API 수준 2에 추가되었습니다.

 rw
photoStitchingSupport 문자열 배열

사진 병합 옵션 목록입니다. 돌아가기 [ondevice]: 사진이 항상 카메라에서 병합되는 경우 카메라가 사진을 연결할 수 없는 경우 [none] 연결을 사용자가 구성할 수 있는 경우 [none,ondevice]입니다. 공급업체별 설정 이름 앞에 밑줄을 붙입니다. 예: _vendor-setting

이 옵션은 API 수준 2.1에 추가되었습니다.

 r
photoStitching 문자열

사진의 현재 병합 옵션(예: ondevice 다음 값을 기본값으로 하세요. ondevice 지원됩니다.

이 옵션은 API 수준 2.1에 추가되었습니다.

 rw
videoStitchingSupport 문자열 배열

동영상 병합 옵션의 목록입니다. 돌아가기 [ondevice]: 동영상이 항상 카메라에서 병합되는 경우 카메라가 동영상을 연결할 수 없는 경우 [none] 연결을 사용자가 구성할 수 있는 경우 [none,ondevice]입니다. 공급업체별 설정 이름 앞에 밑줄을 붙입니다. 예: _vendor-setting

이 옵션은 API 수준 2.1에 추가되었습니다.

 r
videoStitching 문자열

동영상의 현재 병합 옵션(예: ondevice 다음 값을 기본값으로 하세요. ondevice 지원됩니다.

이 옵션은 API 수준 2.1에 추가되었습니다.

 rw
videoGPSSupport 문자열 배열

동영상 캡처 중의 GPS 옵션 목록입니다. 돌아가기 [continuous]: 카메라가 GPS를 계속 캡처할 수 있는 경우 동영상에 위치 정보를 삽입합니다. 돌아가기 [none] 및 [none,continuous] 비디오 GPS 지원을 사용자가 구성할 수 있는 경우. 공급업체별로 접두사 추가 밑줄이 포함된 설정 이름(예: _vendor-setting

이 옵션은 API 수준 2.1에 추가되었습니다.

 r
videoGPS 문자열

동영상 캡처 중 GPS 지원에 대한 현재 옵션(예: continuous 다음 값을 기본값으로 하세요. continuous 지원됩니다.

이 옵션은 API 수준 2.1에 추가되었습니다.

 rw
_vendorSpecific [type] (선택사항) 공급업체별 추가 카메라 옵션입니다. 공급업체별 문자열 앞에 다음을 붙입니다. 밑줄 ( _)