camera.startCapture

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

매개변수

  • 이 명령어는 요청 본문에 매개변수가 없습니다. 인터벌 이미지 캡처인지 동영상 캡처인지는 captureMode 옵션에 의해 결정됩니다. 인터벌 캡처의 경우 열린 캡처인지 여부는 captureNumber가 0보다 크거나 같은지에 따라 다릅니다. 인터벌 캡처 전에 captureMode, captureInterval, captureNumber를 설정해야 합니다. 동영상 캡처 전에 captureMode만 '동영상'으로 설정하면 되며, 이는 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."
    }
}