Inicia la captura de video o la captura de imágenes en intervalo 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 opción
captureMode
determina si se trata de la captura de imágenes en intervalo o de video. En el caso de la captura en modo intervalo, si es una captura abierta o no, depende de sicaptureNumber
es igual o mayor que 0. Se deben configurarcaptureMode
,captureInterval
ycaptureNumber
antes de la captura en intervalo. Solo es necesario establecercaptureMode
como "video" antes de la captura de video, que solo se puede detener con el comando camera.stopCapture.
Resultados
- Captura abierta (cuando captureMode == "video" o captureNumber == 0)
- No hay resultados.
- Captura de intervalo no abierto:
- fileUrls: Una lista de URL absolutas que apunta a archivos de imagen para la captura en intervalos. Ten en cuenta que este comando no muestra
fileUrls
de inmediato, ya que la captura tardacaptureNumber
en completarse. El progreso del comando se puede obtener sondeando la cámara de forma periódica. Por ejemplo, sondea después de una duración estimada (time = captureInterval * (captureNumber - 1)
) con la API de /osc/commands/status, yfileUrls
es el resultado que se muestra cuando finaliza el comando. Si el comando no finaliza correctamente (p.ej., solo se tomaron 3 imágenes antes de que la cámara se quede sin batería) o si la cámara se desconecta del teléfono cliente en el medio, pero el comando finaliza correctamente, el cliente debería poder obtener las imágenes concamera.listFiles
más adelante cuando se establezca una nueva conexión entre el cliente y la cámara.
- fileUrls: Una lista de URL absolutas que apunta a archivos de imagen para la captura en intervalos. Ten en cuenta que este comando no muestra
Errores
- disableCommand: se encuentra actualmente inhabilitado; por ejemplo, la cámara está en medio de una captura de video o una en intervalo.
- invalidParameterName: No se reconoce el nombre del parámetro; por ejemplo,
sessionId
.
E/S de comando | |
---|---|
Entrada del comando | none |
Resultado del comando | { "results": { "fileUrls":[ "url1", "url2", "url3", ... "urln" ] } } |
Resultado del comando (error) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |