camera.startCapture

Avvia l'acquisizione video o l'acquisizione di immagini a intervalli in base al valore di captureMode in Opzioni. Questo comando è stato aggiunto nel livello API 2.

Parametri

  • Questo comando non ha parametri nel corpo della richiesta. Indica se si tratta di immagine dell'intervallo acquisizione o l'acquisizione video dipende dall'opzione captureMode. Per l'acquisizione a intervalli, il fatto che si tratti di un'acquisizione aperta o meno dipende sia che captureNumber sia uguale o superiore a 0. captureMode, captureInterval e È necessario impostare captureNumber prima dell'acquisizione a intervalli. Solo captureMode deve essere impostato su "video" prima del video di acquisizione, che può essere interrotta solo dal comando camera.stopCapture.

Risultati

  • Acquisizione aperta (quando CaptureMode == "video" o captureNumber == 0)
    • Nessun risultato.
  • Acquisizione a intervalli non aperti:
    • fileUrls: un elenco di URL assoluti che rimandano all'immagine. per l'acquisizione a intervalli. Tieni presente che questo comando non restituisce fileUrls subito dall'acquisizione captureNumber per completare l'operazione. L'avanzamento del comando può essere ottenute con sondaggi periodici sulla videocamera. Ad esempio, esegui un sondaggio dopo durata stimata (time = captureInterval * (captureNumber - 1)) utilizzando l'API /osc/commands/status e fileUrls è il risultato restituito al termine del comando. Se il comando non termina correttamente (ad es. solo 3 immagini sono state scattata prima che la batteria si scarichi) o che la videocamera venga disconnessa dal telefono client al centro, ma il comando termina correttamente, il client deve essere in grado di ottenere le immagini utilizzando camera.listFiles in un secondo momento, quando viene stabilita una nuova connessione tra il client e la videocamera.

Errori

  • disableCommand: il comando è attualmente disabilitato; ad esempio, la fotocamera si trova nel mezzo di un'acquisizione video o a intervalli.
  • invalidParameterName:nome del parametro non riconosciuto; ad esempio sessionId non riconosciuto.

I/O comando
Input comando 
none
Output comando 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Output comando (errore) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}