Custom Invites Interface

에픽 매치메이킹을 사용하지 않고 초대를 처리하는 인터페이스입니다.

2 분 소요

커스텀 초대 인터페이스 는 SDK 1.14.1 이상을 사용해야 합니다.

커스텀 초대 인터페이스(Custom Invites interface)는 게임 타이틀이 내장된 에픽 온라인 서비스(EOS) 연결 메시징을 사용하여 임의의 페이로드로 초대를 송수신하도록 고안되었습니다. 이는 이미 강력한 초대 시스템이 구축된 타이틀에서 사용자들이 에픽 계정 서비스(EAS) 소셜 오버레이 UI 를 통해 초대를 한 곳에서 보내고 받을 수 있기를 원하는 경우에 실행 가능한 유일한 초대 인터페이스로 간주해야 합니다.

에픽게임즈 스토어(Epic Games Store)에픽게임즈 런처(Epic Games Launcher), 소셜 오버레이(Social Overlay) 의 사용을 위해 커스텀 초대(Custom Invites)세션(Session)로비(Lobby) 초대와 똑같이 전송되고 전달됩니다. 스토어나 런처에서 커스텀 초대를 수신하면, 전송자(Sender)와 게임을 나타내는 UI가 사용자에게 표시됩니다. 플레이어가 초대를 수락하면 그와 연관된 제품이나 게임이 실행됩니다.

커스텀 초대 전송하기

커스텀 초대 페이로드 준비하기

커스텀 초대 페이로드는 EOS_CUSTOMINVITES_MAX_PAYLOAD_LENGTH 문자(현재 500자) 이하여야 하는 FString입니다. 그 콘텐츠는 SDK에 불투명하게 인식되며 있는 그대로 수신 사용자에게 전달됩니다.

커스텀 초대 페이로드 설정하기

커스텀 초대를 전송하거나 로컬 플레이어가 소셜 오버레이를 사용하여 커스텀 초대를 전송하려면 그 전에 먼저 EOS_CustomInvites_SetCustomInvite 를 사용하여 커스텀 초대 페이로드를 설정합니다. EOS_CustomInvites_SendCustomInvite 에 대한 모든 호출 및 플레이어가 오버레이의 ‘INVITE’ 버튼으로 개시한 모든 초대는 이 페이로드를 사용합니다.

EOSSDK를 통해 커스텀 초대 전송하기

페이로드를 설정하고 나면 EOS_CustomInvites_SendCustomInvite 를 사용하여 지정된 사용자나 사용자 그룹에 초대를 전송할 수 있습니다.

소셜 오버레이를 통해 커스텀 초대 전송하기

커스텀 초대 페이로드가 EOS_CustomInvites_SetCustomInvite 를 통해 설정될 때마다, 소셜 오버레이를 사용하는 로컬 플레이어는 ‘초대’ 버튼을 사용하여 친구에게 현재 설정된 커스텀 초대 페이로드와 함께 초대를 전송할 수 있습니다.

소셜 패널에 대한 추가 정보는 소셜 오버레이 및 SDK 통합 문서를 참고하세요.

커스텀 초대 처리하기

참고: EOS 오버레이는 에픽게임즈 런처로 설치됩니다. 게임 애플리케이션에서 EOS 서비스 재배포 가능 인스톨러를 사용하여 애플리케이션 필수 구성 요소의 일부로 EOS 오버레이를 설치할 수도 있습니다. 소셜 오버레이의 커스텀 초대에 대한 추가 정보는 소셜 오버레이 및 SDK 통합 문서를 참고하세요.

콜백 - 커스텀 초대 수신하기

EOS_CustomInvites_AddNotifyCustomInviteReceivedEOS_CustomInvites_RemoveNotifyCustomInviteReceived 함수를 사용하여 자체적인 탐지, 커스텀 UI 표시, 커스텀 초대 처리 작업을 수행할 수 있습니다. 이러한 함수는 로그인 전에 호출해야 합니다. 왜냐하면 로그인과 초기화 작업이 보류 중인 커스텀 초대를 발견해서 즉각적인 알림을 생성할 수 있기 때문입니다.

커스텀 초대가 처리되면(사용자가 수락 또는 거부),

EOS_CustomInvites_FinalizeInvite 를 호출하여 내부 SDK와 소셜 오버레이의 탐지에서 모두 제거해야 합니다.

정책 환경설정

클라이언트 정책 권한을 구성해야 userRequired로 알림 서비스를 활성화하고 다음을 허용하는 커스텀 정책을 사용할 수 있습니다.

  • sendCustomInviteToAnyUser: 사용자가 다른 사용자에게 커스텀 초대를 전송할 수 있습니다.