camera.startCapture

Inicia a captura de vídeo ou captura de imagem de intervalo, dependendo do valor de captureMode em Opções. Esse comando foi adicionado no nível 2 da API.

Parâmetros

  • Esse comando não tem parâmetros no corpo da solicitação. Se é imagem de intervalo captura ou captura de vídeo é determinado pela opção captureMode. Para a captura de intervalo, se é aberta ou não depende se captureNumber é igual ou maior que 0. captureMode, captureInterval e É preciso definir captureNumber antes da captura de intervalo. Somente captureMode precisa ser definido como "vídeo" antes do vídeo capture, que só pode ser interrompida pelo comando camera.stopCapture.

Resultados

  • Captura aberta (quando captureMode == "video" ou captureNumber == 0)
    • Nenhum resultado.
  • Captura de intervalo não aberto:
    • fileUrls::uma lista de URLs absolutos, apontando para a imagem para a captura de intervalo. Esse comando não retorna fileUrls imediatamente após a captura captureNumber para concluir. O progresso do comando pode ser obtidas pesquisando a câmera periodicamente. Por exemplo, faça uma enquete depois de duração estimada (time = captureInterval * (captureNumber - 1)) usando a API /osc/commands/status e fileUrls é o resultado retornado quando o comando é concluído. Se o comando não for concluído com êxito (por exemplo, apenas três das imagens foram tirada antes que a câmera fique sem bateria) ou ela seja desconectada no telefone do cliente, no meio, mas o comando for concluído com sucesso. o cliente deve ser capaz de obter as imagens usando o camera.listFiles posteriormente, quando uma nova conexão for estabelecida entre o cliente e a câmera.

Erros

  • disableCommand:: o comando está desativado no momento. por exemplo, a câmera estiver no meio de uma captura de vídeo ou de intervalo.
  • invalidParameterName:o nome do parâmetro não foi reconhecido. por exemplo, sessionId não é reconhecido.

E/S de comando
Entrada de comando 
none
Resposta ao comando 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Resposta ao comando (erro) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}