모든 EOS SDK 출시 버전의 에픽 온라인 서비스(Epic Online Services, EOS) 변경 사항을 개괄적으로 설명합니다.

변경 사항에 대한 상세 정보는 다음 위치의 출시 노트를 참조하세요.

• 출시 노트 문서.
• 개발자 포털(dev.epicgames.com/portal). 개발자 포털에서 출시 노트를 찾으려면 다음 단계를 따르세요.
  1. 왼쪽 탐색에서 제품 이름 중 하나를 선택하고 제품 세팅(Product Settings) 을 선택합니다.
  2. 제품 세팅 페이지에서 출시 노트 보기(View Release Notes) 를 선택합니다.

이 출시에는 다양한 인터페이스 개선 사항과 추가 게임 콘솔 지원이 포함됩니다.

Ecom 인터페이스에 새 EOS SDK API를 추가했습니다. EOS_Ecom_QueryEntitlementToken. 이는 게임에서 소모성 아이템의 토큰 기반 검증을 지원합니다. 아이템의 지속성이 제한적인 경우 플레이어가 게임에서 아이템을 사용할 때마다 '사용 횟수'를 줄입니다. 이 새 API를 사용하여 게임의 클라이언트 코드에서 JWT를 생성하고 서버 측 검증 서비스를 사용하는 경우 그쪽으로 전달합니다.

자세한 내용은 다음을 참조하세요.

• 에픽게임즈 스토어 문서 Ecom 퀵스타트 가이드의 토큰 기반 검증.
• 에픽게임즈 스토어 문서의 Ecom 인터페이스.
• EOS 웹 API 레퍼런스에 있는 Ecom 문서의 토큰 검증 권한 부여 섹션.
  여기에는 이 데이터를 자체 서비스나 서드 파티 검증 서비스(Third-party Verification, TPV)에 관계없이 선택한 검증 서비스로 전달하는 방법이 나와 있습니다.

다음 플레이어 제한이 올바르게 적용되도록 로비 및 세션 내 버그를 수정했습니다.

• 플레이어당 동시 로비 최대 16개
• 플레이어당 동시 세션 최대 16개

usrsctp 대신 dcSCTP 스트림 제어 전송 프로토콜(Stream Control Transmission Protocol, SCTP) 라이브러리 구현을 사용하여 좋지 않은 네트워크 상태에서 보안과 반응성을 개선했습니다.

참고: 이 변경 사항은 이전 버전과 호환되지만, 보안 및 퍼포먼스를 고려하여 최신 SDK 버전으로 최대한 빨리 업그레이드하는 것이 좋습니다.

• Sony PlayStation 4 SDK 10.008.001 버전 지원이 추가됐습니다.
• Sony PlayStation 5 SDK 6.00.00.38 버전 지원이 추가됐습니다.
• PlayStation 5에서 플레이어가 보이스 채팅이 활성화된 로비에 참가하거나 로비를 떠날 때 발생하는 충돌을 수정했습니다.

• Microsoft Xbox GDK 220602 (June 2022 QFE2) 버전 지원이 추가됐습니다.

EOS_AntiCheatServer_RegisterClientOptions 의 The AccountId 파라미터가 지원 중단됐습니다. 이를 대체할 새 EOS_ProductUserId UserId 파라미터를 도입했습니다. 참고: 게임 서버가 게임 클라이언트로부터 아직 EOS_ProductUserId 를 안전하게 수신하지 않은 경우 EOS 게임 서비스의 연결 인터페이스 EOS Connect ID Tokens 를 사용하여 EOS_ProductUserId 를 구할 것을 권장합니다.

표준 EOS SDK 명명 규칙(EOS_<system_type>_<function_name>_API_LATEST)과 일치하도록 플레이어 데이터 스토리지 인터페이스 및 타이틀 스토리지 인터페이스의 매크로에서 스트링 옵션 을 제거했습니다. 참고: 지원 중단된 매크로는 이전 버전과의 호환을 위해 여전히 남아 있지만 이후 버전에서 제거될 것입니다. 이전 명명 규칙을 사용하는 지원 중단된 매크로를 새 명명 규칙을 사용하는 매크로로 대체할 것을 권장합니다.

