PlayFab Services C/C++ SDK 릴리스 노트

이 릴리스 노트는 __PlayFabCSdk__에 대한 것입니다. 다른 PlayFab Services SDK의 릴리스 노트는 기타 Services SDK 릴리스 노트를 참조하세요.

​

2604.0.1

날짜: 2026년 9월 4일

​

호환성이 손상되는 변경 사항

• 서비스 API가 사용 중지됨에 따라 PFInventoryGetMicrosoftStoreAccessTokensAsync와 해당 결과 함수, 요청 및 응답 형식을 제거했습니다.
• 서비스 API가 사용 중지됨에 따라 PFSegmentsServerGetPlayersInSegmentAsync와 해당 결과 함수, 지원 형식을 제거했습니다.
• PFAuthenticationGetEntityRequest에서 더 이상 사용되지 않는 entity 멤버를 제거했습니다. 이제 PFAuthenticationGetEntityAsync는 호출하는 엔터티에 대한 토큰을 발급합니다.
• Client 모델과 Server 모델을 구분하기 위해 두 개의 Account Management 요청 형식 이름을 변경했습니다.
  • PFAccountManagementUnlinkAppleRequest는 이제 PFAccountManagementClientUnlinkAppleRequest입니다.
  • PFAccountManagementUnlinkGameCenterAccountRequest는 이제 PFAccountManagementClientUnlinkGameCenterAccountRequest입니다.
• 사용 중지된 E_PF_COPILOT_DISABLED, E_PF_COPILOT_INVALID_REQUEST, E_PF_GET_PLAYERS_IN_SEGMENT_DEPRECATED, E_PF_GET_PLAYERS_IN_SEGMENT_RATE_LIMIT_EXCEEDED 오류 코드를 제거했습니다.
• PFGameSaveInitOptions의 기본 형식을 uint32_t에서 uint64_t로 변경했습니다.
• PFMultiplayerServerAzureVmSize에 값을 추가했습니다. 삽입 지점 이후의 기존 값은 새로운 숫자 표현을 가지므로, 애플리케이션은 이 열거형의 숫자 값을 SDK 버전 간에 유지하거나 전송하지 않아야 합니다.

​

API 업데이트

• PFFriendsClientGetFriendsListRequest 및 PFFriendsServerGetFriendsListRequest에 선택적 namespaceWide 멤버를 추가했습니다. 이 멤버를 사용하면 현재 타이틀에 로그인한 적이 없는 같은 네임스페이스의 친구도 포함됩니다.
• 관련 Authentication, Account Management 및 사용자 정보 모델에 새 authVersion, sandboxId, psnSandboxId 멤버를 추가하여 PlayStation Network 인증 버전 및 샌드박스 지원을 추가했습니다.
• PFAccountManagementGetPlayFabIDsFromNintendoServiceAccountIdsRequest에 issuer를 추가했습니다.
• includeStatistics와 새 PFStatisticColumn, PFStatisticColumnCollection, PFStatisticColumnCollectionDictionaryEntry 형식을 통해 엔터티 프로필에 통계 데이터를 추가했습니다.
• PFStatisticsStatisticUpdate에 aggregationTargetEntityKeys를 추가하고 PFStatisticAggregationMethod 열거형을 추가했습니다.
• PFInventoryRedemptionSuccess에 expirationTimestamp를, PFMultiplayerServerRequestPartyServiceResponse에 region을 추가하고, Azure VM 크기를 추가했습니다.
• 새로운 PlayStation Network, Nintendo, Economy, Experiments, Statistics, Segments, 엔터티 멤버 자격, IP 주소 및 Game Save 조건에 대한 서비스 오류 코드를 추가했습니다.
• 이제 PFEntityRegisterTokenRefreshedEventHandler가 선택적 작업 큐를 허용합니다.
• 상호 배타적인 다른 작업이 진행 중이어서 거부된 Game Save 작업에 대한 E_PF_GAMESAVE_OPERATION_IN_PROGRESS를 추가했습니다.
• 허용되는 짧은 저장 설명의 최대 길이를 768자로 정의하는 PF_GAMESAVE_MAX_SHORT_SAVE_DESCRIPTION_LENGTH를 추가했습니다.

​

런타임 및 플랫폼 업데이트

