ファイアウォール・ネットワーキングとWebRTC + TURN

ネットワークアクセスが制限された環境でデジタルヒューマンを使用するためには、デジタルヒューマンを表示・使用する端末が以下のドメインと通信できるように、ファイアウォール、プロキシ、ルーターなどを許可してください。

 
💡
デジタルヒューマンプラットフォームとの通信はWebRTCを使用します。デジタルヒューマンの表示にはTURNを使用しており、TURNサーバーのIPアドレス、デジタルヒューマンプラットフォームのIPアドレスは環境や状況によって動的に決まりますので、IPアドレスで縛らないでください。
 

アニメーションプラットフォーム、プラットフォーム標準の音声認識(必須

アプリケーション層ファイアウォールで下記のドメインとの通信、戻りの通信を許可してください。

Platform2.0

*.uneeq.io
*.digitalhumans.ne.jp
*.hosted-experience.jp

上記に追加でデモ・フリートライアルやサービス用のフロントエンドが設置されているドメインの許可も必要です。

お客様がデジタルヒューマンを設置したいドメイン
your-domain.com # 例

デモ・フリートライアルは下記のドメインを使用します
*.digitalhumans-demo.jp
 

その他(オプション)

ご提供しているカスタム項目等にもよりますが、当社が管理する下記ドメインを持つサーバーからアセットを読み込みます。(現在、ドメインを整理中のため複数にわたっております。)

Platform2.0

*.digitalhumans-demo.jp # デモ用のフロントエンド設置ドメイン
 
 

ネットワーキング、WebRTC + TURN

ユーザーとデジタルヒューマンとの間で会話を行うためには、デジタルヒューマンのレンダラー(レンダリングアプリケーション)からユーザーのブラウザへメディアストリームを確立する必要があります。これは一般的にWebRTC APIとして知られているものを使用します。

 
Notion image

WebRTCのためのハイレベルネットワーク通信経路

 
 

ダイレクト / 直接接続 (P2P)

レンダラーとブラウザ間の直接接続をネゴシエートできるようにするためには、各当事者が相手に自分のIPアドレスを送信する必要があります。ブラウザはレンダラーアプリケーションから送信されたIPアドレスにアクセスできる必要があり、その逆も同様です。直接接続できる条件がそろった場合は、この方式で接続します。

インダイレクト / 間接接続

クラウドでホストされているレンダラーとエンドユーザー間の通信では、レンダラーとエンドユーザーのブラウザ間でメディアストリームを中継するためにTURNサーバーを使用する必要があります。TURNプロトコルでは、TURNサーバーがレンダラーとブラウザの両方に接続します。

レンダラーはストリーミングデータをすべてTURNサーバーに送信し、TURNサーバーはそのデータをブラウザに転送します。この場合、レンダラーとブラウザ間に直接の接続はありません。

これはWebRTCでは非常に一般的であり、モバイルデバイスを無線キャリアネットワーク経由でサポートする必要がある場合や、セキュリティ保護されたエンタープライズネットワーク上のクライアントをサポートする場合には、TURNサーバーを使用する以外に選択肢がないことがあります。モバイルおよびエンタープライズネットワークでは、クライアントがWebRTCプロトコルを使用して正常に接続することが妨げられる場合があります。

 

必要なネットワーク設定

更に詳細に設定が必要な場合は下記の様に設定してください。お客様のリージョンに応じて、ユーザーが以下にアクセスできるようにする必要があります:

リージョン
ステータス
URL
ポート
すべて
現行
*.uneeq.io *.digitalhumans.ne.jp *.hosted-experience.jp
443 (TCP)
グローバル / 米国
非推奨、まだ稼働中
3478および5349(UDPとTCP) 49152 - 65535(UDPとTCP)
グローバル / 米国
将来、現在稼働中
*.turn.uneeq.io
3478および5349(UDPとTCP) 22000 - 23000 UDP
EU
非推奨、まだ稼働中
3478および5349(UDPとTCP) 22000 - 23000 UDP
EU
将来、現在稼働中
*.turn.uneeq.io
3478および5349(UDPとTCP) 22000 - 23000 UDP

ご質問がある場合は、カスタマーサービスにお問い合わせください。

 

シーケンスダイアグラム

デジタルヒューマンを表示するために必要なWebRTCシーケンス、通信経路は以下の通りです。

Notion image

Renderer(レンダラー) は弊社が管理・運用するクラウド、カスタマーが運用するクラウド、オンプレミス、デスクトップやラップトップにインストールされた環境など複数のパターンが存在します。

お役に立ちましたか?
😞
😐
🤩

最終更新日 April 10, 2025