Version: 2023.1
언어: 한국어
WebGL 브라우저에서 기기 기능에 액세스
WebGL의 커서 잠금 및 전체화면 모드

WebGL networking

다음 두 가지 방법으로 WebGL에서 네트워킹을 사용할 수 있습니다.

Optionally, you can use WebSockets or WebRTC from JavaScript to implement your own networking. You can’t use any .NET networking classes within the WebGL platform because JavaScript code doesn’t have direct access to internet protocol (IP) sockets to implement network connectivity. Specifically, WebGL doesn’t support any .NET classes within the System.Net namespace.

WebGL에서 UnityWebRequest 클래스 사용

Unity는 WebGL에서 UnityWebRequest 클래스를 지원합니다.UnityWebRequest 클래스를 구현하기 위해 Unity는 브라우저를 사용하여 웹 요청을 처리하는 JavaScript Fetch API를 사용합니다.이로 인해 크로스 도메인 리소스에 액세스하는 데 보안 제한이 적용됩니다.

Unity 콘텐츠를 호스팅하는 서버가 아닌 다른 서버로 웹 요청을 전송하는 경우 전송 대상 서버에서 Unity 콘텐츠를 승인해야 합니다.

WebGL에서 크로스 도메인 웹 리소스에 액세스하려면 액세스 대상 서버가 CORS(Cross-Origin Resource Sharing)를 사용하여 크로스 도메인 웹 리소스를 승인해야 합니다.

UnityWebRequest를 사용하여 콘텐츠에 액세스하려고 하는 경우 원격 서버에 CORS가 설정되어 있지 않거나 올바르게 설정되어 있지 않으면 다음과 같은 오류가 브라우저 콘솔에 표시됩니다.

Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource at http://myserver.com/. This can be fixed by moving the resource to the same domain or enabling CORS.

서버는 전송하는 http 리스폰스에 Access-Control 헤더를 추가해야 합니다. 그래야만 어느 웹 페이지가 웹 브라우저에서 해당 정보를 읽을 권한이 있는지 나타낼 수 있습니다.

For a demonstration of how to add Access-Control headers that allow Unity WebGL to access resources on a web server from any origin, refer to the following example. This example includes common request headers and allows the GET, POST or OPTIONS methods:

"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 다운로드

다음과 같이 UnityWebRequest 다운로드를 차단하는 코드는 사용하지 마십시오.

while(!www.isDone) {}

UnityWebRequest 다운로드가 완료될 때까지 기다리도록 스레드를 차단할 수 없으며, 그렇지 않으면 애플리케이션이 멈춥니다.WebGL은 단일 스레드이고 JavaScript의 fetch API는 비동기식이므로, 브라우저에 컨트롤을 반환하지 않으면 다운로드가 완료되지 않을 수 있습니다.이 경우 코루틴과 yield 문을 사용하여 다운로드가 끝날 때까지 기다리십시오.자세한 내용은 UnityWebRequest를 사용한 코루틴 예시를 참조하십시오.

Unity 멀티플레이어 사용

Unity 멀티플레이어를 사용하면 WebSocket 프로토콜을 통한 통신이 가능합니다. NetworkServer.useWebSockets를 참조하십시오.

JavaScript 에서 WebSocket 또는 WebRTC 사용

WebGL은 IP 소켓에 대한 직접 액세스를 허용하지 않지만, WebSocket 또는 WebRTC(브라우저에서 지원하는 가장 일반적인 두 가지 네트워킹 프로토콜)를 사용하여 이 문제를 해결할 수 있습니다. WebSocket은 널리 지원되는 반면, WebRTC는 브라우저와 신뢰할 수 없는 연결 간의 P2P 연결을 허용합니다. Unity에는 WebSocket 또는 WebRTC를 사용할 수 있는 빌트인 API가 없지만, JavaScript 플러그인을 사용하여 이 기능을 구현할 수 있습니다. Unity 에셋 스토어에서 WebSocket 네트워킹을 구현하는 플러그인을 찾을 수 있습니다.

WebGL 브라우저에서 기기 기능에 액세스
WebGL의 커서 잠금 및 전체화면 모드