Cambios claves para el nivel de API 2

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 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 listImages por listFiles, 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.
  • Se agregó la especificación de [XMP de video a 360 grados] (/streetview/open-spherical-camera/reference/header/video-xmp).
  • 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.

Enviar comentarios sobre…

Open Spherical Camera API