• 내부 HTTP 작업 또는 이벤트 파이프라인 플러시가 진행 중일 때 PFUninitializeAsync가 중단되는 문제를 수정했습니다.
• 초기화 중에 추적 로그에 SDK 버전을 추가했습니다.
• PlayFab::Wrappers::Exception::what()이 메시지에 HRESULT를 포함하도록 업데이트했습니다.
• iOS 및 macOS에서 PF_API 기호를 기본 표시 유형으로 내보내고, Apple Unified SDK를 사용할 때 macOS에서 시작 시 발생하는 크래시를 수정했습니다.
• 사용자 지정 메모리 후크가 적용되도록 Clang 기반 도구 체인에서 크기가 지정된 operator delete 재정의를 수정했습니다.
• GDK 2510 레이아웃에 필요한 x64 프로젝트 플랫폼을 사용하도록 GDK 프로젝트를 업데이트하고, 프로젝트를 Visual Studio 2026 v145 도구 집합으로 대상 변경하는 기능에 대한 지원을 추가했습니다.
• minSdkVersion 21 호환성을 유지하기 위해 Android com.google.android.gms:play-services-games-v2 종속성을 버전 21.0.0으로 고정했습니다.

​

Game Save 업데이트

• PlayFab이 아닌 Blob 전송 실패가 성공으로 보고되는 문제를 수정했습니다. 이제 HTTP 실패 시, 기록되지 않은 Blob을 기준으로 매니페스트가 완료되도록 허용하는 대신 실패 HRESULT를 반환합니다.
• 오래된 확장 매니페스트 URL, 불완전한 원격 파일 집합, 다운로드 중 폴더 삭제, 누락된 localstate.json, 새 저장에 대한 마커 파일 생성과 관련된 데이터 손실 및 동기화 문제를 수정했습니다.
• 무한 재잠금 루프, 오래된 매니페스트 버전, 잘못된 기본 버전 체인, 충돌 패자 선택, 재시도할 수 없는 서비스 오류의 잘못된 처리, 디렉터리 삭제 후 불필요하게 느린 업로드 등 업로드, 잠금 및 충돌 관련 실패를 수정했습니다.
• 공유 Game Save 컨텍스트 관리에서 발생하는 GDK 메모리 손상 및 경합을 수정하고, 확장 매니페스트 경로가 저장 폴더를 벗어나지 못하도록 하는 유효성 검사를 추가했습니다.
• 동기화가 Uploading 상태로 전환될 때 저장 폴더에 대한 타이틀 쓰기 권한을 복원했습니다. 원본 파일은 PreparingForUpload 중에만 읽기 전용입니다.
• 진행률 동작을 명확히 했습니다. PFGameSaveFilesUiProgressCallback은 상태 전환을 보고하고, PFGameSaveFilesUiProgressGetProgress는 바이트 수준 진행률을 폴링하는 데 사용할 수 있습니다. 이제 합계가 0이면 합계를 알 수 없음을 의미합니다.
• GRTS 취소 및 오프라인 동작을 수정하고, Unreal Engine 등의 엔진에서 생성되는 슬래시(/) 경로를 허용하며, 여러 Windows 및 GDK 초기화, 종료, 디바이스 ID 및 저장 로드 실패를 수정했습니다.
• Game Save 원격 분석에서 Steam Deck 디바이스를 잘못 식별하는 문제를 수정했습니다.

​

2504.0.0

날짜: 2025년 4월 22일

• 보안 및 유지 관리 용이성을 향상하기 위해 JSON 구문 분석을 rapidjson에서 nlohmann::json으로 마이그레이션했습니다.
• PFCore를 초기화하면 타이틀에서 설정한 추적 콜백을 덮어쓰는 문제를 해결했습니다.
• 메모리 후크 함수를 변경하여 기본 메모리 후크를 검색하는 새 API를 추가하고, 기존 메모리 할당 함수가 메모리 형식 ID를 포함하도록 수정했습니다.
• 여러 클라이언트가 관련된 경우 추적 정리와 관련된 버그를 수정했습니다.
• PlayFab.C에서 PFAccountManagementSetDisplayNameAsync API를 사용하도록 설정했습니다.
• nlohmann JSON 라이브러리에 대한 사용자 지정 메모리 할당과 new/delete 연산자에 대한 전역 재정의를 도입했습니다.

​

2410.0.0

날짜: 2024년 10월 4일