이제 Android용 EOS SDK에는 두 가지 유형이 있습니다.

• 신규: libc++_static.a 에 링크되는 스태틱 SDK.
• 기존: libc++_shared.so 에 링크되는 다이내믹 SDK.

Android에 스태틱 SDK 또는 다이내믹 SDK를 사용할 수 있습니다.

1.15.2 출시(및 1.15.2.1 업데이트)는 Apple Silicon 지원, 안티 치트 및 ecom 업데이트, 콘솔용 EOS SDK(Microsoft Xbox용 EOS SDK, Nintendo Switch용 EOS SDK) 업데이트, 여러 버그 수정을 포함합니다.

신규 기능

• 이제 SDK는 범용 dylib을 가진 Mac의 Apple silicon을 지원합니다.
  • 참고: 현재 이지 안티 치트는 Apple silicon을 지원하지 않습니다.
• SDK 1.15.2부터 EOS SDK는 콘솔 플랫폼 SDK(예: Microsoft의 Xbox SDK, Sony의 PlayStation SDK, Nintendo의 Switch SDK)에서 출시 버전이 두 가지로 고정됩니다. 두 가지 콘솔 플랫폼 버전은 다음과 같습니다.
  • 콘솔 플랫폼 SDK의 최신 출시 버전
  • 콘솔 플랫폼 SDK의 이전 출시 버전

안티 치트 업데이트

하나의 신규 안티 치트 기능이 있습니다.

• 이제 anticheat_integritytool.cfg 구성 파일에서 플레이어의 머신에 허용되는 활성 게임 인스턴스의 최대 개수와 같은 게임 클라이언트 세팅을 설정할 수 있습니다.

다음 3가지 개선 사항이 있습니다.

• 안티 치트 부트스트래퍼가 더 이상 리소스를 플레이어 머신의 하드 디스크로 캐싱하지 않습니다.
• 이제 Windows에서 안티 치트 부트스트래퍼는 작업 표시줄에 게임 실행파일 아이콘을 표시합니다. ~/<game root>/EasyAntiCheat 디렉터리에 커스텀 아이콘을 추가하면 디폴트 아이콘을 덮어씁니다.
• 이제 안티 치트 무결성 툴(Anti-Cheat Integrity Tool)에 더 많은 사용 샘플이 있습니다. anticheat_integritytool.exe --help 를 실행하면 볼 수 있습니다.

Ecom 업데이트

• EOS_Ecom_CatalogOffer 에 신규 필드 ReleaseDate 및 EffectiveDate 2개를 추가했으며 오퍼가 구매 가능해지면 플레이어에게 안내하는 데 사용할 수 있습니다.
• Ecom 인터페이스에 신규 API 2개를 소개했습니다.
  • EOS_Ecom_GetLastRedeemedEntitlementsCount 는 가장 최근의 EOS_Ecom_RedeemEntitlements 호출 중에 등록된 권한의 개수를 가져옵니다.
  • EOS_Ecom_CopyLastRedeemedEntitlementByIndex 는 특정 인덱스가 등록한 권한 ID를 가져옵니다.

지원 중단 안내

• EOS_Ecom_CatalogOffer 의 PurchasedCount 필드를 지원 중단했으며, 이제 항상 0을 반환합니다. 지금부터 사용을 중단하시기 바랍니다.
  • SDK의 예전 버전에서 오퍼에 PurchaseLimit 을 구성하지 않으면 PurchasedCount 가 0으로 설정되었습니다. 이 행동은 보장되지 않으므로 앞으로 이 필드 사용을 중단하시고 최신 SDK로 업그레이드하시는 것을 권장합니다.

