요청된 속성의 현재 설정을 반환합니다. 이 명령어는 API 수준 2에서 수정되었습니다.
매개변수
- sessionId: 가져온 문자열 유형의 고유한 세션 식별자
camera.startSession
명령어를 사용합니다. 이 필드는 API 수준 2에서 지원 중단되었습니다. - optionNames: 반환할 속성 이름의 문자열 배열입니다.
결과
- options: 요청된 속성의 JSON
<key, value>
쌍입니다. 이 값은String
,String Array
,Number
,Number Array
,Boolean
,Object
,Object Array
. 자세한 내용은 옵션을 선택합니다.
오류
- missingParameter: 하나 이상의 필수 매개변수가 누락되었습니다.
예를 들어
optionNames
는 지정되지 않습니다. - invalidParameterName: 하나 이상의 입력 매개변수 이름 또는 옵션입니다.
알 수 없거나 지원되지 않는 이름입니다(예: 이 코드가 반환되어야 하는 경우
clientVersion
일 때 API 수준 2의 옵션 (예:captureInterval
)이 사용됩니다. (Options
)는 1입니다. - invalidParameterValue: 입력 매개변수 이름은 인식되지만
하나 이상의 값이 잘못되었습니다. 예를 들어
sessionId
가 존재하지 않는 경우 비활성 상태이거나 데이터 유형이 올바르지 않습니다. 이 오류 코드는 API 수준 2: 옵션 이름이 유효하지 않은 경우invalidParameterName
반환합니다.
명령어 I/O | |
---|---|
명령어 입력 (API 수준 1) | { "parameters": { "sessionId": "12ABC3", "optionNames": [ "iso", "isoSupport" ] } } |
명령어 출력 (API 수준 1) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
명령어 출력 (오류) (API 수준 1) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |
명령어 입력 (API 수준 2) | { "parameters": { "optionNames": [ "iso", "isoSupport" ] } } |
명령어 결과 (API 수준 2) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
명령어 출력 (오류) (API 수준 2) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |