이전에 캡처되었지만 아직 처리되지 않은 이미지 처리
처리 시간이 오래 걸리기 때문에 이 명령어는 delayProcessing를 지원하는 경우에만 관련이 있습니다. delayProcessing을 지원하지 않는 경우 이 명령어 요청이 실패하고 오류 코드가 사용 중지됩니다.
이 명령어는 API 수준 2에 추가되었습니다.
매개변수
- previewFileUrls: 처리되지 않은 이미지의 URL 목록입니다.
카메라에서 처리되지 않은 모든 이미지를 처리하려면 [“all”]로 처리되어야 합니다. 이 값은 비워둘 수 없습니다. 카메라가 이미지를 처리하는 데 문제가 있으면 카메라는 오류로 응답하지 않습니다. 그 대신 URL을 무시하고 다른 작업을 진행해야 합니다. 극단적인 사례는
previewToFinalFileUrls가 빈 JSONObject로 반환될 수 있습니다.
결과
- previewToFinalFileUrls: 각 JSON이 미리보기 이미지의 절대 URL이고 각 키가 해당하는 최종 처리된 이미지이며 카메라에서 직접 다운로드하는 데 사용할 수 있는 JSON <key; value="> 쌍의 JSONObject입니다. 이 명령어는 camera.takePicture와 유사하며
previewToFinalFileUrls을 즉시 반환하지는 않습니다(이 단락의 뒷부분에서 설명하는 예외는 예외). 처리(일반적으로 카메라 연결 포함)는 완료하는 데 몇 초에서 몇 분 정도 걸릴 수 있습니다. 명령어의 진행 상황은 /osc/commands/status API를 사용하여 정기적으로 카메라를 폴링하여 얻을 수 있으며previewToFinalFileUrls는 명령어가 완료되면 반환됩니다. 명령어가 완료되기 전에 카메라 연결이 끊어지면 클라이언트는listFiles를 사용하여 카메라에 다시 연결되었을 때 최종 이미지 URL을 가져오거나 다른 processPicture 명령어를 실행할 수 있습니다. 이 명령어는 이미지가 재연결 전에 이미 처리된 경우 즉시previewToFinalFileUrls를 반환합니다.</key,>
오류
- disabledCommand: 지연 처리를 지원하지 않는 경우.
- invalidParameterName: 입력 매개변수 이름을 인식할 수 없습니다.
- invalidParameterValue: 입력 매개변수 이름이 인식되지만 값이 잘못되었습니다. 예를 들어
previewFileUrls의 모든 URL이 잘못되었습니다.
명령어 I/O | |
|---|---|
| 명령어 입력 | {
"parameters": {
"previewFileUrls": [
"previewFileUrl1",
"previewFileUrl2",
"previewFileUrl3",
...
"previewFileUrln"
]
}
} |
| 명령어 결과 | {
"results": {
"previewToFinalFileUrls":{
"previewFileUrl1": "finalFileUrl1",
"previewFileUrl2": "finalFileUrl2",
"previewFileUrl3": "finalFileUrl3",
...
"previewFileUrln": "finalFileUrln"
}
}
} |
| 명령어 출력 (오류) | {
"error": {
"code": "disabledCommand",
"message": "Command is currently disabled."
}
} |