SDK 1.15.2 및 SDK 1.15.2.1 업데이트

이 SDK 버전은 몇 가지 주목할 만한 업데이트와 버그 수정이 포함되어 있습니다. 전체 목록은 개발자 포털의 SDK 변경 로그에서 확인하세요. 주요 내용은 다음과 같습니다.

• 콘솔 플랫폼
  • 이제 EOS_Platform_Create 는 SDK 1.15 이전 버전의 헤더 파일을 올바르게 감지하고 모든 플랫폼에서 디폴트 NetworkStatus 를 EOS_NS_Online 으로 설정합니다. 이는 콘솔에서 하위 호환 문제를 해결합니다.
• Sony PlayStation
  • PS4 SDK 9.008.001 및 PS5 SDK 4.000.00.31에 대한 버전 지원이 추가되었습니다.
• Nintendo Switch
  • Nintendo Switch SDK 14.3.0에 대한 버전 지원이 추가되었으며 Nintendo Switch SDK 13.3.2에 대한 지원이 유지되었습니다.
• Microsoft Xbox
  • Xbox GDK 220301에 대한 버전 지원이 추가되었으며 Xbox GDK 211001에 대한 지원이 유지되었습니다.
• Apple macOS
  • Dev Auth Tool 및 안티 치트 부트스트래퍼가 열리지 않는 문제가 수정되었습니다.
• 샘플
  • 이제 iOS 및 Android 샘플에는 SDK 1.15에 도입된 SDK 정지/다시 시작 및 네트워크 연결/연결 끊기 API의 사용 예시가 포함되어 있습니다.
• 오버레이
  • 게임에서 에픽 온라인 서비스 오버레이를 비활성화하거나 설치되어 있지 않은 경우, 인증 인터페이스가 인증 시 시스템 브라우저를 사용하여 플레이어가 로그인할 수 있도록 합니다.

EOS_Auth_Login 사용에 EOS_ECT_STEAM_APP_TICKET 을 지원 중단했으며 EOS_ECT_STEAM_SESSION_TICKET 으로 대체했습니다.

이 출시에는 새로운 크로스 플레이 기능, 안티 치트 업데이트, 콘솔 버전 SDK 업데이트(Sony PlayStation, Microsoft Xbox, Nintendo Switch), 새로운 음성 볼륨 컨트롤 API, 다양한 버그 수정이 포함됩니다. 또한 이러한 새로운 기능 및 업데이트를 활성화하는 데 필요한 큰 변경사항도 몇 가지 포함됩니다.

크로스 플레이

이제 SDK는 PC에서 끊김 없는 크로스 플레이를 제공합니다. 크로스 플레이를 사용하면 Steam과 에픽게임즈 스토어의 플레이어와 매치메이킹 풀을 통일할 수 있습니다.

주요 기능은 다음과 같습니다.

• 새로운 친구 인터페이스(Friends Interface) API를 사용하면 플레이어가 직접 친구를 초대하고 더욱 원활하게 연결하여 함께 플레이할 수 있습니다.
• Steam 플레이어는 이메일이나 비밀번호를 사용하지 않아도 게임에 참가할 수 있습니다. SDK 및 EOS 백엔드 서비스에서 내부적으로 에픽게임즈 계정을 생성하고 사용자의 Steam 계정에 연동해 줍니다.
• Steam 친구와 에픽게임즈 스토어 친구가 Steam의 에픽 소셜 오버레이(Epic Social Overlay)에 나란히 표시되므로 플레이어가 하나의 목록에서 모든 친구를 볼 수 있습니다.
• 인게임 오버레이에서 에픽 계정 서비스 인증과 계정 연결을 처리하므로 플레이어는 외부 브라우저로 리디렉션되지 않고 게임을 계속할 수 있습니다.
• 자동 업데이트되는 새로운 재배포 가능 구성 요소를 사용하여 빌드를 변경할 필요 없이 플레이어에게 에픽 소셜 오버레이의 새로운 기능과 개선 사항을 제공할 수 있습니다.

