バージョン 2.1
はじめに
Open Spherical Camera(OSC)Manufacturer’s Guide には、Wi-Fi 内蔵カメラのメーカー向けに、球面カメラ API の実装に関するガイダンスが記載されています。コマンドの完全なセットについては、OSC API 仕様をご覧ください。
フィードバック
これらのドキュメントについて改善のご提案をお待ちしております。 エンジニアリングの課題、わかりにくいドキュメント、予期しない動作などがありましたら、Google までお知らせください。問題を報告したり、フィードバックや提案を送信したりできます。
発見
検出フローは次のように動作します。カメラは検出可能でパスワードで保護された Wi-Fi ネットワークを提供します。スマートフォンやその他のコンピューティング デバイス上で動作しているクライアント ソフトウェアがそのようなネットワークをスキャンし、検出されたネットワーク サービスセット識別子(SSID)のリストを表示します。ユーザーはこのリストから SSID を選択できます。ユーザーは選択したネットワークのパスワードを入力して、クライアント ソフトウェアを認証してカメラのサーバーに接続します。
カメラは、クライアントに対してカメラを一意に識別する、人が読める SSID を定義することで、検出フローを実装します。カメラのサーバーは、ポート 80 で HTTP を介してクライアントの認証と通信を行います。
SSID とパスワード
Wi-Fi SSID は、わかりやすい名前(最大 20 文字)で始まり、接尾辞 OSC
の前にピリオド(.)区切り文字が付いています。名前の末尾にランダムな一意の要素を追加すると、名前の競合を防止できます。たとえば、VendorCamera123.OSC;
では、123
により、同じメーカーの同じモデルの近くにあるカメラから現在のカメラが一意に識別されます。
カメラの Wi-Fi には WPA2-PSK による保護が必要です。WPA2-PSK では 8 文字以上のパスワードが必要です。パスワードには文字、数字、記号を使用できますが、 スペースは使用できません。ユーザーは、カメラがクライアント デバイスに接続されている場合にのみ変更できます。変更すると、カメラが切断され、クライアントは新しいパスワードを使用して再接続する必要があります。
ユーザーがパスワードを忘れた場合に備えて、カメラはリセット方法を提供する必要があります(たとえば、出荷時のデフォルト設定を復元するためのカメラのリセットボタン)。
IP アドレスとポート
カメラの IP アドレス(192.168.1.1 など)は、カメラの Wi-Fi ネットワークのゲートウェイ IP アドレスで、クライアント側の Wi-Fi 接続から取得できます。ポートには、HTTP 用のデフォルト ポート 80 を使用してください(更新用のポートは、/osc/info
のエンドポイントから取得します。[OSC プロトコル] > [情報] をご覧ください)。