ドキュメント

Unity Engine

Unity Engine

ウェブ プラットプラットフォームでの .NET API のサポート

サポートされていない名前空間や代替手段など、ウェブ プラットプラットフォームの .NET API の制限を理解します。
読み終わるまでの所要時間 11 分最終更新 5日前

ウェブプラットフォームは、ほとんどの .NET API をサポートしていますが、ブラウザーセキュリティー制限、マネージスレッドの不在、Raw ネットワークソケットアクセスの欠如による制限がある API もあります。

System.Collections.Concurrent

System.Collections.Concurrent
のすべてのコンテナはウェブプラットフォームでコンパイルされますが、実際のスレッド安全性に欠けます。Unity は、これらのコンテナ内の同期プリミティブを空の関数に置き換えます。Burstコンパイルされたジョブの代わりにCollectionsパッケージを使用します。

System.IO

ほとんどのファイル I/O は Emscripten のインメモリ仮想ファイルシステム (MEMFS) を介して動作します。非同期I/O APIは
ThreadPool
によってバックアップされているため機能しません。以下の表に、制限事項のある API を示します。

クラス

status

ノート

DriveInfoサポートされていません。すべてのメソッドが
NotSupportedException
をスローします。
FileStream一部サポート同期操作はすべて動作します。非同期メソッドにより、回復不可能なブラウザー ハングが発生します。
FileSystemAclExtensionsサポートされていません。Windows のみ。すべてのメソッドが
NotSupportedException
をスローします。

System.Threading

ウェブ プラットプラットフォームはマネージスレッドをサポートしていないため、この名前空間空間のほとんどの API の機能に制限があります。同期プリミティブはスローせずにコンパイルおよび実行されますが、スレッド動作にはエフェクトがありません。唯一の例外は
Interlocked
、
Thread.MemoryBarrier
、
Volatile
で、Burstコンパイルされたジョブ内で実際のハードウェア セマンティクスを提供します。
以下の表に、制限事項のある API を示します。

クラス

status

ノート

CancellationTokenSource一部サポートタイムアウト メカニズムは、
Timer
に依存するため機能しません。
CompressedStackサポートされていません。すべてのメソッドが
NotSupportedException
をスローします。
EventWaitHandleサポートされていません。名前付きイベントハンドル スロー
NotSupportedException
。他のメソッドは実行されますがエフェクトはありません。
HostExecutionContextManagerサポートされていません。すべてのメソッドが
NotImplementedException
をスローします。
連動一部サポートメソッドはマネージコードではエフェクトなしで実行されますが、Burst コンパイルされたジョブ内で実際のハードウェアセマンティクスを提供します。
監視サポートされていません。他のメソッドは実行されますがエフェクトはありません。
ミューテックスサポートされていません。名前付きミューテックスは
NotSupportedException
をスローします。他のメソッドは実行されますがエフェクトはありません。
セマフォサポートされていません。名前付きセマフォの throw
NotSupportedException
他のメソッドは実行されますがエフェクトはありません。
Thread (スレッド)サポートされていません。構築可能。
Start()
はスローされませんが、スレッドデリゲートは実行されません。
Join
、
Priority
(設定)、および
DisableComObjectEagerCleanup
は失敗します。
Thread.MemoryBarrier一部サポートメソッドはマネージコードではエフェクトなしで実行されますが、Burst コンパイルされたジョブ内で実際のハードウェアセマンティクスを提供します。
ThreadPoolサポートされていません。
QueueUserWorkItem
と
UnsafeQueueUserWorkItem
はコールを受け入れますが、コールバックは実行されません。
タイマーサポートされていません。
ThreadPool
に依存するため機能しません。
揮発性一部サポートメソッドはマネージコードではエフェクトなしで実行されますが、Burst コンパイルされたジョブ内で実際のハードウェアセマンティクスを提供します。

System.Threading.タスク

System.Threading.Tasks
名前空間の以下の型とメソッドが正しく機能します。
  • ValueTask
  • ValueTask<T>
  • TaskCompletionSource<T>
  • 同期 Factory メソッド (
    Task.FromResult
    や
    Task.CompletedTask
    など)。
ThreadPool
ワークを通じてスケジュール設定するすべての API は、回復不可能なブラウザー ハングを引き起こします。非同期プログラミングには
Awaitable
を使用します。これは、
Task
よりもメモリ オーバーヘッドが小さいためです。
以下の表に、制限事項のある API を示します。

クラス

status

ノート

並列サポートされていません。すべてのメソッド (
For
、
ForEach
、
Invoke
) が回復不能なブラウザーハングを引き起こします。
Task.遅延サポートされていません。回復不能なブラウザー ハングを引き起こします。内部タイマーは作動しません。
Task.Runサポートされていません。回復不能なブラウザー ハングを引き起こします。スケジュールは
ThreadPool
を通じて機能します。
TaskFactory / TaskFactory<T>サポートされていません。
StartNew
、
ContinueWhenAll
、
ContinueWhenAny
はすべて、回復不可能なブラウザー ハングの原因になります。

System.Timers

Web プラットフォームでは
System.Timers.Timer
は機能しません。これは、
Elapsed
イベントがスレッドプールメカニズムに依存し、スレッドプールメカニズムが機能しないためです。

System.Net と System.Net.Http

System.Net
名前空間と
System.Net.Http
名前空間の以下のデータ クラスは正しく機能します。
  • Cookie
  • WebHeaderCollection
  • SocketAddress
  • HttpRequestMessage
  • StringContent
  • MultipartContent
HttpListener
はブラウザー内でウェブサーバーを実行できないため、サポートされていません。
以下のクラスは実装されておらず、回復不能なブラウザー ハングの原因になります。
  • HttpClient
  • WebClient
  • HttpWebRequest
  • FileWebRequest
HTTP リクエストの代わりに UnityWebRequest を使用します。

System.Net.Security

SslStream
と
NegotiateStream
はサポートされていません。設定オプション クラスは動作します。

System.Net.Sockets

ブラウザーのサンドボックスは POSIX ソケットを公開しません。
LingerOption
や
SocketException
などの純粋なデータ型のみが動作します。
代わりに、JavaScript プラグインを使用してブラウザーの WebSocket または WebRTC API を使用します。もう1つのオプションは、Emscripten POSIXソケット実装です。これは、WebSocketベースのRelayサーバーを介してソケット操作をプロキシし、非ウェブクライアントまたはサーバーの実際のソケットポートに接続します。

System.Net.WebSockets

ClientWebSocket
はサポートされていません。JavaScript プラグインまたはサードパーティのプラグインを介してブラウザーの WebSocket API を直接使用します。

追加リソース