크로스 플레이는 새로운 인터페이스나 새로운 오버레이가 아닙니다. 기존 기능에 크로스 플레이를 구현했습니다. 자세한 정보는 플랫폼 간 크로스 플레이 문서를 참조하세요.

안티 치트 업데이트

다음 3가지 안티 치트 기능이 새로 생겼습니다.

• 안티 치트 P2P 모드에서 PC와 콘솔 사용자 간의 크로스 플랫폼 플레이를 지원합니다.
• 이제 구성 파일에서 플레이어의 머신에 허용되는 활성 게임 인스턴스의 최대 개수와 같은 게임 클라이언트 세팅을 설정할 수 있습니다.
• 클라이언트 측 EOS_AntiCheatClient_PollStatus 를 EOS_AntiCheatClient_AddNotifyClientIntegrityViolated 를 통해 액세스할 수 있는 콜백 함수로 교체했습니다.

다음 3가지 개선 사항이 있습니다.

• 오류 로깅 기능 개선.
• 안티 치트 부트스트래퍼(Anti-Cheat Bootstrapper): 이제 바이너리(실행 파일)가 번들에 들어갔습니다. 더 이상 리소스를 플레이어 머신의 하드 디스크로 캐시하지 않으며, Windows에서는 게임 실행 파일 아이콘을 작업 표시줄에 표시합니다.
• 이제 안티 치트 무결성 툴(Anti-Cheat Integrity Tool)에 더 많은 사용 샘플이 있습니다.

EOS_AntiCheatClient_RegisterPeerOptions AccountID 의 지원을 중단하고 PeerProductUserId 로 대체했습니다.

플레이어가 부정행위로 탐지를 회피할 수 있는 문제를 해결하는 등 총 6가지 버그를 수정했습니다.

큰 변경사항

• 코어

  • 기존 기능에 영향을 주는 변경 사항: 이제 모든 게임은 EOS_Platform_SetApplicationStatus 및 EOS_Platform_SetNetworkStatus 를 호출해야 합니다. 플랫폼 인터페이스에 해당 API를 추가했습니다. 이 API들은 게임이 정지되었다가 다시 시작될 때와 로컬 시스템의 네트워크 연결 상태가 변경될 때 SDK에 알리는 API입니다. 두 가지 관련된 API를 사용하여 이러한 상태를 확인할 수 있으며, 이는 선택 사항입니다.

• 인증

  • 기존 기능에 영향을 주는 변경 사항: 이제 Windows에서 EOS_LCT_AccountPortal 및 EOS_LCT_ExternalAuth 로그인 타입을 사용하려면 EOS 재배포 가능 구성 요소가 설치되어 있어야 하고 EOS 부트스트래퍼로 게임을 실행해야 합니다.
    • 자세한 정보는 재배포 가능 인스톨러 문서를 참조하세요.

• C# SDK

  • 기존 기능에 영향을 주는 변경 사항: 대부분의 레퍼런스 타입(클래스)을 값 타입(구조체)으로 변경하여 퍼포먼스를 크게 개선했습니다. 이제 API 호출에서 옵션 구조체를 전달하고 콜백에서 정보 구조체를 사용할 때는 ref 키워드를 사용해야 합니다.

SDK 1.15 업데이트

이 SDK 버전은 몇 가지 주목할 만한 업데이트와 버그 수정이 포함되어 있습니다. 전체 목록은 개발자 포털(Developer Portal)의 SDK 변경 로그(SDK Changelog)에서 확인하세요. 주요 내용은 다음과 같습니다.

• 콘솔별

  • Sony PlayStation 4 지원: 9.508.001로 업데이트
  • Sony PlayStation 5 지원: 5.00으로 업데이트
  • Nintendo Switch 지원: 13.3.2로 업데이트
  • Microsoft Xbox GDK 지원: 211001(2021년 10월 QFE1)로 업데이트

