文档

Unity 引擎

Unity 引擎

Web 平台 .NET API 支持

了解 .NET API ON Web 平台上的局限性,包括不受支持的Namespaces空间和替代方法。
阅读时间6 分钟最后更新于 6 天前

Web 平台支持大多数 .NET API,但由于浏览器 SECURITY 限制、缺少 Managed 线程以及缺少原始网络套接字访问,某些 API 存在局限性。

System.Collections.Concurrent

System.Collections.Concurrent
中的所有容器都在 Web 平台上编译,但它们缺乏真正的线程安全性。Unity 将这些容器中的同步图元替换为空函数。使用 Collections 包替代爆发编译的作业。

System

大多数文件 I/O 通过 Emscripten 的内存虚拟文件系统 (MEMFS) 工作。异步 I/O API 不起作用,因为它们受
ThreadPool
支持。表列出了具有限制的 API。

类

状态

注意

DriveInfo不支持。All methods 抛出
NotSupportedException
。
FileStream部分支持All Synchronous 操作都可以运行。异步方法会导致无法恢复的浏览器挂起。
FileSystemAclExtensions不支持。仅限 Windows。All methods 抛出
NotSupportedException
。

System

由于 Web 平台Support持托Managed线程,因此此命名空间空间中的大多数 API 的功能有限。同步图元在不抛出的情况下编译和执行,但其线程行为没有特效。唯一的例外是
Interlocked
、
Thread.MemoryBarrier
和
Volatile
,它们在爆发编译的作业中提供真实的硬件语义。
表列出了具有限制的 API。

类

状态

注意

CancellationTokenSource部分支持超时机制不起作用,因为它依赖于 ON
Timer
。
CompressedStack不支持。All methods 抛出
NotSupportedException
。
EventWaitHandle不支持。命名事件句柄抛出
NotSupportedException
。Other 方法执行但没有特效。
HostExecutionContextManager不支持。All methods 抛出
NotImplementedException
。
互锁部分支持该方法在 Managed 代码中执行时没有特效,但在爆发编译的作业中提供真实的硬件语义。
Monitor不支持。Other 方法执行但没有特效。
Mutex不支持。指定的互斥体抛出
NotSupportedException
。Other 方法执行但没有特效。
信号不支持。命名信号量抛出
NotSupportedException
。Other 方法执行但没有特效。
线程不支持。可以构造。
Start()
不会抛出,但线程委托不会执行。
Join
、
Priority
(设置)和
DisableComObjectEagerCleanup
失败。
Thread.MemoryBarrier部分支持该方法在 Managed 代码中执行时没有特效,但在爆发编译的作业中提供真实的硬件语义。
ThreadPool不支持。
QueueUserWorkItem
和
UnsafeQueueUserWorkItem
接受 Calls 但回调从不执行。
Timer不支持。不起作用,因为它依赖于 ON
ThreadPool
。
波动部分支持该方法在 Managed 代码中执行时没有特效,但在爆发编译的作业中提供真实的硬件语义。

System

System.Threading.Tasks
命名空间中的以下类型和方法可以正常运行:
  • ValueTask
  • ValueTask<T>
  • TaskCompletionSource<T>
  • Synchronous 工厂方法,例如
    Task.FromResult
    和
    Task.CompletedTask
    。
通过
ThreadPool
调度工作的所有 API 都会导致无法恢复的浏览器挂起。使用
Awaitable
进行异步编程,因为它比
Task
具有更低的内存开销。
表列出了具有限制的 API。

类

状态

注意

并行不支持。All 方法(
For
、
ForEach
、
Invoke
)都会导致无法恢复的浏览器挂起。
Task.延时不支持。导致无法恢复的浏览器挂起。内部部计Timer不Fire。
Task.运行不支持。导致无法恢复的浏览器挂起。计划通过
ThreadPool
运行。
TaskFactory/TaskFactory<T>不支持。
StartNew
、
ContinueWhenAll
和
ContinueWhenAny
All 都会导致无法恢复的浏览器挂起。

System.Timers

System.Timers.Timer
ON Web 平台无效,因为
Elapsed
事件依赖于线程池机制,而该机制不起作用。

System 和 System

System.Net
和
System.Net.Http
Namespaces 中的以下数据类可以正常运行:
  • Cookie
  • WebHeaderCollection
  • SocketAddress
  • HttpRequestMessage
  • StringContent
  • MultipartContent
不支持
HttpListener
,因为无法在浏览器中运行 Web Server。
以下类未实现并导致无法恢复的浏览器挂起:
  • HttpClient
  • WebClient
  • HttpWebRequest
  • FileWebRequest
使用 UnityWebRequest 替代 HTTP 请求。

System.Net.Security

不支持
SslStream
和
NegotiateStream
。配置选项有效。

System

浏览器沙盒不会显示 POSIX 套接字。只有纯数据类型(如
LingerOption
和
SocketException
)有效。
或者,通过 Javascript 插件使用浏览器的 WebSocket 或 WebRTC API。另一个选项是 Emscripten POSIX 套接字实现,它通过基于 WebSocket 的 Relay Server 代理套接字操作,从而连接到非 Web 客户端或服务器上的实际套接字端口。

System.Net.WebSockets

不支持
ClientWebSocket
。直接通过 Javascript 插件或第三方插件使用浏览器的 WebSocket API。

其他资源