---
title: 웹 플랫폼에서 .NET API 지원
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/platform-specific/webgl/develop/web-dotnet-api-support
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/platform-specific/webgl/develop/web-dotnet-api-support.md
last_updated: 2026-10-03
generated_at: 2026-11-19T16:43:42.403Z
locale: ko-kr
---

# 웹 플랫폼에서 .NET API 지원

> 지원되지 않는 네임스페이스 및 대안을 비롯하여 웹 플랫폼의 .NET API의 한계를 이해합니다.

웹 플랫폼은 대부분의 [.NET API를](https://learn.microsoft.com/en-us/dotnet/api/?view=netframework-4.8.1) 지원하지만 일부 API는 브라우저 보안 제한, 관리되는 스레딩의 부재 및 원시 네트워크 소켓 액세스의 부재로 인해 제한이 있습니다.

## SystemCollections.Concurrent##system.collections.concurrent

`System.Collections.Concurrent`의 모든 컨테이너는 웹 플랫폼에서 컴파일하지만 실제 스레드 보안이 부족합니다. Unity 이러한 컨테이너의 동기화 프리미티브를 빈 함수로 대체합니다. Burst 컴파일 작업의 대안으로 [Collections 패키지](https://docs.unity3d.com/Packages/com.unity.collections@6.6/manual/index.html)를 사용합니다.

## System.IO##system.io

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

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

## System.Threading##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

`System.Threading.Tasks` 네임스페이스 함수의 다음 유형 및 메서드가 올바르게 나타납니다.

* `ValueTask`
* `ValueTask<T>`
* `TaskCompletionSource<T>`
* `Task.FromResult` 및 `Task.CompletedTask`와 같은 동기 공장 방법

`ThreadPool`를 통해 작동하는 모든 API는 복구할 수 없는 브라우저 중단을 일으킵니다. 비동기 프로그래밍에는 `Task`보다 메모리 오버헤드가 적기 때문에 [`Awaitable`](/engine/6000.0/manual/scripting/optimization/async-await-support/async-awaitable-introduction.md)를 사용하십시오.

다음 표에는 제한이 있는 API가 나열되어 있습니다.

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

## System.Timers##system.timers

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

## System.Net 및 System.Net.Http##system.net-and-system.net.http

`System.Net` 및 `System.Net.Http` 네임스페이스의 다음 데이터 클래스가 올바르게 작동합니다.

* `Cookie`
* `WebHeaderCollection`
* `SocketAddress`
* `HttpRequestMessage`
* `StringContent`
* `MultipartContent`

브라우저 내에서 웹 서버를 실행할 수 없으므로 `HttpListener`가 지원되지 않습니다.

다음 클래스가 구현되지 않아 복구할 수 없는 브라우저 중단이 발생합니다.

* `HttpClient`
* `WebClient`
* `HttpWebRequest`
* `FileWebRequest`

HTTP 요청 대신 [UnityWebRequest를](https://docs.unity3d.com/ScriptReference/Networking.UnityWebRequest.html) 사용합니다.

## System.Net.Security##system.net.security

`SslStream` 및 `NegotiateStream`가 지원되지 않습니다. 구성 옵션 클래스가 작동합니다.

## System.Net소켓##system.net.sockets

브라우저 샌드박스가 POSIX 소켓 노출하지 않습니다. `LingerOption` 및 `SocketException`와 같은 순수 데이터 유형만 작동합니다.

또는 JavaScript 플러그인을 통해 브라우저의 [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) 또는 [WebRTC](https://developer.mozilla.org/en-US/docs/Web/API/WebRTC_API) API를 사용하십시오. 다른 옵션은 WebSocket 기반 Relay 서버를 통해 소켓 작업을 프록시하여 비웹 클라이언트 또는 서버의 실제 소켓 포트에 연결하는 [Emscripten POSIX 소켓 구현](https://emscripten.org/docs/porting/networking.html)입니다.

## System.Net.WebSockets##system.net.websockets

`ClientWebSocket`가 지원되지 않습니다. JavaScript 플러그인 또는 타사 플러그인을 통해 브라우저의 [WebSocket API를](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) 직접 사용하십시오.

## 추가 리소스##additional-resources

* [웹 멀티스레딩 소개](/engine/6000.0/manual/web-multithreading-intro.md)
* [UnityWebRequest](https://docs.unity3d.com/ScriptReference/Networking.UnityWebRequest.html)
* [Awaitable로 비동기 프로그래밍 소개](/engine/6000.0/manual/scripting/optimization/async-await-support/async-awaitable-introduction.md)
* [Emscripten 네트워킹](https://emscripten.org/docs/porting/networking.html)
