Guía del fabricante de Open Spherical Camera

Versión 2.1

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 Wi-Fi integrado. Consulta la Especificación de la API de OSC para ver el conjunto completo de comandos.

Comentarios

Esperamos recibir tus sugerencias sobre mejoras para estos documentos. Ya sea que hayas encontrado dificultades de ingeniería, documentación confusa o un comportamiento inesperado, infórmanos al respecto. Informa un problema o envía comentarios y sugerencias.

Campañas discovery

El flujo de detección funciona de la siguiente manera: la cámara proporciona una red Wi-Fi detectable, protegida con contraseña. El software cliente que se ejecuta en un teléfono o en otro dispositivo informático busca esas redes y muestra una lista de identificadores de conjunto de servicios (SSID) de red detectados, de los cuales el usuario puede seleccionar uno. El usuario ingresa la contraseña de la red seleccionada para autenticarse y conectar el software cliente con el servidor de la cámara.

La cámara implementa el flujo de detección mediante la definición de un SSID legible que identifique la cámara de forma única a un cliente. El servidor de la cámara se autentica y se comunica con el cliente a través de HTTP en el puerto 80.

SSID y contraseña

El SSID Wi-Fi comienza con un nombre fácil de usar (20 caracteres como máximo) y un punto (.) como delimitador antes del sufijo OSC. Agregar un elemento aleatorio y único al final del nombre ayuda a evitar colisiones de nombres. Por ejemplo, VendorCamera123.OSC;, donde 123 identifica de forma única la cámara actual de las cámaras cercanas del mismo modelo y del mismo fabricante.

La conexión Wi-Fi de la cámara requiere protección WPA2-PSK. WPA2-PSK requiere contraseñas de al menos 8 caracteres. 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 cliente. Una vez que se modifique, la cámara se desconecta y el cliente debe volver a conectarse con la contraseña nueva.

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 restablecer la contraseña predeterminada 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 Wi-Fi de la cámara, que se puede obtener de la conexión Wi-Fi del cliente. En el caso del puerto, usa el puerto predeterminado 80 para HTTP (obtén el puerto para las actualizaciones de los extremos en /osc/info; consulta Protocolo OSC > Información).