기술 자료

Unity 엔진

Unity 엔진

웹 플랫폼에서 .NET API 지원

지원되지 않는 네임스페이스 및 대안을 비롯하여 웹 플랫폼의 .NET API의 한계를 이해합니다.
읽는 시간 3분최근 업데이트: 9일 전

웹 플랫폼은 대부분의 .NET API를 지원하지만 일부 API는 브라우저 보안 제한, 관리되는 스레딩의 부재 및 원시 네트워크 소켓 액세스의 부재로 인해 제한이 있습니다.

SystemCollections.Concurrent

System.Collections.Concurrent
의 모든 컨테이너는 웹 플랫폼에서 컴파일하지만 실제 스레드 보안이 부족합니다. Unity 이러한 컨테이너의 동기화 프리미티브를 빈 함수로 대체합니다. Burst 컴파일 작업의 대안으로 Collections 패키지를 사용합니다.

System.IO

대부분의 파일 I/O는 Emscripten의 메모리 내 가상 파일 시스템(MEMFS)을 통해 작동합니다. 비동기 I/O API는
ThreadPool
에서 지원하므로 작동하지 않습니다. 다음 표에는 제한이 있는 API가 나열되어 있습니다.

클래스

상태

참고 사항

DriveInfo지원되지 않습니다.모든 방법은
NotSupportedException
를 던집니다.
FileStream부분적으로 지원됨모든 동기 연산이 작동합니다. 비동기 메서드를 사용하면 복구할 수 없는 브라우저 중단이 발생합니다.
FileSystemAclExtensions지원되지 않습니다.Windows 전용. 모든 방법은
NotSupportedException
를 던집니다.

System.Threading

웹 플랫폼은 관리되는 스레딩을 지원하지 않으므로 이 네임스페이스의 대부분의 API에는 기능이 제한됩니다. 동기화 프리미티브는 던지지 않고 컴파일 및 실행되지만 스레딩 동작에는 영향이 없습니다. 버스트 컴파일 작업 내에서 실제 하드웨어 시맨틱을 제공하는
Interlocked
,
Thread.MemoryBarrier
및
Volatile
만 예외입니다.
다음 표에는 제한이 있는 API가 나열되어 있습니다.

클래스

상태

참고 사항

CancellationTokenSource부분적으로 지원됨타임아웃 메커니즘은
Timer
에 의존하기 때문에 작동하지 않습니다.
CompressedStack지원되지 않습니다.모든 방법은
NotSupportedException
를 던집니다.
EventWaitHandle지원되지 않습니다.이름이 지정된 이벤트 핸들이
NotSupportedException
를 던집니다. 다른 메서드는 실행되지만 효과가 없습니다.
HostExecutionContextManager지원되지 않습니다.모든 방법은
NotImplementedException
를 던집니다.
인터록부분적으로 지원됨메서드는 관리되는 코드에서 효과 없이 실행되지만, Burst 컴파일 작업 내에서 실제 하드웨어 시맨틱을 제공합니다.
Monitor지원되지 않습니다.다른 메서드는 실행되지만 효과가 없습니다.
Mutex지원되지 않습니다.이름이 지정된 음소거는
NotSupportedException
를 던집니다. 다른 메서드는 실행되지만 효과가 없습니다.
세마포지원되지 않습니다.이름이 지정된 세마포는
NotSupportedException
를 던집니다. 다른 메서드는 실행되지만 효과가 없습니다.
Thread지원되지 않습니다.구성할 수 있습니다.
Start()
는 던지지 않지만 스레드 델리게이트는 실행하지 않습니다.
Join
,
Priority
(설정),
DisableComObjectEagerCleanup
는 실패합니다.
Thread.MemoryBarrier부분적으로 지원됨메서드는 관리되는 코드에서 효과 없이 실행되지만, Burst 컴파일 작업 내에서 실제 하드웨어 시맨틱을 제공합니다.
ThreadPool지원되지 않습니다.
QueueUserWorkItem
및
UnsafeQueueUserWorkItem
는 호출을 수신하지만 콜백은 실행되지 않습니다.
Timer지원되지 않습니다.
ThreadPool
에 의존하기 때문에 작동하지 않습니다.
휘발성부분적으로 지원됨메서드는 관리되는 코드에서 효과 없이 실행되지만, Burst 컴파일 작업 내에서 실제 하드웨어 시맨틱을 제공합니다.

System.Threading.Tasks

System.Threading.Tasks
네임스페이스 함수의 다음 유형 및 메서드가 올바르게 나타납니다.
  • ValueTask
  • ValueTask<T>
  • TaskCompletionSource<T>
  • Task.FromResult
    및
    Task.CompletedTask
    와 같은 동기 공장 방법
ThreadPool
를 통해 작동하는 모든 API는 복구할 수 없는 브라우저 중단을 일으킵니다. 비동기 프로그래밍에는
Task
보다 메모리 오버헤드가 적기 때문에
Awaitable
를 사용하십시오.
다음 표에는 제한이 있는 API가 나열되어 있습니다.

클래스

상태

참고 사항

병렬지원되지 않습니다.모든 메서드(
For
,
ForEach
,
Invoke
)는 복구할 수 없는 브라우저 중단을 일으킵니다.
작업 지연지원되지 않습니다.복구할 수 없는 브라우저 중단이 발생합니다. 내부 타이머가 작동하지 않습니다.
Task.Run지원되지 않습니다.복구할 수 없는 브라우저 중단이 발생합니다. 일정은
ThreadPool
를 통해 작동합니다.
TaskFactory / TaskFactory<T>지원되지 않습니다.
StartNew
,
ContinueWhenAll
및
ContinueWhenAny
모두 복구 할 수없는 브라우저 중단을 일으킵니다.

System.Timers

Elapsed
이벤트가 작동하지 않는 스레드 풀 메커니즘에 의존하므로
System.Timers.Timer
는 웹 플랫폼에서 작동하지 않습니다.

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소켓

브라우저 샌드박스가 POSIX 소켓 노출하지 않습니다.
LingerOption
및
SocketException
와 같은 순수 데이터 유형만 작동합니다.
또는 JavaScript 플러그인을 통해 브라우저의 WebSocket 또는 WebRTC API를 사용하십시오. 다른 옵션은 WebSocket 기반 Relay 서버를 통해 소켓 작업을 프록시하여 비웹 클라이언트 또는 서버의 실제 소켓 포트에 연결하는 Emscripten POSIX 소켓 구현입니다.

System.Net.WebSockets

ClientWebSocket
가 지원되지 않습니다. JavaScript 플러그인 또는 타사 플러그인을 통해 브라우저의 WebSocket API를 직접 사용하십시오.

추가 리소스