For the complete documentation index, see llms.txt. This page is also available as Markdown.

ネットワーク要件と接続テスト

このページは、イマーシブトレーニングプラットフォームを社内ネットワークで利用するための、情報システム部門向けの要件をまとめたものです。導入前に、受講者が使う端末のネットワークで下記を確認してください。

本製品は、ブラウザだけで受講できます。専用アプリや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

TURNサーバーとの接続には、TLS 1.2以上が必要です。TLS 1.0 / 1.1など、それより古い方式での接続には対応していません。

本製品のサインイン画面で使われるドメインについては、弊社にお問い合わせください。

443番ポートしか開けられないネットワークの場合

TURNサーバーは、通常のTURN用ポート(3478、5349)に加えて、443番ポートでも接続を受け付けます。外向きの通信を443番ポートだけに制限しているネットワークでも、デジタルヒューマンの映像・音声をつなげられます。

ブラウザは、次の順に使える経路を自動で選びます。受講者側での設定は不要です。

  1. UDPの3478番ポート(最も品質が良く、遅延が少ない)

  2. UDPの443番ポート(DTLS。品質は1と同等で、多くのファイアウォールを通過できる)

  3. TCPの443番ポート(TLS。UDPがすべて止められている場合の代替)

UDPを許可してください

最良の品質で受講いただくには、UDPの通信(3478番と443番)を許可してください。UDPが止められているとTCPで接続しますが、次のように品質が下がります。

観点
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点がすべて満たされている必要があります。

  1. 名前解決(DNS): api.deepgram.com が正しく名前解決できること。DNSで遮断されていたり、DNSベースのセキュリティ製品でフィルタされていたり、シンクホールへ向けられていたりしないことを確認してください。

  2. 外向きのTLS接続: api.deepgram.com の443番ポートへのTLS接続が、ファイアウォールで許可されていること。

  3. WebSocketのヘッダー: ファイアウォールでパケットの中身を検査(DPI)している場合、HTTP Upgrade: websocket のヘッダーが、書き換えられたり遮断されたりせずに通過できること。

  4. TLS検査(SSL復号): TLSを復号して検査するプロキシを使っている場合、WebSocketの接続確立に失敗することがあります。api.deepgram.com をTLS検査の対象から除外することをおすすめします。除外できない場合は、プロキシがWebSocketの接続を正しく扱えることを確認してください。

接続テスト

診断ツールで確認する

UneeQが提供する診断ツール「STT接続テストツール」を、受講者が使うネットワークの端末で開いてください。実際に話した声が文字に変換されるかで、Deepgramへの接続を確認できます。

テストが失敗した場合は、このページを社内のネットワーク管理者にご共有ください。

ブラウザの開発者ツールで確認する

  1. ブラウザの開発者ツールを開きます(F12 キー)。

  2. 「Network」タブを開きます。

  3. 絞り込みで「WS」(WebSocket)を選びます。

  4. トレーニングを開始し、マイクに向かって話します。

  5. 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点を確認してください

導入前のチェックリスト

ネットワークの設定で解決しない場合は、トラブルシューティングもご覧ください。それでも解決しない場合は、弊社にお問い合わせください。

関連ページ

最終更新