Guide du fabricant pour Open Spherical Camera

Version 1.0

Introduction

Le guide du fabricant pour Open Spherical Camera (OSC) fournit des instructions sur l'implémentation de l'API pour appareil photo sphérique à l'attention des fabricants d'appareil photos avec Wi-Fi intégré. Pour la liste complète des commandes, voir Spécification de l'API OSC.

Feedback

Nous apprécions les suggestions d'amélioration concernant ces documents. Si vous deviez identifier des problèmes techniques, un point de documentation confus ou un comportement inattendu, merci de nous le faire savoir. Signalez un problème ou envoyez votre feedback et vos suggestions.

Détection

La procédure de détection est la suivante : l'appareil photo crée un réseau Wi-Fi détectable et protégé par mot de passe. Le logiciel client exécuté sur un téléphone ou tout autre périphérique informatique recherche ce type de réseau et affiche la liste des identifiants SSID (Service Set Identifiers) des réseaux détectés à partir de laquelle l'utilisateur peut sélectionner le réseau souhaité. L'utilisateur saisit le mot de passe du réseau sélectionné pour authentifier et connecter le logiciel client au serveur de l'appareil photo.

L'appareil photo active la détection en définissant un SSID lisible qui identifie de manière unique l'appareil photo pour un client. Le serveur de l'appareil photo authentifie un client et communique avec lui via HTTP sur le port 80.

SSID et mot de passe

Le code Wi-Fi SSID commence par un nom reconnaissable (20 caractères maximum), séparé du suffixe par un point (.), OSC. Ajouter un élément unique aléatoire à la fin du nom permet d'éviter les conflits de nom. Par exemple, VendorCamera123.OSC;123 identifie de manière unique l'appareil photo actuel par rapport aux appareils photos de même modèle et de même fabricant qui se trouvent à proximité.

Le réseau Wi-Fi d'un appareil photo nécessite une protection WPA2-PSK. WPA2-PSK nécessite des mots de passe d'au moins 8 caractères. Le mot de passe peut contenir des lettres, des chiffres et des symboles mais pas d'espaces. Les utilisateurs peuvent le modifier uniquement lorsque l'appareil photo est connecté à un périphérique client. Une fois le mot de passe modifié, l'appareil photo est déconnecté et le client doit se reconnecter à l'aide du nouveau mot de passe.

L'appareil photo doit fournir une méthode de réinitialisation en cas d'oubli du mot de passe ; par exemple, un bouton de réinitialisation sur l'appareil photo qui permet de restaurer le mot de passe d'usine par défaut.

Adresse IP et port

L'adresse IP de l'appareil photo (par ex.  192.168.1.1) est la passerelle de l'adresse IP du réseau Wi-Fi de l'appareil photo, qui peut être obtenue à partir de la connexion Wi-Fi côté client. Pour le port, utilisez le port 80 par défaut pour HTTP (pour obtenir le port dédié aux mises à jour à partir des points d'extrémité dans /osc/info ; voir Protocole OSC > Informations).