導入前にIT担当者と確認するネットワークの条件を知りたい
OriHime本体と操作端末の両方で、認証・通話に使う通信を許可する必要があります。このページをIT担当者へ共有し、接続先とポート、回線の条件を確認してください。
iOS・Androidの操作アプリも同じWebコントローラーを読み込むため、通信要件はブラウザで使う場合と同じです。
IT担当者に伝えること
- OriHime本体を置く場所と、そこでの接続方法（Wi-Fiか有線LANか）。
- 操作する端末が、同じ社内・学内のネットワークから接続するのか、外から接続するのか。
- 同時に使うOriHimeの台数と、同時に接続する人数。
IT担当者に確認してもらうこと
- 外向きの通信先を制限している場合は、下の接続先を許可してください。
- プロキシを経由するネットワークでは、OriHime本体にプロキシのホスト・ポート・認証情報を設定できます。WebSocketと通話の中継（TURN）もプロキシを通る必要があります。設定手順はプロキシのある環境で使いたいを参照してください。
- VPNを常時使う端末では、通話が不安定になることがあります。VPNを使うと通話できないを参照してください。
- ログインが必要なWi-Fi（Web認証）には、OriHime本体は接続できません。別のWi-Fiまたは有線LANを用意してください。
- HTTPS通信の内容を検査（TLS検査）している場合は、下の接続先への通信が検査によって遮断されないか確認してください。
ログイン・状態表示・通話の準備
次の接続先の名前解決ができることと、外向きの通信およびその応答が通ることを確認してください。「必要な側」は、OriHime本体を置くネットワークと操作端末を置くネットワークのどちらで許可が必要かを示します。WebSocketは、通話中も接続を維持できる必要があります。
| 接続先 | 必要な側 | 用途 | 確認する通信 |
|---|---|---|---|
biz-backend.orylab.com | 本体・操作端末 | ログイン・機体情報などのAPI | HTTPS・TCP 443 |
app-zeta-websocket.orylab.com | 本体・操作端末 | OriHime本体の状態通知・操作の通信 | HTTPS／WebSocket・TCP 443 |
orihime-peerjs-server.orylab.com | 本体・操作端末 | 通話相手との接続準備 | HTTPS／WebSocket・TCP 443 |
biz.orylab.com | 本体・操作端末 | 管理ツール・配布案内・OriHime本体の更新情報 | HTTPS・TCP 443 |
biz-talk.orylab.com | 操作端末 | Webコントローラー（iOS・Androidの操作アプリも読み込む） | HTTPS・TCP 443 |
fonts.gstatic.com | 操作端末 | Webコントローラーのアイコン表示。遮断するとボタンのアイコンが表示されません | HTTPS・TCP 443 |
orihime-portal.orylab.com | 操作端末 | パスワード再設定・メール確認などのアカウント手続き | HTTPS・TCP 443 |
www.clarity.ms | 操作端末 | Webコントローラーの利用状況の計測。遮断しても操作には影響しません | HTTPS・TCP 443 |
biz-info.orylab.com | 操作端末 | 資料表示機能を使う場合の画面(OriHime Info) | HTTPS・TCP 443 |
presentations-by-orihime.firebaseapp.com、presentations-by-orihime.firebaseio.com、presentations-by-orihime.appspot.com | 操作端末 | 資料表示機能のログイン・資料の同期・PDFの保存(Firebase) | HTTPS・TCP 443 |
api.openai.com | 本体・操作端末 | 翻訳・読み上げ機能を使う場合。本体は設置場所側の読み上げ、操作端末は操作者側の読み上げに使います | HTTPS・TCP 443 |
api.deepgram.com | 本体・操作端末 | 音声入力・翻訳を使う場合。本体は設置場所の声、操作端末は操作者の声の音声認識に使います | WebSocket（WSS）・TCP 443 |
資料表示機能はGoogleのFirebaseを使うため、上のホストに加えてFirebase SDKが使うGoogleのホスト(*.googleapis.com)への通信も必要です。
OriHime本体の更新ファイルの取得先は更新情報から指定されるため、更新を行うときは取得先への通信も確認してください。追加機能を使う場合は、その機能の通信先も確認してください。
音声・映像の通信
通話にはWebRTCを使います。相手と直接通信する経路と、中継サーバー（TURN）を使う経路があり、ネットワークの状態によって選ばれます。
| 確認する経路 | 接続先・ポートの目安 | 確認すること |
|---|---|---|
| 接続経路の探索（Google STUN） | stun.l.google.com と stun1.l.google.com〜stun4.l.google.com、UDP 19302 | 経路探索用。これだけを許可しても通話全体は通りません |
| 接続経路の探索（Cloudflare STUN） | stun.cloudflare.com、UDP 3478 | 通話開始時にサーバーから渡される接続先です |
| 音声・映像の中継（Cloudflare TURN） | turn.cloudflare.com、UDP 3478／TCP 3478／TCP 80／TLS 5349／TLS 443 | 複数の方式が渡され、通る方式が選ばれます。少なくとも1つの方式が通る経路を確認します |
| 相手との直接通信 | 相手側のアドレスと、通話時に選ばれるポート | 許可範囲を固定する場合は、中継経路で通話できるかも確認します |
通話の準備時に、サーバーから中継サーバー用の一時的な認証情報が渡されます。ホスト名は固定ですが、turn.cloudflare.com には世界共通のアドレスが使われ、最も近いCloudflareの拠点に接続されます。IPアドレスで通信を制限する場合は、CloudflareのTURNに関するFAQに記載された許可対象のIPアドレスを使い、turn.cloudflare.com の名前解決結果が変わっていないかを定期的に確認してください。Cloudflareはこのアドレスが変わらないことを保証していません。接続先とポートの一覧はCloudflare Realtime TURNの説明にあります。
TCP 443のTURN通信は、Webページを閲覧するHTTPS通信と同じものではありません。HTTPSだけを通すプロキシで、音声・映像も通ると判断しないでください。TLSあり（TLS 5349・TLS 443）とTLSなし（UDP 3478・TCP 3478・TCP 80）の両方が渡されるため、どちらか一方だけを許可する場合はその方式で通話できるかを確認します。
中継サーバーから相手側への通信は、UDPで中継されます。端末が接続するTURNサーバーのポートとは別のものです。ルーターのインターネット側からOriHime本体へ一律にポート転送する手順ではありません。
通信帯域
通話は回線の状態に合わせて画質を自動で変えます。帯域に余裕があれば上限まで使い、細い回線では画質を落として通話を続けます。最低条件と、余裕があるときの消費量は次のとおりです。
最低限必要な帯域
| 側 | 上り | 下り |
|---|---|---|
| OriHime本体 | 256kbps以上 | 64kbps以上 |
| 操作端末 | 64kbps以上 | 256kbps以上 |
パケットロスは4%以内が必要です。
帯域に余裕があるときの消費量
OriHime本体から操作端末へ送る映像で1.5〜2.5Mbps、最大で約2.6Mbpsです。通信量は1時間あたり約0.7〜1.1GBです。音声はこれとは別に最大128kbps程度です。
「インターネットに接続できない」と表示される場合
OriHime本体は、通話先とは別の接続先を使って、インターネットに接続できるかを確認します。次の到達確認先がすべて制限されていると、OriHime用の通信先を許可していても接続確認に失敗する場合があります。
- ICMPによる到達確認：
8.8.8.8、1.1.1.1。 - ICMPで確認できない場合のHTTPS確認：
www.google.com、www.cloudflare.com（TCP 443）。
上記の到達確認先のいずれか1つと通信できれば、到達確認は成功します。組織の方針で制限する場合は、利用できる到達確認の経路を確認してください。
Wi-Fi・プロキシ・回線品質の確認
- Wi-FiはOriHime本体の世代・仕様に合う周波数帯と認証方式を確認します。詳細は5GHz・会社の認証方式へ進んでください。
- IPアドレス、ゲートウェイ、DNSを取得できることを確認します。固定IPを使う場合は固定IPの設定を確認してください。
- プロキシが必要な場合はプロキシの設定に加え、WebSocketと通話の中継経路が通るか確認します。
- OriHime本体の日時が大きくずれる場合は、時刻同期が制限されていないかも確認します。
- 回線速度だけでなく、遅延・途切れ・混雑を確認します。必要帯域は画質や同時接続数で変わるため、回線状態の記録と実際の通話で判断します。
最後に確認すること
実際に使うネットワークと端末で、ログイン、通話開始、双方向の音声、映像、首・腕の操作を確認します。同時接続を使う場合は、予定している人数・台数でも試してください。一定時間で切れる場合は、発生時刻と通信の遮断記録を照合します。
つながらない場合は、ネットワークを管理するIT担当者に、接続が止まる段階と発生時刻を伝え、ファイアウォール・プロキシ・Wi-Fiの設定と通信ログを確認してもらいます。