ネットワーク要件と接続テスト
このページは、イマーシブトレーニングプラットフォームを社内ネットワークで利用するための、情報システム部門向けの要件をまとめたものです。導入前に、受講者が使う端末のネットワークで下記を確認してください。
本製品は、ブラウザだけで受講できます。専用アプリやVR/ARヘッドセットは不要です。そのかわり、次の2種類の通信がブラウザから外部へ出られる必要があります。
デジタルヒューマンの映像・音声
デジタルヒューマンの映像と声を受け取る(WebRTC、TURNによる中継)
*.uneeq.io(443/TCP)とTURNサーバー(UDPを推奨)
音声認識
受講者の声を文字に変換し、デジタルヒューマンに「聞かせる」
api.deepgram.com へのWebSocket(WSS、443/TCP)
映像・音声(WebRTCとTURN)の要件
デジタルヒューマンの映像と音声は、WebRTCという仕組みでブラウザに届きます。クラウドで動くデジタルヒューマンとブラウザの間は、TURNサーバーが中継します。WebRTCとTURNの仕組み、IPアドレスで許可設定をしないでいただきたい理由は、ファイアウォール・ネットワーキングとWebRTC + TURN で説明しています。
本製品で許可が必要な宛先とポートは次のとおりです。
*.uneeq.io
443
TCP
*.turn.uneeq.io
3478、443、5349
UDPとTCP
*.turn.uneeq.io(メディアの中継)
22000〜23000
UDPとTCP
本製品のサインイン画面で使われるドメインについては、弊社にお問い合わせください。
443番ポートしか開けられないネットワークの場合
TURNサーバーは、通常のTURN用ポート(3478、5349)に加えて、443番ポートでも接続を受け付けます。外向きの通信を443番ポートだけに制限しているネットワークでも、デジタルヒューマンの映像・音声をつなげられます。
ブラウザは、次の順に使える経路を自動で選びます。受講者側での設定は不要です。
UDPの3478番ポート(最も品質が良く、遅延が少ない)
UDPの443番ポート(DTLS。品質は1と同等で、多くのファイアウォールを通過できる)
TCPの443番ポート(TLS。UDPがすべて止められている場合の代替)
UDPを許可してください
最良の品質で受講いただくには、UDPの通信(3478番と443番)を許可してください。UDPが止められているとTCPで接続しますが、次のように品質が下がります。
遅延
少ない
多い(接続の手順や再送の確認が増えるため)
パケットの欠落
欠けたパケットを飛ばして再生を続ける
再送を待つ間、後続のデータがすべて止まる
ゆらぎ(ジッター)
小さい
混雑時に大きくなりやすい
全体の品質
最適
低下する。特に口の動きと音声のずれ、応答の遅れが目立つ
TCPでの接続は、次のようなネットワークで特に品質の低下が目立ちます。
パケットの欠落があるネットワーク(1〜2%の欠落でも遅れが目立つことがあります)
遅延の大きいネットワーク
混雑しているネットワーク
受講者から「映像や音声の質が悪い」という声があがった場合は、通信がUDPではなくTCPで行われていないかを確認してください。
VPNを経由させないでください
VPNを経由すると遅延が増え、映像と音声の品質が目に見えて下がります。受講時はVPNを使わないことをおすすめします。
VPNを使う必要がある場合は、Web会議の通信と同じように、本製品の通信をVPNの外へ出す(スプリットトンネルにする)設定をご検討ください。
必要な帯域
デジタルヒューマンの映像を受け取るために、最低限必要な帯域は次のとおりです。
HD 720p
2.5 Mbps
HD 1080p(既定)
5 Mbps
これらは最低値です。同じネットワークで多くの受講者が同時に受講する場合や、混雑しやすいネットワークでは、余裕を持った帯域をご用意ください。
音声認識(Deepgram)の要件
本製品は、受講者の声を聞き取るためにDeepgram社のリアルタイム音声認識サービスを使います。ブラウザからDeepgramのサーバーへWebSocketで直接つなぐため、デジタルヒューマン全般のファイアウォール要件とは別に、次の許可が必要です。
ドメイン
api.deepgram.com
プロトコル
WSS(TLS上のWebSocket)
ポート
443
URLのパターン
wss://api.deepgram.com/*
ファイアウォールの許可リストに、次のルールを追加してください。
確認していただきたい4つの点
音声認識が動くには、次の4点がすべて満たされている必要があります。
名前解決(DNS):
api.deepgram.comが正しく名前解決できること。DNSで遮断されていたり、DNSベースのセキュリティ製品でフィルタされていたり、シンクホールへ向けられていたりしないことを確認してください。外向きのTLS接続:
api.deepgram.comの443番ポートへのTLS接続が、ファイアウォールで許可されていること。WebSocketのヘッダー: ファイアウォールでパケットの中身を検査(DPI)している場合、
HTTP Upgrade: websocketのヘッダーが、書き換えられたり遮断されたりせずに通過できること。TLS検査(SSL復号): TLSを復号して検査するプロキシを使っている場合、WebSocketの接続確立に失敗することがあります。
api.deepgram.comをTLS検査の対象から除外することをおすすめします。除外できない場合は、プロキシがWebSocketの接続を正しく扱えることを確認してください。
接続テスト
診断ツールで確認する
UneeQが提供する診断ツール「STT接続テストツール」を、受講者が使うネットワークの端末で開いてください。実際に話した声が文字に変換されるかで、Deepgramへの接続を確認できます。
テストが失敗した場合は、このページを社内のネットワーク管理者にご共有ください。
ブラウザの開発者ツールで確認する
ブラウザの開発者ツールを開きます(
F12キー)。「Network」タブを開きます。
絞り込みで「WS」(WebSocket)を選びます。
トレーニングを開始し、マイクに向かって話します。
wss://api.deepgram.com/v1/listenまたはwss://api.deepgram.com/v2/listenへの接続が表示されるかを確認します(どちらが使われるかは、使用している音声認識のモデルによります)。
成功: WebSocketの接続が、ステータス101(Switching Protocols)で表示されます。
失敗: 接続が表示されない、または接続してすぐにエラーで切れます。
コマンドで確認する
受講者が使うネットワークの端末で、ターミナル(コマンドプロンプト)から次を実行します。
nslookup が失敗する、または想定外のIPアドレスが返る場合は、DNSで遮断されています。curl がタイムアウトする場合は、ファイアウォールで接続が遮断されています。
症状と対処
WebSocketの接続が表示されない
ファイアウォールが443番ポートを遮断している
api.deepgram.com:443 を許可する
WebSocketがつながってすぐ切れる
TLS検査が干渉している
このドメインをSSL復号の対象から除外する
社内ネットワークでだけ失敗する
DPIがWebSocketの接続要求を遮断している
WebSocketの通信を例外に登録する
同じ端末を、社内ネットワークから外したとき(モバイル回線へのテザリングなど)はつながるが、社内ネットワークではつながらない
社内ネットワークに制限がある
ネットワーク側で遮断されていることが確定します。上記の4点を確認してください
導入前のチェックリスト
ネットワークの設定で解決しない場合は、トラブルシューティングもご覧ください。それでも解決しない場合は、弊社にお問い合わせください。
関連ページ
ファイアウォール・ネットワーキングとWebRTC + TURN(デジタルヒューマン全般の通信の仕組み)
デジタルヒューマンが私の声を聞いていない様です(端末のマイクの確認)
最終更新
