camera.startCapture

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Inicia la captura de video o del intervalo de imágenes según el valor de captureMode en Opciones. Este comando se agregó en el nivel de API 2.

Parámetros

  • Este comando no tiene parámetros en el cuerpo de la solicitud. La captura de imágenes en intervalos o video se determina mediante la opción captureMode. En el caso de la captura en intervalos, que la captura sea abierta o no depende de si captureNumber es igual o mayor que 0. captureMode, captureInterval y captureNumber deben configurarse antes de la captura en intervalo. Solo se debe establecer captureMode en &video antes de la captura de video, que solo puede detenerse con el comando camera.stopCapture.

Resultados

  • Captura abierta (cuando captureMode == "video" o captureNumber == 0)
    • No hay resultados.
  • Captura de intervalo sin final:
    • fileUrls: Una lista de URL absolutas que apunta a los archivos de imagen para la captura por intervalos Ten en cuenta que este comando no muestra fileUrls de inmediato, ya que la captura toma captureNumber en completarse. El progreso del comando se puede obtener si se sondea la cámara periódicamente. Por ejemplo, sondear después de una duración estimada (time = captureInterval * (captureNumber - 1)) con la API de /osc/commands/status y fileUrls es el resultado que se muestra cuando finaliza el comando. Si el comando no se completa correctamente (p.ej., solo se tomaron 3 de las imágenes antes de que la cámara se quedara sin batería) o si la cámara se desconecta del teléfono del cliente en el medio, pero el comando se completa con éxito, el cliente debería poder obtener las imágenes mediante camera.listFiles más tarde, cuando se establezca una conexión nueva entre el cliente y la cámara.

Errores

  • disabledCommand: Actualmente, el comando está inhabilitado; por ejemplo, la cámara se encuentra en el medio de una captura de video o una captura de intervalo.
  • invalidParameterName: no se reconoce el nombre del parámetro; por ejemplo, no se reconoce sessionId.

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