픽셀 스트리밍 인프라에는 픽셀 스트리밍 플러그인의 서버 및 프론트엔드 컴포넌트가 포함됩니다. 픽셀 스트리밍(시그널링 서버, 매치메이커, SFU)을 실행하는 데 필요한 스크립트도 포함되며, 쉽게 액세스하고 수정할 수 있도록 설계되었습니다. 이전에는 이러한 스크립트가 프로젝트 및 엔진의 Samples/PixelStreaming 디렉터리에 있었습니다. 픽셀 스트리밍에 대한 최신 프론트엔드 업데이트는 새로운 인프라에 적용되므로 앞으로도 픽셀 스트리밍을 계속 사용하려면 새로운 인프라를 사용하는 것이 좋습니다.
이유
픽셀 스트리밍 프론트엔드를 자체 repository로 이동한 이유는 다음과 같습니다.
- 픽셀 스트리밍의 출시 흐름을 개선하기 위해서입니다. 인프라가 자체 repository에 존재하므로 언리얼 엔진 업데이트의 구애를 받지 않습니다.
- 언리얼 엔진 라이선시 및 사용자의 더욱 간편한 기여를 권장하고 지원하기 위해서입니다.
인프라 획득
픽셀 스트리밍 인프라를 확보하는 방법에는 3가지 가 있습니다. 가장 일반적으로 사용하는 다음 방법들은 대부분의 사용 사례에서 통용됩니다.
Zip 파일 다운로드
인프라를 zip 형식으로 직접 다운로드하려면 https://github.com/EpicGames/PixelStreamingInfrastructure로 이동합니다. 4.27 또는 5.0 등 필요한 인프라의 브랜치로 이동한 다음 녹색 코드 버튼을 클릭하세요. 그러면 ZIP 파일을 다운로드하는 옵션이 보입니다.
Git 명령어 사용
Git을 로컬에 설치했다면 명령줄을 사용하여 인프라를 획득할 수 있습니다.
예를 들어 자주 사용하는 터미널에서 git clone --branch UE5.1 https://github.com/EpicGames/PixelStreamingInfrastructure.git 를 입력하면 됩니다. Git은 설치되어 있어야 합니다.
위의 git 명령을 사용하면 인프라의 5.1 브랜치를 가져옵니다. 다른 브랜치가 필요하다면 git 명령어를 적절히 수정하세요.
제공된 스크립트 사용
Pixel Streaming 플러그인이 활성화되어 있으면, 인프라의 필수 브랜치를 자동으로 가져오는 스크립트가 표시됩니다.
\Engine\Plugins\Media\PixelStreaming\Resources\WebServers 로 이동한 다음 get_ps_servers 명령어를 실행합니다. Windows에서는 .bat 스크립트를 사용하고, Linux에서는 .sh 스크립트를 사용해야 합니다. 이렇게 하면 픽셀 스트리밍 인프라의 관련 브랜치를 폴더로 가져옵니다.
다운로드된 인프라는 픽셀 스트리밍이 활성화된 프로젝트에 자동으로 패키징되므로 이 방식을 권장합니다. 이 방법을 사용하지 않아도, 이 위치에 수동으로 인프라를 배치하면 프로젝트에서 인프라 패키지를 사용할 수 있습니다.
인프라 레이아웃
위 방법 중 하나를 사용하여 인프라를 가져오면 다음과 같은 로컬 파일 설정이 표시됩니다. GitHub에서 직접 인프라를 탐색할 수도 있습니다.
픽셀 스트리밍 컴포넌트에는 다음 위치가 있습니다.
-
Matchmaker : 이 파일에는 매치메이커를 환경설정하고 실행하는 데 필요한 모든 스크립트가 포함됩니다.
-
SFU : 이 파일에는 SFU(Selective Forwarding Unit)를 환경설정하고 실행하는 데 필요한 모든 것이 포함됩니다.
-
SignallingWebServer : 시그널링 서버, 웹 서버, 프론트엔드 등 필수 픽셀 스트리밍 엘리먼트의 위치입니다.
platform_scripts 디렉터리는 각 픽셀 스트리밍 엘리먼트를 시작하는 데 사용되는 모든 스크립트의 주요 위치입니다. Windows의 경우 cmd 에서, Linux의 경우 bash 에서 스크립트를 찾을 수 있습니다.
매치메이커와 SFU의 사용에 관한 자세한 정보는 호스팅 및 네트워킹 가이드를 참고하세요.
기본 픽셀 스트리밍을 설정하는 방법을 자세히 알아보려면 픽셀 스트리밍 시작하기를 참고하세요.
엔진 버전
다양한 엔진 버전용으로 다양한 픽셀 스트리밍 인프라 브랜치가 있습니다. Pixel Streaming 플러그인은 엔진 버전마다 차이가 있으므로, 호환되는 버전의 픽셀 스트리밍 인프라를 사용해야 합니다. 사용 가능한 픽셀 스트리밍 인프라 버전은 4.26, 4.27, 5.0, 5.1입니다. 또한 개발이 진행 중인 마스터 브랜치도 있습니다. 여기에는 최신 기능이 있지만, 실험단계이므로 안정성이 보장되지 않습니다.
4.26과 4.27 등 구버전 픽셀 스트리밍 인프라에는 새로운 업데이트와 기능이 제공되지 않습니다. 하지만 계속 유지하고, 필요에 따라 버그 수정을 푸시할 계획입니다.