기술 자료

Unity 엔진

Unity 엔진

네트워킹

웹에서 네트워킹을 사용하는 방법입니다.
읽는 시간 2분최근 업데이트: 9일 전

다음과 같은 방법으로 웹에서 네트워킹을 사용할 수 있습니다.

웹에서 UnityWebRequest 클래스 사용

Unity는 웹에서 UnityWebRequest 클래스를 지원합니다. UnityWebRequest 클래스를 구현하기 위해 Unity는 브라우저를 사용하여 웹 요청을 처리하는 JavaScript Fetch API를 사용합니다. 따라서 크로스 도메인 리소스 액세스에 보안 제한이 적용됩니다.
Unity 콘텐츠를 호스팅하는 서버가 아닌 서버로 웹 요청을 보내는 경우, Unity 콘텐츠를 승인해야 합니다.
웹에서 크로스 도메인 웹 리소스에 액세스하려면 액세스하려는 서버가 크로스 도메인 웹 리소스를 승인하기 위해 CORS(크로스 원점 자원 공유)를 사용해야 합니다.
UnityWebRequest를 사용하여 콘텐츠에 액세스하려고 하면 원격 서버에 CORS가 올바르게 설정되거나 구성되지 않으면 다음과 같은 오류가 브라우저 콘솔에 나타납니다.
크로스 오리진 요청 차단: 동일한 원점 정책은 http://myserver.com/에서 원격 리소스를 읽을 수 없습니다. 리소스를 동일한 도메인으로 이동하거나 CORS를 활성화하여 이 문제를 해결할 수 있습니다.
서버는 전송하는 http 응답에 Access-Control 헤더를 추가하여 웹 브라우저에서 해당 정보를 읽을 권한이 있는 웹 페이지를 나타내야 합니다.
Unity Web이 모든 원점에서 웹 서버의 리소스에 액세스할 수 있도록 Access-Control 헤더를 추가하는 방법에 대한 설명은 다음 예제를 참조하십시오. 이 예제에는 일반적인 요청 헤더가 포함되어 있으며 GET, POST 또는 OPTIONS 메서드를 사용할 수 있습니다.
"Access-Control-Allow-Credentials": "true","Access-Control-Allow-Headers": "Accept, X-Access-Token, X-Application-Name, X-Request-Sent-Time","Access-Control-Allow-Methods": "GET, POST, OPTIONS","Access-Control-Allow-Origin": "*",

UnityWebRequest downloads

다음과 같이 UnityWebRequest 다운로드를 차단하는 코드를 사용하지 마십시오.
while(!www.isDone) {}
웹 브라우저는 네트워크 전송을 기다리기 위해 동기식으로 코드 실행을 차단할 수 없습니다. 따라서 동기식 스타일 UnityWebRequest를 수행해야 하는 경우 Coroutine과 yield 문을 사용하여 다운로드가 완료될 때까지 기다립니다. 자세한 내용은 UnityWebRequest를 사용하는 코루틴 예시를 참조하십시오.

Unity Netcode 네트워킹 패키지 사용

보안 제한으로 DUE 웹 브라우저는 TCP 또는 UDP 소켓 대한 직접 액세스를 허용하지 않습니다. 대신 Web 플랫폼을 지원하는 Unity Netcode 네트워킹 패키지를 사용할 수 있습니다. 자세한 내용은 Netcode for GameObjects 기술 자료(Unity Multiplayer Networking)를 참조하십시오.
웹 브라우저 네트워킹 표준에 대한 자세한 내용은 다음을 살펴보십시오.

웹 네트워킹의 한계

웹 플랫폼이 지원하지 않는 네트워킹 기능이 몇 개 있습니다.

.NET 네트워킹 클래스 지원 안 함

브라우저 샌드박스가 IP 소켓에 직접 액세스할 수 없기 때문에 웹 플랫폼은
System.Net.Sockets
,
System.Net.Http
및
System.Net.WebSockets
와 같은 .NET 네트워킹 I/O 클래스를 지원하지 않습니다. .NET API 제한 사항의 전체 목록은 웹 플랫폼의 .NET API 지원을 참조하십시오.

네이티브 소켓 액세스에 대한 지원 없음

웹 플랫폼은 브라우저 내부의 보안 제한으로 인해 네이티브 소켓 액세스를 지원하지 않습니다. 따라서 Web은 UnityEngine.Ping(ICMP)과 같은 기능도 지원하지 않습니다.