Versão 2.1
Introdução
O Guia do fabricante de Open Spherical Camera (OSC) fornece orientações sobre a implementação da API de câmera esférica para fabricantes de câmeras com Wi-Fi integrado. Consulte as especificações da API OSC para ver o conjunto completo de comandos.
Feedback
Estamos ansiosos para receber suas sugestões de melhorias para estes documentos. Se você encontrou problemas de engenharia, documentação confusa ou comportamento inesperado, entre em contato conosco. Informe um problema ou envie feedback e sugestões.
Discovery
O fluxo de descoberta funciona da seguinte maneira: a câmera atende a uma rede Wi-Fi detectável e protegida por senha. O software cliente em execução em um smartphone ou outro dispositivo de computação verifica a existência dessas redes e exibe uma lista de identificadores de conjuntos de serviços (SSIDs, na sigla em inglês) descobertos, em que o usuário pode selecionar um. O usuário insere a senha da rede selecionada para autenticar e conectar o software cliente ao servidor da câmera.
A câmera implementa o fluxo de descoberta definindo um SSID legível que identifica a câmera de maneira exclusiva para um cliente. O servidor da câmera autentica e se comunica com um cliente via HTTP na porta 80.
SSID (Identificador do conjunto de serviços) e senha
O SSID do Wi-Fi começa com um nome fácil de usar (máximo de 20 caracteres), com um
ponto (.) delimitador antes do sufixo, OSC. Adicionar um elemento aleatório e exclusivo
ao final do nome ajuda a evitar conflitos de nomes. Por exemplo,
VendorCamera123.OSC;, em que 123 identifica exclusivamente a câmera atual das
câmeras próximas do mesmo modelo e do mesmo fabricante.
O Wi-Fi da câmera exige proteção WPA2-PSK. O WPA2-PSK exige senhas com pelo menos oito caracteres. A senha pode conter letras, números e símbolos, mas não espaços. Os usuários só podem mudar essa configuração quando a câmera está conectada a um dispositivo cliente. Depois que ela é alterada, a câmera é desconectada e o cliente precisa se reconectar usando a nova senha.
A câmera precisa oferecer um método de redefinição caso o usuário esqueça a senha. Por exemplo, um botão de redefinição na câmera para restaurar a senha padrão para a configuração original.
Endereço IP e porta
O endereço IP da câmera (por exemplo, 192.168.1.1) é o endereço IP do gateway da
rede Wi-Fi da câmera, que pode ser obtido na conexão Wi-Fi do
lado do cliente. No caso da porta, use a porta padrão 80 para HTTP. Consiga a porta para
atualizações de endpoints em /osc/info. Consulte
Protocolo OSC > Informações.