> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> PlayFab Services C/C++ SDK 릴리스 노트입니다.

이 릴리스 노트는 \_\_PlayFabCSdk\_\_에 대한 것입니다. 다른 PlayFab Services SDK의 릴리스 노트는 [기타 Services SDK 릴리스 노트](https://docs.xbox.com/ko/announcements/playfab/release-notes.md)를 참조하세요.

> [!NOTE]
>
> 서비스 릴리스 및 제품 업데이트에 대한 릴리스 노트는 [PlayFab의 공개 GitHub 리포지토리](https://github.com/PlayFab/PlayFab)의 [릴리스 노트](https://github.com/PlayFab/PlayFab/releases) 섹션을 참조하세요.

## 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의 초기 릴리스입니다.


## Related topics

- [PlayFab Services C/C++ SDK 릴리스 정보](https://docs.xbox.com/ko/services/playfab/release-notes/playfab-c/index.md)
- [PlayFab Services SDK 릴리스 노트 2026](https://docs.xbox.com/ko/announcements/playfab/release-notes.md)
- [PlayFab Services SDK 릴리스 노트 2023](https://docs.xbox.com/ko/announcements/playfab/2023.md)
- [PlayFab Services SDK 릴리스 노트 2024](https://docs.xbox.com/ko/announcements/playfab/2024.md)
- [PlayFab Services SDK 릴리스 노트 2025](https://docs.xbox.com/ko/announcements/playfab/2025.md)