What's New

에픽 온라인 서비스의 각 출시 버전에 포함된 개괄적인 기능과 변경 사항입니다.

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

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

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

2022

1.15.4 - 2022년 11월 16일

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

Ecom

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

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

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

로비 및 세션

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

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

P2P

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

참고: 이 변경 사항은 이전 SDK 버전과 호환되지만, 보안 및 성능을 고려하여 최신 버전으로 최대한 빨리 업그레이드하실 것을 원인 권장합니다.

SDK 1.15.4 업데이트

Sony PlayStation

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

Microsoft Xbox

  • 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 코어

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

1.15.3 - 2022년 9월 19일

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

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

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

1.15.2 및 1.15.2.1 - 2022년 8월

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

지원 중단 안내

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

SDK 1.15.2 및 SDK 1.15.2.1 업데이트

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

  • 콘솔 플랫폼
    • 이제 EOS_Platform_Create 는 SDK 1.15 이전 버전의 헤더 파일을 올바르게 감지하고 모든 플랫폼에서 기본 NetworkStatusEOS_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의 사용 예시가 포함되어 있습니다.
  • 오버레이
    • 게임에서 에픽 온라인 서비스 오버레이를 비활성화하거나 설치되어 있지 않은 경우, 인증 인터페이스가 인증 시 시스템 브라우저를 사용하여 플레이어가 로그인할 수 있도록 합니다.

1.15.1 - 2022년 7월 1일

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

1.15 - 2022년 6월 16일

이 출시에는 새로운 크로스 플레이 기능, 안티 치트 업데이트, 콘솔 버전 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_PollStatusEOS_AntiCheatClient_AddNotifyClientIntegrityViolated 를 통해 액세스할 수 있는 콜백 함수로 교체했습니다.

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

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

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

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

큰 변경사항

  • 코어

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

    • 기존 기능에 영향을 주는 변경 사항: 이제 Windows에서 EOS_LCT_AccountPortalEOS_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의 예시가 업데이트되지 않았습니다.

1.14.2 - 2022년 2월 1일

신규

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

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

향상된 기능 및 버그 수정

이지 안티 치트

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

코어

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

기타

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

알려진 문제

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

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

2021

1.14.1 - 2021년 11월 5일

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

커스텀 초대(Custom Invites)는 게임 타이틀에서 내장된 에픽 온라인 서비스(EOS) 연결(Connect) 메시징을 사용하여 초대를 송수신하도록 고안되었습니다.

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

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

이지 안티 치트

향상된 기능 및 업데이트!

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

ID 제공자

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

2021년 8월 17일

퍼블리싱 툴 비공개 베타

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

새로운 사이트맵

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

[SDK 1.11](#111---2021년 4월 7일) 출시에 있는 기능 중 소개하지 않은 기능이 하나 있습니다!

아티팩트

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

1.13 - 2021년 6월 21일

보이스

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

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

웹 API

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

게임 클라이언트 및 서버와 상호작용할 때는 여전히 EOS SDK를 사용하는 것이 좋지만, Web API 개요참조에서 HTTP API 옵션에 대해 확인해 보시기 바랍니다!

다크 테마

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

1.12 - 2021년 5월 27일

이지 안티 치트

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

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

ID 제공자로서의 itch.io

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

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

1.11 - 2021년 4월 7일

제재 인터페이스

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

리포트 인터페이스

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

ID 제공자로서의 Google

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

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

아티팩트

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