기술 자료

Unity 엔진

Unity 엔진

기술적 제약

웹 플랫폼의 기술적 한계를 자세히 설명합니다.
읽는 시간 4분최근 업데이트: 10일 전

웹 기술은 웹 브라우저에서 실행되도록 설계된 Unity 웹 애플리케이션에 제한을 부여합니다. 웹 플랫폼용 애플리케이션을 빌드하기 전에 다음 기술적 제한 사항을 숙지해야 합니다.

플랫폼 지원

대부분의 인기있는 데스크톱 브라우저 버전은 Unity 웹 콘텐츠를 지원하지만, 다른 브라우저는 다른 수준의 지원을 제공합니다.
웹 빌드의 다음 기능은 플랫폼 자체의 제약으로 DUE 사용할 수 없거나 제한됩니다.

Visual Studio의 웹 빌드 디버그 지원 부족

Visual Studio에서는 웹 빌드 디버깅이 지원되지 않습니다. 자세한 내용은 웹 빌드 디버깅 및 문제 해결을 참고하십시오.

Unity 캐시 및 캐싱 스크립트 지원 부족

브라우저의 파일 시스템에 대한 액세스 제한으로 인해 웹 빌드는 Unity 캐시 및 캐시 스크립팅 API를 지원하지 않습니다. 대신 에셋 데이터 및 에셋 번들에 대한 네트워크 요청은 브라우저 캐시에 캐싱됩니다. 웹의 캐시 동작을 참조하십시오.

Input System 키보드 레이아웃 매핑 부족

웹 플랫폼은 Unity의 Input System의 기능인 물리적-액티브 키보드 매핑을 지원하지 않습니다. 이 제한은 물리 키 코드를 가상 키보드 레이아웃으로 변환하는 데 의존하는 특정 InputControl 프로퍼티가 비영어 키보드에서 예상대로 작동하지 않는다는 의미입니다.

관리되는 스레딩 지원 부족

