커스텀 초대 인터페이스 를 이용하려면 SDK 버전 1.14.1 이상을 사용해야 합니다.
커스텀 초대(Custom Invites) 인터페이스는 게임 타이틀에 기본으로 제공되는 에픽 온라인 서비스(Epic Online Service, EOS) 연결(Connect) 메시징을 사용하여 임의의 페이로드와 함께 초대를 송수신하도록 고안되었습니다. 이는 타이틀에 이미 강력한 초대 시스템이 있지만 에픽 계정 서비스(EAS) 소셜 오버레이 UI 를 통해 초대 송수신을 통합하려는 경우 유일하게 실행 가능한 초대 인터페이스로 간주해야 합니다.
에픽게임즈 스토어(Epic Games Store) 와 에픽게임즈 런처(Epic Games Launcher), 소셜 오버레이(Social Overlay) 의 목적을 위해 커스텀 초대(Custom Invites) 는 세션(Session) 및 로비(Lobby) 초대와 똑같이 전송되고 전달됩니다. 스토어나 런처에서 커스텀 초대를 수신하면, 전송자(Sender)와 게임을 나타내는 UI가 사용자에게 표시됩니다. 플레이어가 초대를 수락하면 그와 연관된 제품이나 게임이 시작됩니다.
커스텀 초대 전송하기
커스텀 초대 페이로드 준비하기
커스텀 초대 페이로드는 FString이며, EOS_CUSTOMINVITES_MAX_PAYLOAD_LENGTH
문자(현재 500자) 이하여야 합니다. 그 콘텐츠는 SDK에 불투명하게 인식되며 있는 그대로 수신 사용자에게 전달됩니다.
커스텀 초대 페이로드 설정하기
커스텀 초대를 전송하거나 로컬 플레이어가 소셜 오버레이를 사용하여 커스텀 초대를 전송하려면 그 전에 먼저 EOS_CustomInvites_SetCustomInvite
를 사용하여 커스텀 초대 페이로드를 설정합니다. EOS_CustomInvites_SendCustomInvite
에 대한 모든 호출 및 플레이어가 오버레이의 ‘INVITE ’ 버튼으로 개시한 모든 초대는 이 페이로드를 사용합니다.
EOSSDK를 통해 커스텀 초대 전송하기
페이로드를 설정하고 나면 EOS_CustomInvites_SendCustomInvite
를 사용하여 지정된 사용자나 사용자 그룹에 초대를 전송할 수 있습니다.
소셜 오버레이를 통해 커스텀 초대 전송하기
커스텀 초대 페이로드가 EOS_CustomInvites_SetCustomInvite
를 통해 설정될 때마다, 소셜 오버레이를 사용하는 로컬 플레이어는 ‘초대’ 버튼을 사용하여 친구에게 현재 설정된 커스텀 초대 페이로드와 함께 초대를 전송할 수 있습니다.
소셜 패널에 관한 자세한 내용은 소셜 오버레이 및 SDK 통합 문서를 참고하세요.
커스텀 초대 처리하기
참고: EOS 오버레이는 에픽게임즈 런처를 통해 설치됩니다. 또한 게임 애플리케이션은 EOS 서비스 재배포 가능 인스톨러를 사용하여 EOS 오버레이를 필수 구성 요소의 일부로 설치할 수도 있습니다. 소셜 오버레이의 커스텀 초대에 관한 자세한 내용은 소셜 오버레이 및 SDK 통합 문서를 참고하세요.
콜백 - 커스텀 초대 수신하기
EOS_CustomInvites_AddNotifyCustomInviteReceived
및 EOS_CustomInvites_RemoveNotifyCustomInviteReceived
함수를 사용하여 자체적인 탐지, 커스텀 UI 표시, 커스텀 초대 처리 작업을 수행할 수 있습니다. 이러한 함수는 로그인 전에 호출해야 합니다. 왜냐하면 로그인과 초기화 작업이 보류 중인 커스텀 초대를 발견해서 즉각적인 알림을 생성할 수 있기 때문입니다.
커스텀 초대가 처리되면(사용자가 수락 또는 거부),
EOS_CustomInvites_FinalizeInvite
를 호출하여 내부 SDK와 소셜 오버레이의 인식에서 벗어나게 모두 제거해야 합니다.
정책 구성
클라이언트 정책 권한을 구성해야 userRequired로 알림 서비스를 활성화하고 다음을 허용하는 커스텀 정책을 사용할 수 있습니다.
sendCustomInviteToAnyUser
: 사용자가 다른 사용자에게 커스텀 초대를 전송할 수 있습니다.