ウェブネットワーキング
ウェブでのネットワーキングの使用方法。
読み終わるまでの所要時間 7 分最終更新 5日前
ウェブでのネットワーキングは以下の方法で使用できます。
- UnityWebRequest クラスを使用します。
- Unity Netcode ネットワーキング パッケージ。
ウェブでの UnityWebRequest クラスの使用
Unity はウェブの UnityWebRequest クラスをサポートします。UnityWebRequest クラスを実装するために、Unity は JavaScriptScript Fetch API を使用します。これはブラウザーを使用してウェブエストを処理します。これにより、クロスドメインへのアクセスにセキュリティ制限が課されます。
Unity コンテンツをホストしているサーバー以外のサーバーにウェブリクエストを送信する場合は、送信先のサーバーが Unity コンテンツを承認する必要があります。
ウェブのクロスドメインウェブリソースにアクセスするには、アクセスしようとしているサーバがオリジン間リソース共有 (CORS) を使用してクロスドメインウェブリソースを認可する必要があります。
UnityWebRequest を使用してコンテンツにアクセスしようとしたときに、リモート サーバにオリジン間リソース共有 (CORS) が正しく設定されていない場合、ブラウザーコンソールに以下のようなエラーが表示されます。
クロスリクエストがブロックされました:Same Origin Policy では、http://myserver.com/ のリモートリソースを読み取ることができません。リソースを同じドメインに移動するかオリジン間リソース共有(CORS)を有効にすると、この問題は解決できます。
サーバは、送信する http 応答にアクセス制御ヘッダーを追加して、ウェブブラウザーからその情報を読み取る権限を持つ Web ページを示す必要があります。
Unity ウェブ が任意のオリジンからウェブ上のリソースにアクセスできるように Access-コントロール ヘッダーを追加する方法のデモについては、以下の例を参照してください。この例では、一般的なリクエストヘッダーを含み、GET、POST、または OPTIONS メソッドを使用できます。
"Access-Control-Allow-Credentials": "true","Access-Control-Allow-Headers":"Accept、X-Access-Token、X-Application-Name、X-Request-Sent-Time"、"Access-Control-Allow-Methods":"GET, POST, OPTIONS","Access-Control-Allow-Origin": "*",
UnityWebRequest downloads
UnityWebRequest のダウンロードをブロックする次のようなコードは使用しないでください。
while(!www.isDone) {}
ウェブ ブラウザーでは、ネットワーク転送を待機する同期ブロッキングコードの実行は許可されません。したがって、同期スタイルの UnityWebRequest を実行する必要がある場合は、コルーチンと yield ステートメントを使用してダウンロードが終了するのを待ちます。詳細については、UnityWebRequest を使用したコルーチンの例 を参照してください。
Unity Netcode ネットワーキング パッケージの使用
セキュリティの制限により、ウェブは TCP や UDP ソケットに直接アクセスすることはできません。代わりに、ウェブ プラットプラットフォームをサポートする Unity Netcode ネットワーキングパッケージを使用できます。詳細については、ドキュメント About Netcode for GameObjects(Unity Multiplayer Networking)を参照してください。
ウェブ ブラウザーのネットワーク標準の詳細については、以下の探るしてください。
- WebSocket プロトコル(Datatracker)
- WebRTC:ブラウザでのリアルタイム通信 (W3)
- WebTransport (W3)。
ウェブ ネットワーキングの制限
ウェブプラットフォームがサポートしないネットワーク機能がいくつかあります。
.NET ネットワーククラスのサポートなし
ブラウザーのサンドボックスはIPソケットへの直接アクセスを提供しないため、ウェブプラットフォームは、、などの.NETネットワーキングI/Oクラスをサポートしていません。.NET API 制限の完全なリストについては、ウェブプラットフォームの .NET API サポート を参照してください。
System.Net.SocketsSystem.Net.HttpSystem.Net.WebSocketsネイティブソケットアクセスはサポートなし
ウェブ プラットプラットフォームは、ブラウザー内のセキュリティ制限のためにネイティブソケットアクセスをサポートしていません。したがって、ウェブは UnityEngine.Ping (ICMP) のような機能もサポートしません。