• Microsoft GDK에서 사용할 수 있는 공개 헤더, 소스 및 라이브러리를 GitHub 릴리스에 추가했습니다.
• HTTP 라이브러리인 libHttpClient는 이제 모든 플랫폼에서 동적 라이브러리 종속성입니다. PlayFab Services가 작동하려면 이 라이브러리를 게임의 출시 패키지에 포함해야 합니다.
• Leaderboards 및 Statistics에 대한 공개 미리 보기 API를 추가했습니다.
• PFAuthenticationLoginWithFacebookRequest에 선택적 매개 변수 authenticationToken을 추가했습니다.
• 새 서비스 오류 코드에 대한 지원을 추가했습니다.
• Economy API의 사용(redeem) 응답에서 OfferId를 제거했습니다. 대신 새 필드 MarketplaceAlternateId를 추가했습니다. 호출자는 새 필드로 전환해야 하며, 서비스는 이전 버전과의 호환성을 위해 계속 두 필드를 모두 반환합니다.
• PFFriendsExternalFriendSources에서 여러 항목을 선택할 수 없는 문제를 해결했습니다.

​

2406.0.0

날짜: 2024년 7월 2일

• Linux 및 Android용 __PFEventPipelineConfig__에 선택적 gzip 압축 지원을 추가했습니다.
• __PFHttpSettings__를 사용한 자동 응답 gzip 압축(및 압축 해제) 지원을 추가했습니다.
• XCurl 추적을 기록하려고 할 때 출력 잘림을 사용하도록 설정했습니다.
• 다양한 정적 코드 분석 경고를 수정했습니다.

​

2403.0.0

날짜: 2024년 2월 28일

• Linux, Android, iOS 및 macOS를 지원하는 새 SDK 프로젝션을 릴리스했습니다. 이 릴리스에서 노출되는 새 API는 다음과 같습니다.
  • Android용:
    • LoginWithFacebook
    • ClientLinkGoogleAccount
    • ClientLinkGooglePlayGamesServicesAccount
    • ClientUnlinkGoogleAccount
    • ClientUnlinkGooglePlayGamesServicesAccount
    • ClientAndroidDevicePushNotificationRegistration
    • RedeemGooglePlayInventoryItems
  • iOS용:
    • LoginWithFacebook
    • ClientLinkApple
    • ClientUnlinkApple
    • ClientLinkGameCenterAccount
    • ClientUnlinkGameCenterAccount
    • ClientRegisterForIOSPushNotification
    • RedeemAppleAppStoreInventoryItems
• Event 파이프라인에 Event Buffering 지원을 추가했습니다.

​

2310.0.1

날짜: 2023년 9월 28일

• Win32에 PFAccountManagementServerLinkNintendoServiceAccountSubjectAsync를 추가했습니다.

​

2310.0.0

날짜: 2023년 9월 28일

• Nintendo Switch 지원을 추가했습니다(액세스를 요청하려면 보안 SDK 및 샘플에 대한 액세스 요청 - PlayFab | Microsoft Learn 참조).
• __PFEventPipelineConfig__에 선택적 gzip compressionLevel을 추가했습니다.
• __PFEvents__에서 TelemetryKey 관리 호출을 제거했습니다.
• 누락된 레거시 PFCloudScript Client 호출을 추가했습니다.
  • ClientExecuteCloudScript
  • ExecuteEntityCloudScript
• 누락된 PFAccountManagement Client 호출을 추가했습니다.
  • ClientAddOrUpdateContactEmail
  • ClientAddUsernamePassword
  • ClientGetPlayFabIDsFromFacebookIDs
  • ClientGetPlayFabIDsFromFacebookInstantGamesIds
  • ClientGetPlayFabIDsFromGameCenterIDs
  • ClientGetPlayFabIDsFromGoogleIDs
  • ClientGetPlayFabIDsFromGooglePlayGamesPlayerIDs
  • ClientGetPlayFabIDsFromKongregateIDs
  • ClientGetPlayFabIDsFromNintendoServiceAccountIds
  • ClientGetPlayFabIDsFromNintendoSwitchDeviceIds
  • ClientGetPlayFabIDsFromPSNAccountIDs
  • ClientGetPlayFabIDsFromTwitchIDs
  • ClientLinkAndroidDeviceID
  • ClientLinkApple
  • ClientLinkFacebookAccount
  • ClientLinkFacebookInstantGamesId
  • ClientLinkGameCenterAccount
  • ClientLinkGoogleAccount
  • ClientLinkGooglePlayGamesServicesAccount
  • ClientLinkIOSDeviceID
  • ClientLinkKongregate
  • ClientLinkNintendoServiceAccount
  • ClientLinkNintendoSwitchDeviceId
  • ClientLinkPSNAccount
  • ClientLinkTwitch
  • ClientRemoveContactEmail
  • ClientSendAccountRecoveryEmail
  • ClientUnlinkAndroidDeviceID
  • ClientUnlinkApple
  • ClientUnlinkFacebookAccount
  • ClientUnlinkFacebookInstantGamesId
  • ClientUnlinkGameCenterAccount
  • ClientUnlinkGoogleAccount
  • ClientUnlinkGooglePlayGamesServicesAccount
  • ClientUnlinkIOSDeviceID
  • ClientUnlinkKongregate
  • ClientUnlinkNintendoServiceAccount
  • ClientUnlinkNintendoSwitchDeviceId
  • ClientUnlinkPSNAccount
  • ClientUnlinkTwitch
  • ClientUpdateUserTitleDisplayName
