다음 표는 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] ). 각 정수는 서로 다른 노출 프로그램을 나타냅니다.
ExposureProgram 에 관한 추가 세부정보를 다운로드하세요.
|
r |
iso |
숫자 | 현재 ISO 속도 설정입니다. | rw |
isoSupport |
숫자 배열 | API 수준 1: 현재 사용 가능한 ISO 설정 목록입니다(예: API 수준 2: 현재 사용 가능한 ISO 설정 목록입니다. 예: 이 옵션은 API 수준 2에서 수정되었습니다. |
r |
shutterSpeed |
숫자 | 현재 셔터 속도 설정입니다. | rw |
shutterSpeedSupport |
숫자 배열 | API 수준 1: 현재 사용 가능한 셔터 속도 목록(예: API 수준 2: 현재 사용 가능한 셔터 속도 목록입니다. 예를 들어 이 옵션은 API 수준 2에서 수정되었습니다. |
r |
aperture |
숫자 | 현재 조리개 설정(f-stop) | rw |
apertureSupport |
숫자 배열 | API 수준 1: 현재 사용 가능한 조리개 설정 목록입니다. API 수준 2: 현재 사용 가능한 조리개 설정 목록이며 |
r |
whiteBalance |
문자열 | 현재 화이트 밸런스 설정(예: daylight ) 기본값은 auto 입니다. |
rw |
whiteBalanceSupport |
문자열 배열 | 현재 사용 가능한 화이트 밸런스 설정 목록은 사전 정의된 목록 [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"] 의 하위 집합일 수 있습니다. 각 항목의 값은 다음과 같습니다.
_vendor-setting ). |
r |
exposureCompensation |
숫자 | 현재 노출 보정 | rw |
exposureCompensationSupport |
숫자 배열 | 현재 사용 가능한 노출 보정 목록(일반적으로 0.33단계 또는 0.5단계)(예: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] ) |
r |
fileFormat |
객체 | 현재 파일 형식 및 해상도입니다. 형식은 { "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를 사용하여 { "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 캡처 모드를 사용 설정/사용 중지합니다. 값은 API 수준 2: 문자열 유형의 현재 HDR 모드입니다. 이 옵션은 API 수준 2에서 수정되었습니다. |
rw |
hdrSupport |
API 수준 1: 부울 API 수준 2: 문자열 배열 |
API 수준 1: 값이 API 수준 2: HDR 모드를 지원하지 않는 경우 이 옵션은 API 수준 2에서 수정되었습니다. |
r |
exposureBracket |
객체 | 현재 노출 브래킷 설정 hdrSupport == true (API 수준 1) 또는 hdrSupport 에 하나 이상의 HDR 모드(API 수준 2)가 포함된 경우에만 사용할 수 있습니다. 카메라가 수동 노출 브라케팅을 사용하는 경우에는 객체에 다음 두 가지 항목이 포함됩니다.
{ "shots": 3, "increment": 1.33 }카메라에서 자동 노출 브라케팅을 사용하는 경우 객체에 다음이 포함됩니다. { "autoMode": true } API 수준 1: API 수준 2: 이 옵션은 API 수준 2에서 수정되었습니다. |
rw |
exposureBracketSupport |
객체 | 현재 노출 브래킷 설정을 사용할 수 있습니다. 예를 들면 다음과 같습니다. { "autoMode": true, "shotsSupport": [1, 3, 5, 7], "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2] } API 수준 1: API 수준 2: 이 옵션은 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 |
부울 배열 |
이 옵션은 API 수준 2에 추가되었습니다. |
r |
clientVersion |
숫자 | 클라이언트가 사용하기로 결정한 API 수준입니다. API 수준 1용으로 작성된 클라이언트가 변경 없이 카메라와 계속 작동하도록 카메라가 API 수준 1과 2를 모두 지원하는 경우 기본값은 1입니다. 클라이언트가 API 수준 2로 이전하기 전에 권장되지 않는 API 수준 2만 지원하는 경우에는 기본값이 2입니다. 카메라가 API 수준 2만 지원하는 경우 카메라를 1로 설정하려는 요청은 실패합니다. 이 옵션은 API 수준 2에 추가되었습니다. |
rw |
photoStitchingSupport |
문자열 배열 | 사진 병합 옵션 목록입니다. 사진이 카메라에 항상 병합되지 않으면 이 옵션은 API 수준 2.1에 추가되었습니다. |
r |
photoStitching |
문자열 | 사진의 병합 옵션(예: 이 옵션은 API 수준 2.1에 추가되었습니다. |
rw |
videoStitchingSupport |
문자열 배열 | 동영상의 병합 옵션 목록입니다. 동영상이
카메라에 항상 병합되지 않으면 이 옵션은 API 수준 2.1에 추가되었습니다. |
r |
videoStitching |
문자열 | 동영상의 병합 옵션(예: 이 옵션은 API 수준 2.1에 추가되었습니다. |
rw |
videoGPSSupport |
문자열 배열 | 동영상 캡처 중 GPS 옵션 목록입니다. 동영상 캡처 중에 카메라가 GPS를 계속 캡처하고 동영상에 위치를 삽입할 수 있다면 이 옵션은 API 수준 2.1에 추가되었습니다. |
r |
videoGPS |
문자열 | 동영상 캡처 중에 GPS를 지원하는 현재 옵션(예: 이 옵션은 API 수준 2.1에 추가되었습니다. |
rw |
_vendorSpecific |
[유형] (선택사항) | 공급업체별 추가 카메라 옵션 공급업체별 문자열에 밑줄 ( _)을 붙입니다. |