このページは Cloud Translation API によって翻訳されました。

ストリートビューから直接アップロード

バージョン 2.1

背景

以前のバージョンの API では、OSC 準拠のカメラが Wi-Fi アクセスポイントを作成し、Google ストリートビューの iOS アプリと Android アプリから接続できました。アプリは OSC カメラに写真を撮影するよう指示するとともに、撮影したコンテンツをカメラからダウンロードして Google ストリートビューに公開するよう指示します。コンテンツの公開を迅速化するために、OSC カメラがストリートビューサーバーに直接コンテンツをアップロードできるようにする新しいオプションワークフローを導入しました。これにより、最初にカメラからアプリへ、次にアプリからストリートビューサーバーに、コンテンツを二重に転送する必要がなくなります。これは API レベル 2.1 で追加されました。Wi-Fi アクセスポイントを提供し、インターネットにアクセスできるインフラストラクチャ Wi-Fi アクセスポイントにも接続できる OSC カメラにのみ適用されます。

概要

新しいアップロードワークフローでは、ユーザーが次の 2 つの Wi-Fi モードを切り替える方法（専用の物理ボタン、または既存のボタンの組み合わせなど）をカメラで用意する必要があります。

ダイレクトモード: このモードでは、カメラはモバイルデバイスから接続するためのアクセスポイントとして機能します。このモードでは、モバイルデバイスでカメラを制御して写真のキャプチャなどのタスクを実行できます。モバイルデバイスでは、カメラに Wi-Fi アクセスポイントの認証情報を付与することもできます。この認証情報を使用して、カメラはインターネットモードに切り替えられます。
インターネットモード: このモードでは、カメラはインターネットにアクセスできる Wi-Fi アクセスポイントに接続します。このとき、カメラがダイレクトモードだったときにアプリから提供されたアクセスポイント ID とパスワードが使用されます。このモードでは、モバイルデバイスからカメラから直接ストリートビューサーバーへのアップロードを開始できます。また、引き続きカメラを制御して、写真のキャプチャなどのタスクを実行することもできます。

カメラモードは、カメラをオフにしてから再びオンにしても維持する必要があります。また、現在の Wi-Fi モードをユーザーに知らせる信号（画面上のライト、音、インジケーターなど）をカメラから出力することを強くおすすめします。

また、カメラがインターネットモードにあるときの通信を処理できるように、検出プロトコル（検出を参照）を実装しておく必要もあります。

インターネットモードの設定

ユーザーがカメラの電源をオンにします。インターネットモードがまだ設定されていないため、ダイレクトモードで開始されます。
モバイルデバイスがカメラの Wi-Fi に接続します。
アプリは自己署名証明書を生成します。
アプリは、カメラが接続する必要があるインフラストラクチャ Wi-Fi アクセスポイントの SSID、そのアクセスポイントのパスワード、後でカメラがアプリを認証する際に使用する自己署名証明書を使用して、カメラに switchWifi コマンドを送信します。
- カメラは Wi-Fi 認証情報とアプリの自己署名証明書の両方を安全に保存する必要があることにご注意ください。
- カメラは異なるインフラストラクチャ Wi-Fi アクセスポイントに接続する必要が生じる場合があるため、カメラには複数の Wi-Fi 認証情報を保存することをおすすめします。最小要件は、カメラが最新の Wi-Fi 認証情報を保存することです。
カメラは、後でアプリがカメラを認証するために使用する自己署名証明書で応答します。
ユーザーは、物理的な切り替えボタンなどを使用して、カメラから直接ダイレクトモードとインターネットモードを切り替えられるようになりました。

発見

OSC カメラの検出は、zeroconf ベースのプロトコルです。カメラは IPv4 リンクローカルアドレスを実装しなければならず、mDNS（マルチキャスト DNS）と DNS-SD（DNS ベースのサービスディスカバリ）の仕様を遵守しなければなりません。

サービスインスタンス名

OSC カメラは、サービスインスタンス名の <Service> 部分に _osc._tcp を使用する必要があります。OSC カメラは、サービスインスタンス名の <Domain> 部分に local. を使用する必要があります。local の後に . がついています。

TXT レコード

カメラは TXT レコードで txtvers、ty、id の Key-Value ペアを送信する必要があります。

テキストバー

今後の TXT バージョンの更新を許可するには、Key-Value ペア txtvers=1 を使用します。

ty

ユーザーが読むことができるカメラ名を指定します（例: ty=Google Street View Optimized Spherical Camera Model XYZ）。

id

カメラの一意の ID を提供します（例: id=A unique id of the camera）。id の値は、/osc/info 出力の cameraId と同じでなければなりません。

お知らせ

カメラの起動時またはシャットダウン時に、カメラは mDNS 仕様に記載されているとおり、通知ステップを実行しなければなりません。対応する通知を少なくとも 1 秒間隔で少なくとも 2 回送信すべきです。

スタートアップ

カメラの起動時に、mDNS 仕様に記載されているとおり、プローブと通知の手順を実行しなければなりません。この場合は、SRV レコード、PTR レコード、TXT レコードを送信する必要があります。可能であれば、すべてのレコードを 1 つの DNS レスポンスにグループ化することをおすすめします。それ以外の場合は、SRV、PTR、TXT レコードの順番をおすすめします。

シャットダウン

カメラのシャットダウン時には、mDNS ドキュメントのセクション 10.1 に記載されているとおり、TTL=0 で「グッドバイパケット」を送信することですべての関係者への通知を試みるべきです。

自己署名証明書

アプリとカメラは、インターネットモードのセットアップ時に共有された自己署名証明書を使用して相互に認証を行い、SSL 相互認証を使用して交換データを保護するための安全なチャネルを構築できます。

インターネットモードでは、アプリが SSL サーバーとして機能し、カメラがクライアントとして機能します。サーバーの証明書がアプリの自己署名証明書と一致することをカメラが確認し、クライアントの証明書がカメラの証明書と一致することをアプリは確認します。

相互認証をサポートする任意の SSL ライブラリ（OpenSSL など）を使用すると、インターネットモードでのアプリとカメラ間の SSL 接続を確立できます。

新しいアップロードフロー

カメラがインターネットモードになっていない場合は、インターネットモードに切り替えます。カメラは、保存されている認証情報を使用してインフラストラクチャ Wi-Fi に接続します。
また、モバイルデバイスはインフラストラクチャ Wi-Fi に接続し、カメラを検出します。
- そのためには、カメラにローカル検出プロトコルの mDNS/DNS-SD を実装する必要があります（検出を参照）。
- 実装方法に関する特定の要件はありません（mDNSResponder をご覧ください）。
- インターネットモードのセットアップ時に、アプリとカメラの両方で自己署名証明書が生成され、共有されます。インターネットモードの場合、アプリとカメラの両方が相互 SSL 認証によって相互に認証します。
- カメラが検出されると、HTTP 1.1 に基づくローカルネットワーク経由で直接クライアント通信が有効になります。データ形式は JSON ベースです。リクエストには GET リクエストと POST リクエストがあります。
アプリは listFiles コマンドを使用して、カメラにファイルのリストをクエリします。
アプリで uploadFile コマンドを使用してアップロードを開始し、画像や動画をカメラからストリートビューサーバーに直接アップロードします。
アプリは status コマンドを使用して、アップロードの進行状況についてカメラを定期的にポーリングします。