콘텐츠로 이동

플러그인 연동하기

SDK의 리모트 플레이 플러그인을 연동하기 위해 플러그인 임포트 및 기본 기능을 적용하는 방법을 설명합니다.

사전 조건

리모트 플레이 플러그인 연동에 필요한 게임 개발 환경은 아래와 같습니다.

1. 플러그인 다운로드 및 임포트

릴리스 노트 > 플러그인에서 리모트 플레이 플러그인 최신 버전을 다운로드합니다.

Unity

다운로드한 플러그인 하위에 있는 RemotePlay.unitypackage를 Unity 프로젝트로 불러옵니다.

Unreal Engine

다운로드한 플러그인을 Unreal Engine <프로젝트_루트>/Plugins/에 추가하세요.

2. 리모트 플레이 기본 기능 적용

리모트 플레이 플러그인 연동 시, 아래와 같은 리모트 플레이의 기본 기능을 적용할 수 있습니다.

  • 이벤트 수신을 위한 콜백 함수 등록: 리모트 플레이에서 상태 이벤트 혹은 채팅 이벤트가 발생했을 때, 호스트 PC 게임에서 해당 이벤트를 수신하도록 SDK에 콜백 함수를 등록합니다.
  • 블라인드 이미지 변경: 타 디바이스에서 리모트 플레이 실행 중에 호스트 PC 화면에 리모트 플레이 실행 장면이 노출되는 것을 방지하도록 리모트 플레이 플러그인에서는 호스트 PC 화면을 블라인드 처리하는 이미지를 기본으로 제공합니다. 기본 블라인드 이미지는 고객사의 필요에 따라 다른 이미지 파일로 변경 가능합니다. 단, 변경할 이미지는 정사각 사이즈의 PNG 파일이여야 합니다.
  • 잠금화면 입력 콜백 활성화: EnableControlEventCallback(true) API 호출로 잠금화면 내에서도 게임을 정상적으로 플레이할 수 있도록 입력 콜백 모드를 활성화합니다. 활성화 시 키보드, 마우스, 터치, 조이스틱, 휠, 줌 등 모든 입력 이벤트가 게임 콜백으로 직접 전달되어 OS 잠금 상태와 무관하게 일관되게 동작합니다.