Guía del fabricante de Open Spherical Camera

Versión 1.0

Introducción

La guía del fabricante de Open Spherical Camera (OSC) proporciona orientación para la implementación de la API de cámara esférica para fabricantes de cámaras con WiFi incorporado. Consulta la Especificación de la API de OSC para acceder al conjunto completo de comandos.

Comentarios

Esperamos recibir tus sugerencias sobre mejoras para estos documentos. Ya sea que hayas encontrado puntos débiles de ingeniería, documentación confusa o un comportamiento inesperado, no dudes en informarlo. Informa un problema o envía comentarios y sugerencias.

Detección

El flujo de detección funciona de la siguiente manera: la cámara proporciona una red WiFi detectable, protegida con contraseña. El software de cliente que se ejecuta en un teléfono u otro dispositivo busca redes y muestra una lista de los identificadores de red (SSID) detectados, entre los que el usuario puede seleccionar uno. El usuario ingresa la contraseña para la red seleccionada a fin de autenticarse y conectarse al software del cliente con el servidor de la cámara.

La cámara implementa el flujo de detección al definir un SSID en lenguaje natural que identifica de forma exclusiva la cámara con un cliente. El servidor de la cámara se autentica y se comunica con un cliente a través de HTTP en el puerto 80.

SSID y contraseña

El SSID WiFi comienza con un nombre que le resulte fácil de reconocer al usuario (20 caracteres como máximo) con un punto (.) delimitador antes del sufijo OSC. Agregar un elemento aleatorio único al final del nombre ayuda a evitar colisiones de nombres. Por ejemplo, VendorCamera123.OSC;, donde 123 identifica de forma exclusiva la cámara actual con respecto a cámaras cercanas del mismo modelo y el mismo fabricante.

La conexión WiFi de la cámara requiere protección WPA2-PSK. WPA2-PSK requiere contraseñas de 8 caracteres como mínimo. La contraseña puede contener letras, números y símbolos, pero no espacios. Los usuarios solo podrán cambiarla cuando la cámara esté conectada a un dispositivo de cliente. Una vez que se modifique, la cámara se desconecta y el cliente debe volver a conectarse usando la nueva contraseña.

La cámara debe proporcionar un método de restablecimiento en caso de que el usuario olvide la contraseña; por ejemplo, un botón de restablecimiento en la cámara para restaurar la contraseña de fábrica.

Dirección IP y puerto

La dirección IP de la cámara (p. ej., 192.168.1.1) es la dirección IP de la puerta de enlace de la red wifi de la cámara, que se puede obtener en la conexión wifi del cliente. Para el puerto, usa el número de puerto predeterminado 80 para HTTP (obtén el puerto para actualizaciones de puntos finales en /osc/info, consulta [OSC Protocol > Info] (/streetview/open-spherical-camera/guides/osc/info#endpoints_object)).

Enviar comentarios sobre…

Open Spherical Camera API