> For the complete documentation index, see [llms.txt](https://docs.digitalhumans.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalhumans.jp/itp-guide/network-requirements.md).

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

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

本製品は、ブラウザだけで受講できます。専用アプリやVR/ARヘッドセットは不要です。そのかわり、次の2種類の通信がブラウザから外部へ出られる必要があります。

| 通信              | 用途                                    | 主な要件                                        |
| --------------- | ------------------------------------- | ------------------------------------------- |
| デジタルヒューマンの映像・音声 | デジタルヒューマンの映像と声を受け取る（WebRTC、TURNによる中継） | `*.uneeq.io`（443/TCP）とTURNサーバー（UDPを推奨）      |
| 音声認識            | 受講者の声を文字に変換し、デジタルヒューマンに「聞かせる」         | `api.deepgram.com` へのWebSocket（WSS、443/TCP） |

{% hint style="warning" %}
「デジタルヒューマンに声が届かない」という問い合わせの多くは、音声認識（Deepgram）へのWebSocket通信が社内のファイアウォールで止められていることが原因です。\
音声認識の要件は、デジタルヒューマン全般のファイアウォール要件とは別に設定が必要です。下記の「[音声認識（Deepgram）の要件](#speech-recognition)」を必ずご確認ください。
{% endhint %}

## 映像・音声（WebRTCとTURN）の要件 <a href="#webrtc-turn" id="webrtc-turn"></a>

デジタルヒューマンの映像と音声は、WebRTCという仕組みでブラウザに届きます。クラウドで動くデジタルヒューマンとブラウザの間は、TURNサーバーが中継します。WebRTCとTURNの仕組み、IPアドレスで許可設定をしないでいただきたい理由は、[ファイアウォール・ネットワーキングとWebRTC + TURN](https://docs.digitalhumans.jp/dev/overview/firewall-requirements.md) で説明しています。

本製品で許可が必要な宛先とポートは次のとおりです。

| 宛先                         | ポート           | プロトコル   |
| -------------------------- | ------------- | ------- |
| `*.uneeq.io`               | 443           | TCP     |
| `*.turn.uneeq.io`          | 3478、443、5349 | UDPとTCP |
| `*.turn.uneeq.io`（メディアの中継） | 22000〜23000   | UDPとTCP |

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

本製品のサインイン画面で使われるドメインについては、[弊社にお問い合わせください](https://www.digitalhumans.com/jp/contact)。

### 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）の要件 <a href="#speech-recognition" id="speech-recognition"></a>

本製品は、受講者の声を聞き取るためにDeepgram社のリアルタイム音声認識サービスを使います。ブラウザからDeepgramのサーバーへWebSocketで直接つなぐため、[デジタルヒューマン全般のファイアウォール要件](https://docs.digitalhumans.jp/dev/overview/firewall-requirements.md)とは別に、次の許可が必要です。

| 項目       | 値                          |
| -------- | -------------------------- |
| ドメイン     | `api.deepgram.com`         |
| プロトコル    | WSS（TLS上のWebSocket）        |
| ポート      | 443                        |
| URLのパターン | `wss://api.deepgram.com/*` |

ファイアウォールの許可リストに、次のルールを追加してください。

```
Allow outbound TCP port 443 to 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の接続を正しく扱えることを確認してください。

{% hint style="warning" %}
Palo Alto、Fortinet、Zscalerなどのセキュリティ製品は、初期設定でWebSocketの接続要求を遮断したり書き換えたりすることがあります。\
その場合は、`api.deepgram.com` を例外として登録してください。
{% endhint %}

### 接続テスト

#### 診断ツールで確認する

UneeQが提供する診断ツール「[STT接続テストツール](https://presales.services.uneeq.io/teststt)」を、受講者が使うネットワークの端末で開いてください。実際に話した声が文字に変換されるかで、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）で表示されます。
* **失敗**: 接続が表示されない、または接続してすぐにエラーで切れます。

#### コマンドで確認する

受講者が使うネットワークの端末で、ターミナル（コマンドプロンプト）から次を実行します。

```bash
# 名前解決の確認
nslookup api.deepgram.com

# TCP 443 番ポートへの接続の確認
curl -v --max-time 5 https://api.deepgram.com
```

`nslookup` が失敗する、または想定外のIPアドレスが返る場合は、DNSで遮断されています。`curl` がタイムアウトする場合は、ファイアウォールで接続が遮断されています。

### 症状と対処

| 症状                                                            | 考えられる原因                   | 対処                                     |
| ------------------------------------------------------------- | ------------------------- | -------------------------------------- |
| WebSocketの接続が表示されない                                           | ファイアウォールが443番ポートを遮断している   | `api.deepgram.com:443` を許可する           |
| WebSocketがつながってすぐ切れる                                          | TLS検査が干渉している              | このドメインをSSL復号の対象から除外する                  |
| 社内ネットワークでだけ失敗する                                               | DPIがWebSocketの接続要求を遮断している | WebSocketの通信を例外に登録する                   |
| 同じ端末を、社内ネットワークから外したとき（モバイル回線へのテザリングなど）はつながるが、社内ネットワークではつながらない | 社内ネットワークに制限がある            | ネットワーク側で遮断されていることが確定します。上記の4点を確認してください |

## 導入前のチェックリスト

* [ ] `*.uneeq.io` への443/TCPを許可した
* [ ] `*.turn.uneeq.io` への3478・443・5349（UDPとTCP）と、22000〜23000（UDPとTCP）を許可した
* [ ] UDPの通信が通ることを確認した
* [ ] 受講時にVPNを経由しない（または本製品の通信をVPNの外へ出す）設定にした
* [ ] `api.deepgram.com` が名前解決できる
* [ ] `api.deepgram.com` への外向き443/TCPを許可した
* [ ] WebSocketの接続要求（Upgradeヘッダー）が遮断・書き換えされない
* [ ] `api.deepgram.com` をTLS検査の対象から除外した（TLS検査をしている場合）
* [ ] [STT接続テストツール](https://presales.services.uneeq.io/teststt)で、声が文字に変換されることを確認した

ネットワークの設定で解決しない場合は、[トラブルシューティング](https://docs.digitalhumans.jp/itp-guide/network-requirements/troubleshooting.md)もご覧ください。それでも解決しない場合は、[弊社にお問い合わせください](https://www.digitalhumans.com/jp/contact)。

## 関連ページ

* [ファイアウォール・ネットワーキングとWebRTC + TURN](https://docs.digitalhumans.jp/dev/overview/firewall-requirements.md)（デジタルヒューマン全般の通信の仕組み）
* [デジタルヒューマンが私の声を聞いていない様です](https://docs.digitalhumans.jp/users/troubleshooting/digitalhuman-not-hearing-voice.md)（端末のマイクの確認）
* [セキュリティとデータの取り扱い](https://docs.digitalhumans.jp/itp-guide/network-requirements/security-and-data.md)
* [トラブルシューティング](https://docs.digitalhumans.jp/itp-guide/network-requirements/troubleshooting.md)