• 코어

  • EOS_GetVersion 이 반환하는 SDK 빌드 버전 스트링에 관련 플랫폼이 포함되도록 업데이트했습니다.

• 음성

  • 기존 볼륨 컨트롤을 확장 (및 대체)하는 오디오 볼륨 컨트롤 API EOS_RTCAudio_UpdateParticipantVolume 를 추가했습니다.

• 개발자 인증 툴

  • 이제 툴은 제공된 포트와 크리덴셜을 유지하며, 오랫동안 실행되면 크리덴셜을 새로고침합니다.

• 소셜 오버레이

  • 이제 소셜 오버레이(Social Overlay)에서 플레이어의 에픽 친구를 '모두' 보여줍니다. 플레이어가 현재 플레이하고 있는 게임을 플레이한 적 없는 에픽 친구도 표시됩니다.

알려진 문제

• 코어
  • 현재 iOS 및 Android 샘플에는 새로운 정지/다시 시작 및 네트워크 연결/연결 해제 API의 예시가 업데이트되지 않았습니다.

신규

안티 치트의 효율성을 높였으며 이지 안티 치트 부트스트래퍼(Easy Anti-Cheat Bootstrapper)도 업데이트했습니다.

또한, 이제 제재를 적용할 수 있는 세션을 생성할 수 있습니다. 제재를 받은 플레이어는 제재를 활성화한 후 생성된 세션에 참가하거나 등록할 수 없습니다. 자세한 내용은 제재 문서를 참조하세요.

향상된 기능 및 버그 수정

이지 안티 치트

• 안정성 및 메모리 관리 효율성을 높였습니다.
• 단일 게임 서버에 너무 많은 플레이어가 접속해 있거나 백엔드 연결이 불안정한 플레이어에게 발생할 수 있는 충돌을 수정했습니다.

코어

• 스타트업 시 기록되는 에러 로그를 개선했습니다.

기타

• ID 토큰을 이용하는 연결 및 에픽 사용자 검증에 발생하는 여러 버그를 수정했습니다.
• Nintendo Switch SDK를 업데이트했습니다.

알려진 문제

• 안티 치트 부트스트래퍼에 커스텀 아이콘이 포함되어 있으면 가끔 흐리게 표시됩니다.

• 이 문제는 다음 버전에 개선될 것입니다.

커스텀 초대 커스텀 초대 인터페이스가 출시되었습니다!

커스텀 초대(Custom Invites)는 게임 타이틀에 기본으로 제공되는 에픽 온라인 서비스(Epic Online Service, EOS) 연결(Connect) 메시징을 사용하여 초대를 송수신하도록 고안되었습니다.

이 시스템은 다음과 같은 경우에 실행 가능한 것으로 간주됩니다.

• 이미 강력한 초대 시스템을 갖춘 타이틀
• 사용자가 에픽 계정 서비스 소셜 오버레이를 통해 초대를 송수신하고자 하는 타이틀

이지 안티 치트

향상된 기능 및 업데이트!

이지 안티 치트(Easy Anti-Cheat)의 최근 릴리스 이후로 안티 치트 인터페이스의 부트스트래퍼 정보를 포함했습니다.

• 부트스트래퍼 추가, 안티 치트 사용하기
  • Windows
  • Linux
  • Mac

ID 제공자

• 지원되는 사용자 인증 제공자에 Amazon이 추가되었습니다!

퍼블리싱 툴 비공개 베타

새로운 에픽게임즈 스토어 셀프 퍼블리싱 툴세트가 베타 단계에 진입했습니다! 이제 이러한 툴 덕분에 에픽게임즈 스토어에 게임을 퍼블리싱하는 프로세스를 제어할 수 있습니다. 툴의 기능과 작동 방식은 퍼블리싱 툴 - 비공개 베타 페이지를 참조하세요.

새로운 사이트맵

