픽셀 스트리밍 인프라

픽셀 스트리밍 인프라에는 픽셀 스트리밍 플러그인의 서버 및 프론트엔드 컴포넌트가 포함됩니다. 픽셀 스트리밍을 실행하는 데 필요한 스크립트(시그널링 서버, 매치메이커, SFU)가 여기에 해당하며, 쉽게 액세스하고 수정할 수 있도록 설계되었습니다. 또한 개발자가 수정하여 자신에게 필요한 픽셀 스트리밍 경험에 맞게 확장할 수 있는 기반도 포함되어 있습니다. 이전까지 이 스크립트는 프로젝트 및 엔진의 Samples/PixelStreaming 디렉터리에 있었습니다. 앞으로 계속해서 픽셀 스트리밍을 사용하고자 한다면 새로운 인프라를 사용하는 것을 권장합니다. 픽셀 스트리밍에 대한 모든 최신 프론트엔드 업데이트가 새로운 인프라에서 이루어질 예정이기 때문입니다.

변경 이유

픽셀 스트리밍 프론트엔드를 자체 저장소로 옮긴 데에는 여러 가지 이유가 있습니다.

1. 픽셀 스트리밍의 출시 주기를 향상하기 위해서입니다. 인프라가 자체 저장소 내에 있으면 언리얼 엔진에 대한 업데이트에 얽매이지 않습니다.

2. 언리얼 엔진 라이선시 및 사용자가 더욱 쉽게 기여할 수 있도록 장려하기 위해서입니다.

인프라 획득하기

픽셀 스트리밍 인프라를 획득하는 데는 3가지 방법 이 있습니다. 아래 메서드는 가장 흔히 사용되며, 대부분의 사용 사례에 적용할 수 있습니다.

ZIP 다운로드

ZIP 포맷의 인프라를 https://github.com/EpicGames/PixelStreamingInfrastructure에서 직접 다운로드할 수 있습니다. 필요한 인프라 브랜치로 이동하여 초록색 코드 버튼을 클릭하면 ZIP 다운로드 옵션이 보일 것입니다.

Git 명령 사용

Git을 로컬 방식으로 설치한 경우 다음 예시와 같은 명령줄을 사용하여 인프라를 획득할 수 있습니다.

선호하는 터미널의 git clone --branch UE5.1 https://github.com/EpicGames/PixelStreamingInfrastructure.git (Git 설치 필요)

위의 Git 명령은 인프라 5.1 브랜치를 가져옵니다. 다른 브랜치가 필요한 경우 그에 맞게 Git 명령을 수정하면 됩니다.

제공된 스크립트 사용

픽셀 스트리밍 플러그인을 활성화한 경우, 필요한 인프라 브랜치를 자동으로 가져오는 스크립트를 찾을 수 있습니다.

\Engine\Plugins\Media\PixelStreaming\Resources\WebServers 로 이동하여 get_ps_servers 명령을 실행합니다. Windows의 경우 .bat 스크립트를, Linux의 경우 .sh 스크립트를 사용해야 합니다. 이렇게 하면 픽셀 스트리밍 인프라의 관련 브랜치를 해당 폴더에 자동으로 가져올 수 있습니다.

이 메서드를 권장하는 이유는 다운로드된 인프라가 픽셀 스트리밍이 활성화된 프로젝트로 자동 패키징되기 때문입니다. 이 메서드를 사용하지 않더라도 위의 위치에 인프라를 직접 배치하여 프로젝트로 인프라를 패키징할 수 있습니다.

인프라 레이아웃

위의 방법 중 하나를 사용하여 인프라를 가져온 후에는 위의 예시대로 로컬 파일 구성을 마무리합니다. GitHub에서 직접 인프라를 탐색할 수도 있습니다.

픽셀 스트리밍 컴포넌트의 위치는 다음과 같습니다.

1. Frontend: 이 디렉터리에는 웹 브라우저에서 실행되고 언리얼 엔진 픽셀 스트리밍 애플리케이션과 연결 및 상호작용을 가능하게 하는 HTML, CSS, 이미지, JavaScript/TypeScript 코드가 포함되어 있습니다. 이러한 상호작용 구현 방법에 대한 문서도 포함되어 있습니다.

   

2. Matchmaker: 이 디렉터리에는 매치메이커를 환경설정하고 실행하는 데 필요한 모든 스크립트가 포함되어 있습니다.

   

3. SFU: 이 디렉터리에는 선택적 전달 유닛(Selective Forwarding Unit)을 환경설정하고 실행하는 데 필요한 모든 요소가 포함되어 있습니다.

   

4. SignallingWebServer: 시그널링 서버, 웹 서버, 프론트엔드와 같은 필수적인 픽셀 스트리밍 엘리먼트가 포함된 디렉터리입니다.

   

platform_scripts 디렉터리는 각 픽셀 스트리밍 엘리먼트를 시작하는 데 사용되는 모든 스크립트의 위치입니다. Windows의 경우 cmd , Linux의 경우 bash 스크립트를 찾으면 됩니다.

매치메이커와 선택적 전달 유닛을 사용하는 방법에 대한 자세한 정보는 호스팅과 네트워킹 가이드를 참조하세요.

기본적인 픽셀 스트리밍을 설정하는 방법에 대한 지원은 픽셀 스트리밍 시작하기를 참조하세요.

프론트엔드 커스터마이징에 대한 가이드는 Frontend/Docs/ 디렉터리를 참조하세요.

엔진 버전

엔진의 버전마다 다른 픽셀 스트리밍 인프라의 브랜치가 있습니다. 픽셀 스트리밍 플러그인은 엔진의 버전마다 차이가 있기 때문에, 호환되는 버전의 픽셀 스트리밍 인프라를 사용하는 것이 매우 중요합니다. 예를 들어 언리얼 엔진 5.0의 경우 브랜치 5.0을 사용해야 합니다. 또한 액티브 개발에 사용되는 마스터 브랜치도 사용할 수 있습니다. 마스터 브랜치에는 최신 기능이 포함될 예정이지만, 아직 실험단계로 안정성이 보장되지 않습니다.

현재 지원되는 언리얼 엔진 버전 목록은 프론트엔드 저장소의 버전 섹션을 참조하세요.