• 게임 서버에서 사용하기 위한 여러 호출을 추가했습니다(Win32 전용).
  • PFAuthentication
    • ServerLoginWithServerCustomId
    • ServerLoginWithSteamId
    • ServerLoginWithXbox
    • ServerLoginWithXboxId
    • AuthenticateGameServerWithCustomId
    • Delete
    • GetEntity
    • ValidateEntityToken
  • PFAccountManagement
    • ServerBanUsers
    • ServerDeletePlayer
    • ServerGetPlayerCombinedInfo
    • ServerGetPlayerProfile
    • ServerGetPlayFabIDsFromFacebookIDs
    • ServerGetPlayFabIDsFromFacebookInstantGamesIds
    • ServerGetPlayFabIDsFromNintendoServiceAccountIds
    • ServerGetPlayFabIDsFromNintendoSwitchDeviceIds
    • ServerGetPlayFabIDsFromPSNAccountIDs
    • ServerGetPlayFabIDsFromSteamIDs
    • ServerGetPlayFabIDsFromTwitchIDs
    • ServerGetPlayFabIDsFromXboxLiveIDs
    • ServerGetServerCustomIDsFromPlayFabIDs
    • ServerGetUserAccountInfo
    • ServerGetUserBans
    • ServerLinkNintendoServiceAccount
    • ServerLinkNintendoSwitchDeviceId
    • ServerLinkPSNAccount
    • ServerLinkServerCustomId
    • ServerLinkSteamId
    • ServerLinkXboxAccount
    • ServerRevokeAllBansForUser
    • ServerRevokeBans
    • ServerSendCustomAccountRecoveryEmail
    • ServerSendEmailFromTemplate
    • ServerUnlinkNintendoServiceAccount
    • ServerUnlinkNintendoSwitchDeviceId
    • ServerUnlinkPSNAccount
    • ServerUnlinkServerCustomId
    • ServerUnlinkSteamId
    • ServerUnlinkXboxAccount
    • ServerUpdateAvatarUrl
    • ServerUpdateBans
    • GetTitlePlayersFromXboxLiveIDs
  • PFCloudScript
    • ServerExecuteCloudScript
  • PFFriends
    • ServerAddFriend
    • ServerGetFriendsList
    • ServerRemoveFriend
    • ServerSetFriendTags
  • PFInventory
    • GetTransactionHistory
  • PFLocalization
    • GetLanguageList
  • PFPlatformSpecific
    • ServerAwardSteamAchievement
  • PFPlayerDataManagement
    • ServerGetUserData
    • ServerGetUserInternalData
    • ServerGetUserPublisherData
    • ServerGetUserPublisherInternalData
    • ServerGetUserPublisherReadOnlyData
    • ServerGetUserReadOnlyData
    • ServerUpdateUserData
    • ServerUpdateUserInternalData
    • ServerUpdateUserPublisherData
    • ServerUpdateUserPublisherInternalData
    • ServerUpdateUserPublisherReadOnlyData
    • ServerUpdateUserReadOnlyData
  • PFPushNotifications
    • ServerSendPushNotification
    • ServerSendPushNotificationFromTemplate
  • PFSegments
    • ServerAddPlayerTag
    • ServerGetAllSegments
    • ServerGetPlayerSegments
    • ServerGetPlayersInSegment
    • ServerGetPlayerTags
    • ServerRemovePlayerTag
  • PFTitleDataManagement
    • ServerGetPublisherData
    • ServerGetTime
    • ServerGetTitleData
    • ServerGetTitleInternalData
    • ServerGetTitleNews
    • ServerSetPublisherData
    • ServerSetTitleData
    • ServerSetTitleInternalData

​

2306.0.0

날짜: 2023년 7월 26일

• Win32 및 GDK를 지원하는 SDK의 초기 릴리스입니다.