camera.startCapture
다음 값에 따라 비디오 캡처 또는 인터벌 이미지 캡처를 시작합니다.
옵션의 captureMode
이 명령어는 API 수준 2에 추가되었습니다.
매개변수
- 이 명령어의 요청 본문에는 매개변수가 없습니다. 인터벌 이미지인지 여부
캡처 또는 동영상 캡처는
captureMode
옵션에 의해 결정됩니다.
간격 캡처의 경우 개방형 캡처인지 여부는
captureNumber
가 0 이상인지 여부
captureMode
, captureInterval
및
인터벌 캡처 전에 captureNumber
를 설정해야 합니다.
captureMode
만 '동영상'으로 설정하면 됩니다. 동영상 재생 전
camera.stopCapture 명령어를 통해서만 중지할 수 있습니다.
결과
- 개방형 캡처 (CaptureMode == "video" 또는 captureNumber == 0인 경우)
<ph type="x-smartling-placeholder">
- 개방형이 아닌 간격 캡처:
<ph type="x-smartling-placeholder">
</ph>
- fileUrls: 이미지를 가리키는 절대 URL 목록입니다.
파일 간 간격입니다. 이 명령어는
캡처 후 즉시
fileUrls
완료하려면 captureNumber
남았습니다. 명령어의 진행률은
인코더-디코더 모델을 호출합니다. 예를 들어,
예상 소요 시간 (time = captureInterval * (captureNumber - 1)
)
/osc/commands/status API 사용
그리고 fileUrls
는 명령어가 완료되면 반환되는 결과입니다.
명령어가 성공적으로 완료되지 않는 경우 (예: 이미지 중 3개만
카메라 배터리가 소진되기 전에 촬영한 사진) 또는 카메라 연결이 끊어짐
명령이 성공적으로 완료되면,
클라이언트는
camera.listFiles
클라이언트와 카메라 간에 새로운 연결이 설정될 때 새로운 연결을 생성합니다.
오류
- disableCommand: 명령어가 현재 사용 중지되어 있습니다. 예를 들어 카메라
인터벌 캡처나 동영상 캡처 중에 있을 수 있습니다.
- invalidParameterName: 매개변수 이름을 인식할 수 없습니다. 예를 들어
sessionId
주소를 인식할 수 없습니다.
명령어 I/O |
명령어 입력 |
none |
명령어 결과 |
{ "results": { "fileUrls":[ "url1", "url2", "url3", ... "urln" ] } } |
명령어 출력 (오류) |
{ "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-21(UTC)
[null,null,["최종 업데이트: 2024-08-21(UTC)"],[[["Initiates either video or interval image capture based on pre-set capture mode."],["For interval capture, `captureMode`, `captureInterval`, and `captureNumber` options must be configured beforehand."],["For video capture, only `captureMode` needs to be set to \"video\" and can be stopped using the `camera.stopCapture` command."],["The command results for non-open-ended interval capture include a list of image URLs accessible after capture completion, retrievable via polling or `camera.listFiles`."],["Errors like \"disabledCommand\" occur if the camera is already capturing or \"invalidParameterName\" if an unrecognized parameter is used."]]],["This command initiates video or interval image capture based on the `captureMode` setting. For interval capture, `captureNumber` determines if it's open-ended; `captureInterval` and `captureNumber` must be preset. Video capture, set by `captureMode`, is ended via `camera.stopCapture`. Open-ended capture has no immediate results. Non-open-ended interval capture eventually provides a `fileUrls` list, accessible after the completion time or if interrupted. Errors include `disabledCommand` and `invalidParameterName`. The command's input is null, and output results with file URLs.\n"]]