픽셀 스트리밍 인프라

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

이유

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

1. 픽셀 스트리밍의 출시 흐름을 개선하기 위해서입니다. 인프라가 자체 repository에 존재하므로 언리얼 엔진 업데이트의 구애를 받지 않습니다.

2. 언리얼 엔진 라이선시 및 사용자의 더욱 간편한 기여를 권장하고 지원하기 위해서입니다.

인프라 획득

픽셀 스트리밍 인프라를 확보하는 방법에는 3가지 가 있습니다. 가장 일반적으로 사용하는 다음 방법들은 대부분의 사용 사례에서 통용됩니다.

ZIP 다운로드

ZIP 포맷의 인프라를 https://github.com/EpicGamesExt/PixelStreamingInfrastructure. 필요한 인프라 브랜치로 이동하여 초록색 코드 버튼을 클릭하면 그러면 ZIP 파일을 다운로드하는 옵션이 보입니다.

Git 명령어 사용

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

선호하는 터미널에서 git clone --branch UE5.4 https://github.com/EpicGamesExt/PixelStreamingInfrastructure.git 을 사용합니다(git 설치 필요).

위의 git 명령을 사용하면 인프라의 5.1 브랜치를 가져옵니다. 다른 브랜치가 필요하다면 git 명령어를 적절히 수정하세요.

제공된 스크립트 사용

Pixel Streaming 플러그인이 활성화되어 있으면, 인프라의 필수 브랜치를 자동으로 가져오는 스크립트가 표시됩니다.

\Engine\Plugins\Media\PixelStreaming\Resources\WebServers 로 이동한 다음 get_ps_servers 명령어를 실행합니다. Windows에서는 .bat 스크립트를 사용하고, Linux 또는 Mac에서는 .sh 스크립트를 사용해야 합니다. 이렇게 하면 픽셀 스트리밍 인프라의 관련 브랜치를 폴더로 가져옵니다.

다운로드된 인프라는 픽셀 스트리밍이 활성화된 프로젝트에 자동으로 패키징되므로 이 방식을 권장합니다. 이 방법을 사용하지 않아도, 이 위치에 수동으로 인프라를 배치하면 프로젝트에서 인프라 패키지를 사용할 수 있습니다.

인프라 레이아웃

위 방법 중 하나를 사용하여 인프라를 가져오면 다음과 같은 로컬 파일 설정이 표시됩니다. GitHub에서 직접 인프라를 탐색할 수도 있습니다.

픽셀 스트리밍 컴포넌트에는 다음 위치가 있습니다.

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

   

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

   

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

   

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

   

platform_scripts 디렉터리는 각 픽셀 스트리밍 엘리먼트를 시작하는 데 사용되는 모든 스크립트의 주요 위치입니다. Windows의 경우 cmd 에서, Linux 또는 Mac의 경우 bash 에서 스크립트를 찾을 수 있습니다.

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

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

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

엔진 버전

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

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