사용하는 서비스(개발자 포털, 에픽 계정 서비스, 에픽게임즈 스토어, 게임 서비스, API 레퍼런스)를 기반으로 콘텐츠를 체계적으로 정리할 수 있도록 전체 EOS 문서 사이트 맵을 개편했습니다. 이는 여러분의 편의를 위해 콘텐츠를 클린업한 또 다른 작은 노력의 결과로, 문서 개선 노력은 계속될 것입니다.

보이스

이번 출시의 보이스 인터페이스는 프리뷰 서비스입니다. 보이스 인터페이스를 사용하여 사용자끼리 음성 채팅을 생성하고 관리할 수 있습니다. 그리고 보이스 및 로비 통합으로 로비 인터페이스에서 방 관리와 인증을 처리할 수 있습니다.

C 및 C# 샘플 프로젝트를 꼭 확인하세요!

웹 API

인증 인터페이스와 Ecom 인터페이스용 REST API가 있지만, 웹과 백엔드 서비스의 더 일반적인 사용 사례를 지원하기 위해 웹 API를 구축하고 있습니다.

게임 클라이언트 및 서버와 상호작용할 때는 계속 EOS SDK를 사용하는 것이 좋지만, Web API 소개와 레퍼런스의 HTTP API 옵션도 확인해 보시기 바랍니다.

다크 테마

문서에서 다크 테마와 라이트 테마 간에 전환할 수 있습니다. 패널 탐색 하단의 스위치를 사용하여 테마를 변경하세요.

이지 안티 치트

이번 릴리스의 안티 치트 인터페이스는 프리뷰 서비스입니다.

이지 안티 치트 로도 알려진 안티 치트 인터페이스(Anti-Cheat Interface)를 사용하면 온라인 멀티플레이어 플레이에서의 치팅을 줄일 수 있습니다.

ID 제공자로서의 itch.io

itch.io 를 제품의 ID 제공자로 사용할 수 있습니다.

현재 지원하는 ID 제공자는 에픽 온라인 서비스가 사용자 계정들을 연동하여 다양한 플랫폼에서 사용자 데이터를 공유하고 매치메이킹과 같은 크로스 플랫폼 기능에 참여할 수 있게 해주는 플랫폼입니다. ID 제공자는 개발자 포털에서 환경설정되어야 하며 연결 인터페이스와 연동되어야 합니다.

제재 인터페이스

제재 인터페이스(Sanctions interface)를 사용하여 일시적인 차단이나 영구적인 금지와 같은 사용자 처벌 조치를 관리할 수 있습니다.

리포트 인터페이스

리포트 인터페이스(Reports interface)는 쿼리를 통해 치팅과 언어폭력, 공격적인 프로필 등 신고된 사용자 행동의 세부 사항을 확인할 수 있는 게임 내 사용자 행동 신고 내용을 저장합니다. 그런 다음, 제재 인터페이스에서 이러한 정보를 사용하여 원하는 처벌을 내릴 수 있습니다.

ID 제공자로서의 Google

Google을 제품의 ID 제공자로 사용할 수 있습니다.

현재 지원하는 ID 제공자는 에픽 온라인 서비스가 사용자 계정들을 연동하여 다양한 플랫폼에서 사용자 데이터를 공유하고 매치메이킹과 같은 크로스 플랫폼 기능에 참여할 수 있게 해주는 플랫폼입니다. ID 제공자는 개발자 포털에서 환경설정되어야 하며 연결 인터페이스와 연동되어야 합니다.

아티팩트

에픽게임즈 스토어 아티팩트를 사용하여 디플로이를 매핑하면 온라인 친구가 게임에 로그인하지 않아도 온라인 친구에게 로비 및 세션 초대를 보내는 기능을 에픽게임즈 런처에 추가할 수 있습니다. 이는 플레이어가 여러 플랫폼에서 에픽게임즈 스토어 친구 목록에 있는 다른 플레이어와 만날 수 있게 하는 또 다른 방법입니다.