camera.startCapture

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Options의 captureMode 값에 따라 동영상 캡처 또는 인터벌 이미지 캡처를 시작합니다. 이 명령어는 API 수준 2에 추가되었습니다.

매개변수

  • 이 명령어에는 요청 본문에 매개변수가 없습니다. 인터벌 이미지 캡처든 동영상 캡처든 captureMode 옵션으로 결정됩니다. 인터벌 캡처의 경우 captureNumber가 0보다 크거나 같는지에 따라 종료 캡처 여부 여부가 결정됩니다. 인터벌 캡처 전에 captureMode, captureInterval 및 captureNumber를 설정해야 합니다. 동영상 캡처 전에 captureMode만 'video'로 설정해야 하며 이 설정은 camera.stopCapture 명령어로만 중지할 수 있습니다.

결과

  • 서술형 캡처 (captureMode == "video" 또는 captureNumber == 0인 경우)
    • 표시할 내용이 없습니다.
  • 종료되지 않은 인터벌 캡처:
    • fileUrls: 인터벌 캡처를 위한 이미지 파일을 가리키는 절대 URL 목록입니다. 참고로, 캡처를 완료하는 데 captureNumber이 소요되므로 이 명령어는 fileUrls를 즉시 반환하지 않습니다. 카메라를 정기적으로 폴링하면 명령어 진행 상황을 확인할 수 있습니다. 예를 들어 /osc/commands/status API를 사용하여 예상 기간 (time = captureInterval * (captureNumber - 1)) 후에 폴링하고 fileUrls는 명령어가 완료될 때 반환되는 결과입니다. 명령어가 성공적으로 완료되지 않거나 (예: 카메라가 배터리를 다 소모하기 전에 이미지 중 3개만 촬영됨) 카메라가 중앙에 있는 클라이언트 휴대전화와 연결 해제되었지만 명령어가 성공적으로 완료된 경우, 나중에 클라이언트와 카메라 사이에 새 연결이 설정될 때 클라이언트가 camera.listFiles를 사용하여 이미지를 가져올 수 있습니다.

오류

  • disabledCommand: 명령어가 현재 사용 중지되어 있습니다. 예를 들어 카메라가 동영상 캡처나 인터벌 캡처 중에 있습니다.
  • invalidParameterName: 매개변수 이름을 인식할 수 없습니다. 예를 들어 sessionId은 인식할 수 없습니다.

명령어 I/O
명령어 입력 
none
명령어 결과 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
명령어 출력 (오류) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}