관리되는 (C#) 스레드는 WebAssembly에 멀티스레드 가비지 컬렉션 기능이 없으므로 지원되지 않습니다. 실험 단계의 플레이어 설정인 네이티브 C/C++ 멀티스레딩을 사용하여 네이티브 C/C++ 스레드 형태의 스레딩에 대한 부분 지원을 활성화할 수 있습니다. 멀티스레딩 지원을 참조하십시오.
이 제한으로 인해 C#
System.Threading
네임스페이스의 모든 것이 지원되지 않습니다. 예를 들어,
System.Threading.Timer
클래스를 사용해도 웹 빌드가 트리거되지 않습니다. 또한
System.Threading.CancellationTokenSource
에 지정된 타임아웃은 취소 메커니즘이
System.Threading.Timer
에 기반하기 때문에 실제로 타임아웃되지 않습니다.
다음은 이러한 동작 차이를 강조하는 코드입니다.
using System.Threading;using UnityEngine;public class NoMultithreadedTimers : MonoBehaviour{ private Timer t; private static void TimerCallbackElapsed(object obj) { Debug.Log("Timer Callback Fired!"); // 멀티스레드 타이머를 사용할 수 없으므로 웹 빌드에서 작동하지 않습니다. } private void Awake() { t = new Timer(new TimerCallback(TimerCallbackElapsed), this, 1, -1); }}public class NoCancellationTokenSourceTimeouts : MonoBehaviour{ private CancellationTokenSource cs; private void Awake() { cs = new CancellationTokenSource(0); // millisecondsDelay=0 to time out immediately } private void Update() { Debug.Log(cs.IsCancellationRequested.ToString()); // 시간 초과가 취소 토큰에 대해 추적되지 않기 때문에 웹 빌드에서 false를 반환합니다. }}

네트워킹 제한 사항

웹 플랫폼이 지원하지 않는 네트워킹 기능이 몇 가지 있습니다.
  • 보안 문제로 DUE 브라우저는 네트워킹을 위해 IP 소켓 대한 직접 액세스를 허용하지 않습니다. 자세한 내용은 웹 네트워킹을 참조하십시오.
  • System.Net
    네임스페이스 내 .NET 네트워킹 클래스는 지원되지 않습니다. 자세한 내용은 웹 플랫폼의 .NET API 지원을 참고하십시오.
  • 웹 플랫폼은 브라우저 내부의 보안 제한으로 인해 네이티브 소켓 액세스를 지원하지 않습니다. 따라서 웹은 ICMP ping 또는 UnityEngine.Ping과 같은 기능도 지원하지 않습니다.

.NET API 제한 사항

일부 .NET API는 주로 관리되는 스레딩 및 브라우저 네트워킹 제한 사항이 없기 DUE 웹 플랫폼에서 지원되지 않습니다. 자세한 내용은 웹 플랫폼의 .NET API 지원을 참고하십시오.

그래픽스 제한 사항

WebGL 그래픽스 API OpenGL ES 그래픽스 라이브러리의 기능에 기반하여 웹 플랫폼에 몇 가지 제한 사항이 있습니다. 자세한 내용은 웹 그래픽스를 참고하십시오.

오디오 제한 사항

웹 빌드는 웹 오디오 API를 기반으로 오디오에 대한 커스텀 백엔드를 사용하지만 기본 오디오 기능만 지원합니다. 자세한 내용은 웹 오디오를 참조하십시오.

물리 제한 사항

웹의 물리 시뮬레이션은 Unity 에디터 또는 다른 플랫폼에서와 동일한 결과를 제공할 수 없습니다. 이는 WebAssembly가 항상 완벽한 정밀도로 부동 소수점 계산을 실행하는 반면, 다른 Unity 플랫폼은 매우 작은, 거의 0의 숫자(비정규)를 0으로 플러시하는 설정(FTZ/DAZ)을 활성화하여 물리 시뮬레이션을 실행하기 때문입니다. WebAssembly 표준은 이러한 작업에 필요한 하드웨어 부동 소수점 제어 플래그에 대한 액세스를 제공하지 않습니다.
물리 시뮬레이션의 각 단계는 이전 단계의 결과를 기반으로 하므로 시간이 지남에 따라 작은 편차가 누적되어 충돌 검사와 같은 동작에 눈에 띄는 변화를 리드 수 있습니다.

동적 코드 생성

웹은 AOT 플랫폼이므로
System.Reflection.Emit
를 사용하여 동적 코드 생성을 허용하지 않습니다. 이는 다른 모든 IL2CPP 플랫폼, iOS 및 대부분의 콘솔에서 동일합니다.

멀티스레드 지원

Unity 네이티브 C/C++ 코드에 대한 멀티스레딩 지원을 제공하지만 WebAssembly의 한계로 DUE 웹 플랫폼은 아직 C# 멀티스레딩을 지원하지 않습니다. 즉, 웹 플랫폼을 사용하여 빌드된 애플리케이션은 단일 C# 스레드에서 실행되어야 합니다.
참고:
웹 플랫폼에서 복잡한 비동기 작업을 수행하는 권장 방법은 대부분의 경우
System.Threading.Tasks.Task
를 대체할 수 있는
Awaitable
를 사용하는 것입니다. 자세한 내용은 Awaitable을 사용한 비동기 프로그래밍의 소개를 참조하십시오.
비동기 워크플로에도 코루틴을 사용할 수 있습니다. 그러나
Awaitable
는 값을 직접 반환하고 오류를 자동으로 발생시키는 반면 코루틴은 두 작업 모두에 대해 추가 로직이 필요합니다.
다음 요인으로 인해 멀티스레드 지원이 제한됩니다.

네이티브 스택 스캐닝의 제약 사항

웹 플랫폼은 웹 브라우저에서 Unity 코드를 안전하고 효율적으로 실행하기 위한 바이트코드 형식인 WebAssembly를 사용합니다. 웹 브라우저는 네이티브 WebAssembly 스택에 대한 직접 액세스를 차단하는 안전하고 격리된 환경에서 코드를 실행하도록 설계되었습니다. 이는 멀티스레드 가비지 컬렉션 영향을 미칩니다. 웹 가비지 컬렉터 다른 플랫폼에서 여러 프레임에 걸쳐 증분적으로 실행되는 것과 달리 모든 프레임의 끝에 한 번만 실행되기 때문입니다.

사전 스레드 신호 지원 없음

웹의 워커는 서로 독립적으로 병렬로 코드를 실행합니다. 네이티브 플랫폼에서 메인 스레드 다른 스레드에 신호를 동기식으로 전송하여 가비지 컬렉션 일시 중지할 수 있습니다. 이 동기 신호는 웹에서 지원되지 않으므로 WebAssembly에서 컴파일된 C# 코드가 여러 스레드에서 실행되지 않습니다.

빌드 및 실행 제한 사항

Unity는 기본 기능만 있는 웹 서버를 사용하여 빌드 및 실행(메뉴: 편집 > 빌드 프로파일 > 빌드 및 실행).
서버는 데이터 캐싱을 지원하지 않으므로 다음과 같은 영향을 미칩니다.
  • 에셋 번들 또는 Adressables를 사용하지 않는 빌드의 모든 씬과 에셋을 포함하는
    .data
    파일입니다.
  • Addressables 및 AssetBundle 파일.

추가 리소스