보안 문제 때문에, JavaScript 코드는 네트워크 연결을 구현하기 위해 IP 소켓에 직접 액세스할 수 없습니다. 그 결과, .NET 네트워킹 클래스(특히, System.Net.Sockets 등 System.Net 네임스페이스에 있는 모든 것)는 WebGL에서 작동하지 않습니다. 동일한 사항이 Unity의 이전 UnityEngine.Network* 클래스에도 적용되며, WebGL 빌드 시 사용할 수 없습니다.
WebGL에서 네트워킹을 사용해야 하는 경우, 현재 Unity 버전에서 WWW 또는 UnityWebRequest 클래스나 WebGL을 지원하는 새로운 Unity 네트워킹 기능을 사용해야 합니다. JavaScript에서 WebSockets 또는 WebRTC을 사용하여 자체 네트워킹을 구현하는 옵션 중에서도 선택할 수 있습니다.
The WWW and UnityWebRequest classes are supported in WebGL. They are implemented using the XMLHttpRequest class in JavaScript, using the browser to handle WWW requests. This imposes some security restrictions on accessing cross-domain resources. Basically any WWW request to a server which is different from the server hosting the WebGL content needs to be authorized by the server you are trying to access. To access cross-domain WWW resources in WebGL, the server you are trying to access needs to authorize this using CORS.
WWW 또는 UnityWebReqest를 사용하여 콘텐츠에 액세스하려고 하는 경우 원격 서버에 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.
CORS는 Cross-Origin Resource Sharing의 약자입니다. 설명은 여기를 참조하십시오. 기본적으로 서버는 발송하는 http 리스폰스에 웹 페이지에서 서버의 콘텐츠에 액세스할 수 있게 허용해도 됨을 브라우저에 알리는 Access-Control 헤더를 몇 개 추가해야 합니다. 다음은 헤더 설정의 예로, 이 설정을 통해 Unity WebGL에서 공통 요청 헤더로 http 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": "*",
WWW.responseHeader는 CORS 사양의 7.1.1에 따라 실제 리스폰스 헤더의 서브셋으로 제한됩니다.
또한 XMLHttpRequest는 데이터 스트리밍을 허용하지 않으므로 WebGL에서 WWW 클래스는 다운로드가 완료된 후에만 데이터를 처리합니다. 따라서 다른 플랫폼처럼 다운로드 중에 AssestBundle의 압축을 풀고 로드할 수 없습니다.
Unity 네트워킹은 웹소켓 프로토콜을 통해 커뮤니케이션을 활성화하여 WebGL을 지원합니다. Networking.NetworkManager.useWebSockets 를 참조하십시오.
위에서 설명한 바와 같이, WebGL에서는 IP 소켓에 직접 접근할 수 없습니다. 하지만 WWW 클래스가 지원하는 네트워킹 성능 이상이 필요한 경우 브라우저가 지원하는 네트워킹 프로토콜인 Web Sockets나 WebRTC를 사용할 수 있습니다. Web Sockets는 호환성이 좋지만 WebRTC는 브라우저와 신뢰 불가능한 연결 간 P2P 연결을 할 수 있도록 지원합니다. 이 두 가지 프로토콜은 아직 Unity의 빌트인 API를 통해 노출되지 않지만, JavaScript 플러그인을 사용하여 구현할 수 있습니다. Unity WebGL에서 WebSocket 네트워킹을 구현하는 플러그인 샘플은 에셋 스토어에서 확인할 수 있습니다.