camera.getOptions

요청된 속성의 현재 설정을 반환합니다. 이 명령어는 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: 하나 이상의 입력 매개변수 이름 또는 옵션 이름이 인식되지 않거나 지원되지 않습니다. 예를 들어 Options의 clientVersion가 1일 때 API 수준 2의 옵션 (예: captureInterval)을 사용하면 이 코드가 반환되어야 합니다.
  • 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."
   }
}