옵션

다음 표는 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]). 각 정수는 서로 다른 노출 프로그램을 나타냅니다.
  • 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-stop) rw
apertureSupport 숫자 배열

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

API 수준 2: 현재 사용 가능한 조리개 설정 목록이며 f/number로 표현됩니다. 예를 들어 0는 auto 모드를 나타냅니다.

 r
whiteBalance 문자열 현재 화이트 밸런스 설정(예: daylight) 기본값은 auto입니다. rw
whiteBalanceSupport 문자열 배열 현재 사용 가능한 화이트 밸런스 설정 목록은 사전 정의된 목록 [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]의 하위 집합일 수 있습니다. 각 항목의 값은 다음과 같습니다.
  • incandescent, 약 320만
  • fluorescent, 약 400만
  • datalight, 약 520만
  • cloudy-daylight, 약 6000K
  • shade, 약 700만
  • twilight, 약 12,000,000
공급업체별 설정 이름에 밑줄을 사용합니다(예: _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은 범위, [-90, 90] 및 lng은 [-180, 180]입니다. 휴대전화에서 제공하는 경우 각 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시간 형식, 날짜 및 시간은 공백으로 구분되고 시간대는 UTC 시간과의 오프셋입니다. 예를 들어 2014:05:18 01:04:29+8:00은 중국 시간대 (UTC+8:00)입니다. rw
hdr

API 수준 1: 부울

API 수준 2: 문자열

API 수준 1: HDR 캡처 모드를 사용 설정/사용 중지합니다. 값은 true이며 HDR을 사용 설정하려면 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)가 포함된 경우에만 사용할 수 있습니다. 카메라가 수동 노출 브라케팅을 사용하는 경우에는 객체에 다음 두 가지 항목이 포함됩니다.
  1. shots: 촬영할 샷의 수를 포함하는 정수입니다.
  2. increment: 장면 간 EV 증분을 포함하는 숫자입니다.
예: 
{
    "shots": 3,
    "increment": 1.33
}
카메라에서 자동 노출 브라케팅을 사용하는 경우 객체에 다음이 포함됩니다. 
{
    "autoMode": true
}

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 수준입니다. API 수준 1용으로 작성된 클라이언트가 변경 없이 카메라와 계속 작동하도록 카메라가 API 수준 1과 2를 모두 지원하는 경우 기본값은 1입니다. 클라이언트가 API 수준 2로 이전하기 전에 권장되지 않는 API 수준 2만 지원하는 경우에는 기본값이 2입니다. 카메라가 API 수준 2만 지원하는 경우 카메라를 1로 설정하려는 요청은 실패합니다. clientVersion이 2로 정상적으로 설정되고 API 수준 1에서 지원 중단된 명령어가 요청되면 요청이 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 옵션 목록입니다. 동영상 캡처 중에 카메라가 GPS를 계속 캡처하고 동영상에 위치를 삽입할 수 있다면 [continuous]를 반환합니다. 가능하지 않은 경우 [none]를 반환하고 동영상 GPS 지원이 사용자 구성 가능한 경우 [none,continuous]를 반환합니다. 공급업체별 설정 이름에 밑줄을 사용합니다(예: _vendor-setting).

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

 r
videoGPS 문자열

동영상 캡처 중에 GPS를 지원하는 현재 옵션(예: continuous) 지원되는 경우 기본값은 continuous입니다.

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

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