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: 하나 이상의 입력 매개변수 이름 또는 옵션입니다. 알 수 없거나 지원되지 않는 이름입니다(예: 이 코드가 반환되어야 하는 경우 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."
   }
}