Nivel de API 2.1
Lanzamiento: mayo de 2017
Cambios clave
- Se agregó una carga directa para permitir que las cámaras suban directamente a los servidores.
- Incluye los comandos nuevos
switchWifi
yuploadFile
. - Se agregaron las opciones
photoStitchingSupport
,photoStitching
,videoStitchingSupport
,videoStitching
,videoGPSSupport
yvideoGPS
a las opciones de OSC. - Se agregó el campo
cameraId
al resultado/osc/info
.
- Incluye los comandos nuevos
- Se reemplazó la especificación XMP de video 360 por un nuevo estándar abierto.
- Se agregó una recomendación para especificar make/model de la cámara en videos MP4 en 360°.
Nivel de API 2
Lanzado en julio de 2016
Cambios clave
sessionId
dejó de estar disponible y se dieron de baja o modificaron los comandos relacionados. El nivel de API 2 está diseñado para una conexión de cliente, y los fabricantes de cámaras deben asegurarse de que solo un cliente en todo momento esté conectado (por ejemplo, mediante la limitación de una sola conexión Wi-Fi).- Dejaron de estar disponibles los comandos
startSession
/updateSession
/closeSession
. - Se dio de baja
sessionId
en la entrada de comandostakePicture
,getOptions
ysetOptions
.
- Dejaron de estar disponibles los comandos
- Dejaron de estar disponibles los comandos
getImage
/getMetadata
.- La URL absoluta de un archivo se usa para realizar descargas directamente desde el servidor HTTP de la cámara.
- Se agregaron y modificaron comandos y opciones para la captura de video, la captura de imágenes en intervalo y la vista previa en vivo.
- Se agregaron comandos
startCapture
/stopCapture
/getLivePreview
/processPicture
/reset
. - Se cambió el nombre de
listImages
alistFiles
y se modificaron las entradas y salidas para controlar tanto los tipos de video como los de imágenes. - Se agregaron las opciones
previewFormat
,previewFormatSupport
,captureInterval
,captureIntervalSupport
,captureNumber
,captureNumberSupport
,remainingVideoSeconds
,pollingDelay
,delayProcessing
,delayProcessingSupport
yclientVersion
. - Se modificaron las opciones
captureModeSupport
,isoSupport
,shutterSpeedSupport
,fileFormatSupport
,hdr
,hdrSupport
,exposureBracket
yexposureBracketSupport
.
- Se agregaron comandos
- Se agregó la especificación de XMP para videos a 360°.
- Se agregó el campo
apiLevel
al resultado/osc/info
.- apiLevel: Se agregó el campo en el nivel de API 2. Se considera como el nivel de API 1 de forma predeterminada cuando falta este campo. Es responsabilidad de los desarrolladores recuperar esta información y realizar la implementación de manera diferente según el valor.
Retrocompatibilidad
- Fabricantes de cámaras: Si has brindado compatibilidad con el nivel de API 1, te recomendamos que admitas tanto el nivel de API 1 como el nivel de API 2 como solución intermedia durante unos meses antes de la actualización final y proporciones una actualización de firmware para las cámaras que ejecutan el nivel de API 1; de lo contrario, los clientes que solo admiten el nivel de API 1 no funcionarán con tus cámaras.
- Desarrolladores de apps: Ten en cuenta que estos cambios afectan a la app que publicaste anteriormente. Es tu responsabilidad realizar los cambios correspondientes para controlar ambas versiones y recordarles a los propietarios de las cámaras que actualicen su firmware.