Version: 2023.1
言語: 日本語
WebGL - ブラウザーによるデバイス機能へのアクセス
WebGL のカーソルロックと全画面モード

WebGL networking

WebGL でネットワークを利用するには、以下の 2 つの方法があります。

Optionally, you can use WebSockets or WebRTC from JavaScript to implement your own networking. You can’t use any .NET networking classes within the WebGL platform because JavaScript code doesn’t have direct access to internet protocol (IP) sockets to implement network connectivity. Specifically, WebGL doesn’t support any .NET classes within the System.Net namespace.

WebGL での UnityWebRequest クラスの使用

Unity は、WebGL の UnityWebRequest クラスをサポートします。UnityWebRequest クラスを実装するために、Unity は JavaScript Fetch API を使用します。これはブラウザーを使用してウェブリクエストを処理します。これにより、クロスドメインリソースへのアクセスにセキュリティ制限が課されます。

If you send a web request to a server other than the one that hosts the Unity content, the server you’re sending it to must authorize the Unity content.

WebGL でクロスドメインのウェブリソースにアクセスするには、アクセスしようとしているサーバーが オリジン間リソース共有 (CORS) を使用してドメインのウェブリソースを認証する必要があります。

UnityWebRequest を使用してコンテンツにアクセスしようとするときに、リモートサーバーに CORS が設定されていないと、ブラウザーのコンソールに以下のようなエラーが表示されます。

Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at http://myserver.com/. この問題はリソースを同じドメインに移すか、 CORS を使用可能にすると修正されます

サーバーは、送信する http レスポンスに Access-Control ヘッダーを加えて、どのウェブページがウェブブラウザーからその情報を読み取る権限を持っているかを示す必要があります。

For a demonstration of how to add Access-Control headers that allow Unity WebGL to access resources on a web server from any origin, refer to the following example. This example includes common request headers and allows the GET, POST or OPTIONS methods:

"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 のダウンロード

以下のような、UnityWebRequest のダウンロードをブロックするコードは使用しないでください。

while(!www.isDone) {}

スレッドをブロックして UnityWebRequest のダウンロードが終了するのを待つことはできません。それを行うと、アプリケーションがフリーズしてしまうからです。WebGL はシングルスレッドであり、JavaScript の fetch API は非同期であるため、ブラウザーに制御を戻さないとダウンロードが終了しない可能性があります。代わりに、Coroutine と yield ステートメントを使用して、ダウンロードが終了するのを待ちます。詳細については、UnityWebRequest を使ったコルーチンの例 を参照してください。

Unity Multiplayer の使用

Unity Multiplayer enables communication via the WebSockets protocol. Refer to NetworkServer.useWebSockets.

JavaScript の WebSocket またはWebRTC の使用

WebGL doesn’t allow direct access to IP sockets, but you can use WebSockets or WebRTC (the two most common networking protocols supported by browsers) to get around this. While WebSockets are widely supported, WebRTC allows peer-to-peer connections between browsers and unreliable connections. Unity doesn’t have a built-in API that allows you to use WebSockets or WebRTC, but you can use a JavaScript plug-in to implement this. You can find plug-ins that implement WebSocket networking on the Unity Asset Store.

WebGL - ブラウザーによるデバイス機能へのアクセス
WebGL のカーソルロックと全画面モード