En esta sección, se destacan algunos de los cambios principales que debes comprender y tener en cuenta en tus cámaras o apps.
Cambios principales
- Quedó en desuso sessionId y los comandos relacionados se modificaron o quedaron en desuso. El nivel 2 de API está
diseñado para una conexión de cliente y un fabricante de cámaras debe asegurarse de
que en todo momento solo haya un cliente conectado (por ejemplo, mediante la limitación de una sola
conexión wifi).
- Quedaron en desuso los comandos
startSession / updateSession / closeSession. - Quedó en desuso
sessionIden la entrada de comandostakePicture / getOptions / setOptions.
- Quedaron en desuso los comandos
- Quedaron en desuso
getImage / getMetadata.- La URL absoluta de un archivo comenzó a usarse para descargas directas desde el servidor HTTP de la cámara.
- Se agregaron y modificaron comandos, y opciones para captura de video,
capturas de imágenes con intervalo y vistas previas en línea.
- Comandos agregados
startCapture / stopCapture / getLivePreview / processPicture / reset. - Se cambió el nombre de
listImagesporlistFiles, y se modificaron las entradas y salidas para administrar el tipo de video además del tipo de imagen. - Se agregaron las opciones previewFormat, previewFormatSupport, captureInterval, captureIntervalSupport, captureNumber, captureNumberSupport, remainingVideoSeconds, pollingDelay, delayProcessing, delayProcessingSupport y clientVersion.
- Se modificaron las opciones captureModeSupport, isoSupport, shutterSpeedSupport, fileFormatSupport, hdr, hdrSupport, exposureBracket y exposureBracketSupport.
- Comandos agregados
- Se agregó la especificación de XMP de video a 360 grados.
- Se agregó el campo apiLevel a la salida de
/osc/info.- apiLevel: se agregó el campo al nivel de API 2. Se considera como el nivel de API 1 de forma predeterminada cuando falta este campo. Es responsabilidad del desarrollador recuperar esta información y realizar la implementación de forma diferente según el valor.
Compatibilidad con versiones anteriores
- Fabricantes de cámaras: si has ofrecido compatibilidad con el nivel de API 1, te recomendamos admitir los niveles de API 1 y 2 a modo de solución intermedia por algunos meses, hasta la última actualización, y proporcionar una actualización de firmware para cámaras con el nivel de API 1. De lo contrario, los clientes que admitan solo el nivel de API 1 no trabajarán con tus cámaras.
- Desarrolladores de apps: ten en cuenta que estos cambios tienen efecto sobre tu app previamente publicada, y que es tu responsabilidad realizar los cambios correspondientes para manejar ambas versiones y recordar a los propietarios de las cámaras que actualicen su firmware.