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

# PlayFab Party 릴리스 정보

> 음성 채팅 및 저지연 데이터 네트워킹을 위한 PlayFab Party SDK의 릴리스 전반에 걸친 버전 기록, 새 기능, 수정 사항 및 주요 변경 사항입니다.

<Note>
  XDK 및 Windows 7 플랫폼에 대한 지원은 2023년 8월 1일에 종료되었습니다. 해당 플랫폼에 대한 새로운 PlayFab Party 라이브러리 업데이트는 릴리스되지 않습니다. PlayFab Party 네트워킹 및 음성 서비스는 현재 PlayFab Party 라이브러리의 Windows 7 또는 XDK 버전을 사용하는 타이틀에 영향을 주지 않고 계속 작동합니다.
</Note>

<Note>
  32비트 Android 플랫폼(arm7 및 x86)에 대한 지원은 2023년 10월 19일에 종료되었습니다. 해당 플랫폼에 대한 새로운 PlayFab Party 라이브러리 업데이트는 릴리스되지 않습니다. PlayFab Party 네트워킹 및 음성 서비스는 현재 32비트 Android 플랫폼에서 PlayFab Party 라이브러리를 사용하는 타이틀에 영향을 주지 않고 계속 작동합니다.
</Note>

## 1.10.25

2026년 7월 24일

### 버그 수정

* GDK: PC에서 기본 멀티플레이어 포트 쿼리 실패에 대한 복원력이 향상되었습니다. 복구 가능한 실패는 PC에서 임시 포트 선택으로 대체됩니다. GDK PC 포트 선택에 대한 더 엄격한 제어를 원하는 타이틀은 [`PartyLocalUdpSocketBindAddressConfiguration`](/services/playfab/multiplayer/networking/reference/structs/partylocaludpsocketbindaddressconfiguration)을 사용하여 대체 포트 선택 정책을 정의할 수 있습니다.
* GDK: 예기치 않은 내부 GDK 런타임 실패의 경우 더 명확한 `PartyError` 값을 제공합니다.

## 1.10.24

2026년 7월 20일

### 버그 수정

* 타이틀이 아직 오디오 출력을 구성하지 않았을 때 오디오 조작 음성 스트림이 버퍼를 생성하지 않는 문제를 수정했습니다.
* Android: 스레드의 CPU 어피니티 설정이 실패했을 때 워커 스레드 생성 중에 발생할 수 있는 크래시를 수정했습니다.
* Apple: 앱이 오디오 포커스를 잃었다가 다시 얻은 후 마이크 및 오디오 캡처가 복구되지 않는 문제를 수정했습니다.
* Linux: 음성-텍스트 변환 및 기타 HTTP 요청이 중단되는 문제를 수정했습니다.

## 1.10.23

2026년 6월 5일

### 버그 수정

* Linux: 서버의 TLS 자격 증명을 확인하도록 HTTPS 요청을 수정했습니다.
* Android: NDK 25 이하 버전을 사용할 때 PartyCleanup 중에 발생할 수 있는 메모리 누수를 수정했습니다.
* 서버의 TLS 자격 증명을 확인하도록 Websocket 연결을 수정했습니다.

## 1.10.22

2026년 5월 15일

### 버그 수정

* Party 네트워크에 연결된 상태에서 macOS에서 오디오 디바이스 전환이 실패할 수 있는 문제를 수정했습니다.

## 1.10.21

2026년 5월 13일

* 라이브러리 빌드에 사용되는 Windows 플랫폼 도구 집합을 v142에서 v143으로 업그레이드했습니다.

### 버그 수정

* 오디오 조작이 활성화된 상태에서 네트워크 간에 전환할 때 발생할 수 있는 음성 손실을 수정했습니다.
* 오디오 조작 캡처 스트림이 활성화된 경우 최종 음성-텍스트 변환 필사가 누락되는 문제를 수정했습니다.
* Party가 종료를 완료하기 전에 프로세스 작업 큐가 삭제된 경우 종료 시 발생할 수 있는 크래시를 수정했습니다.
* Android: [`PartyManager::Cleanup`](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup) 직후에 [`PartyManager::Initialize`](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)를 호출할 때 발생할 수 있는 크래시를 수정했습니다.
* Android: [`PartyManager::Cleanup`](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup)에서 발생하는 메모리 누수를 수정했습니다.
* Apple: 이전 릴리스에서 의도치 않게 삭제되었던 macOS 유니버설 바이너리의 arm64(Apple Silicon) 지원을 복원했습니다.
* 지원 비동기 작업이 완료되기 전에 내부 HTTP 추적 개체가 삭제될 수 있는 use-after-free 문제를 수정했습니다.
* Linux: 여러 공유 개체가 동일한 종속성을 링크할 때 정적 라이브러리가 손상되어 발생할 수 있는 크래시를 방지했습니다.

## 1.10.20

2026년 4월 29일

* PlayStation®5: null JSON 값이 올바르게 전파되도록 HTTP 응답 구문 분석을 수정했습니다.

## 1.10.19

2026년 4월 22일

* Nintendo Switch 2: 더 이상 사용되지 않는 언어 코드 API를 제거하고 C++20 컴파일 문제를 해결하여 Nintendo SDK 22와의 호환성을 업데이트했습니다.

## 1.10.18

2026년 3월 26일

* PlayFab Party에 대한 Linux 링커 강화를 개선했습니다.

## 1.10.17

2026년 2월 23일

* Android: Bluetooth 마이크가 작동하지 않는 문제를 수정했습니다.
* Linux: SafeStack을 제거했습니다.
* Apple: Party에서 OpenSSL 심볼을 숨겼습니다.
* Nintendo Switch 2: IP가 변경될 때 TCP 연결 오류를 해결했습니다.

## 1.10.16

2026년 2월 2일

* GDK: 프로세스 내 GRTS를 사용하는 환경에 대한 지원을 추가했습니다.
* GDK: [`PartyAudioDeviceSelectionType::SystemDefault`](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype)에 대한 지원을 추가했습니다.

### 버그 수정

* 다중 네트워크 전환 시나리오에서 발생할 수 있는 크래시를 수정했습니다.

## 1.10.15

2025년 12월 17일

* Nintendo Switch 2: 웹 요청에 10초 시간 제한을 추가했습니다.

## 1.10.14

2025년 12월 9일

* 토큰 만료 전에 발생하는 일시적인 오류에 대해서는 `PartyServiceError`를 반환하고 토큰이 만료된 경우에만 `UserNotAuthorized`를 반환하도록 [`PartyNetwork::CreateEndpoint`](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint) PartyStatusChangeResult 동작을 변경했습니다.
* Android: 새로운 [Android 페이지 크기 요구 사항](https://developer.android.com/guide/practices/page-sizes)을 충족하기 위해 16KB 페이지 크기 지원을 추가했습니다.

## 1.10.13

2025년 10월 14일

* iOS 26에서 마이크가 제대로 작동하지 않는 문제를 수정했습니다.
* Apple: iOS에서 Arm64.xcframework 지원을 추가했습니다.

## 1.10.12

2025년 10월 6일

* 토큰 만료 전에 발생하는 일시적인 오류에 대해서는 `PartyServiceError`를 반환하고 토큰이 만료된 경우에만 `UserNotAuthorized`를 반환하도록 [`PartyNetwork::CreateEndpoint`](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint) PartyStatusChangeResult 동작을 변경했습니다.
* Android: 새로운 [Android 페이지 크기 요구 사항](https://developer.android.com/guide/practices/page-sizes)을 충족하기 위해 16KB 페이지 크기 지원을 추가했습니다.
* Apple: iOS에서 Arm64 시뮬레이터 빌드 지원을 추가했습니다.

### 버그 수정

* [PartyManager::Cleanup](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup)이 호출될 때 라이브러리가 크래시할 수 있는 문제를 수정했습니다.
* Apple: iOS에서 인터럽트 후 마이크 포커스 복구를 위한 재시도 로직을 추가했습니다.
* Apple: Party 음성 채팅 및 필사 중에 발생할 수 있는 메모리 누수를 수정했습니다.
* Apple: 여러 원격 플레이어가 서로 다른 플랫폼에 걸쳐 연결되었을 때 PartyLocalChatControl에서 발생할 수 있는 잠재적 정지 문제를 수정했습니다.
* Apple: iOS에서 Arm64 시뮬레이터 빌드 지원을 추가했습니다.

## 1.10.9

2025년 3월 11일

* Nintendo Switch: 로깅이 활성화된 라이브러리 shipping 변형의 DLL을 로드할 때 발생하는 크래시를 해결하는 버그 수정.

## 1.10.8

2025년 1월 24일

* PlayStation®4 및 PlayStation®5: PlayStation 플랫폼에서 욕설 마스킹과 관련된 크래시를 해결했습니다.

## 1.10.6

2024년 12월 10일

* PlayStation®4 및 PlayStation®5: C++14 이상 버전과의 통합을 위한 빌드 경고 및 오류를 해결했습니다.

## 1.10.5

2024년 11월 18일

* 다른 사용자가 여러 번 다시 참여했다가 나간 후에도 Party 네트워크에 남아 있었던 사용자에게 음성 채팅이 때때로 작동하지 않는 문제를 수정했습니다.
* 직접 피어 연결과 함께 사용될 때 [PartyLocalEndpoint::GetEndpointStatistics](/services/playfab/multiplayer/networking/reference/classes/PartyLocalEndpoint/methods/partylocalendpoint_getendpointstatistics)가 [PartyEndpointStatistic::CurrentlyQueuedSendMessages](/services/playfab/multiplayer/networking/reference/enums/partyendpointstatistic) 및 [PartyEndpointStatistic::CurrentlyQueuedSendMessageBytes](/services/playfab/multiplayer/networking/reference/enums/partyendpointstatistic)에 대해 잘못된 값을 보고하는 문제를 수정했습니다.
* macOS에서 프레임워크의 손상된 심볼릭 링크를 수정했습니다.
* SDK 로그 수집 중 Windows 이외의 플랫폼에 대한 로그 예외 처리를 개선했습니다.

## 1.10.4

2024년 11월 12일

* PlayStation®4 및 PlayStation®5: 생성 및 파기 중 뮤텍스 작업 및 엔드포인트 상태 변경과 관련된 크래시를 해결했습니다.

## 1.10.3

2024년 10월 14일

* 네트워크당 최대 128개의 디바이스에 대한 지원을 추가했습니다. 자세한 내용은 [확장 가능한 네트워크](/services/playfab/multiplayer/networking/party-features#scalable-networks-up-to-128-devices-per-network)를 참조하세요.
* `c_maxNetworkConfigurationMaxDeviceCount`를 32에서 128로 늘렸습니다.
* 내부 진단을 업데이트했습니다.
* 보안 강화를 위해 빌드 설정을 업데이트했습니다.
* macOS 플랫폼에서 노출된 OpenSSL 심볼과 관련된 문제를 수정했습니다.

## 1.10.2

2024년 9월 18일

### 버그 수정

* 세 개 이상의 디바이스가 있는 네트워크에서 직접 피어 연결을 설정할 때 라이브러리가 크래시할 수 있는 문제를 수정했습니다.

## 1.10.0

2024년 8월 5일

* `game_server` 엔터티에 대한 지원이 추가되어, 서버가 SDK를 통해 Party 네트워크에 연결하고 게임 클라이언트에서 안전하게 식별될 수 있습니다. `AuthenticateGameServerWithCustomId`를 통해 `game_server` 엔터티를 인증한 후, [PartyManager::CreateLocalUserWithEntityType](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype)을 통해 로컬 사용자로 추가할 수 있습니다.
* 라이브러리의 각 엔터티와 연관된 엔터티 유형을 결정하는 메서드를 추가했습니다. 자세한 내용은 [PartyLocalUser::GetEntityType](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_getentitytype), [PartyEndpoint::GetEntityType](/services/playfab/multiplayer/networking/reference/classes/PartyEndpoint/methods/partyendpoint_getentitytype), [PartyChatControl::GetEntityType](/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/methods/partychatcontrol_getentitytype)을 참조하세요.
* `title_player` 엔터티와 다른 `title_player` 엔터티 간의 직접 피어 연결을 허용하지 않으면서 `title_player` 및 `game_server` 엔터티 간의 직접 피어 연결을 활성화하는 직접 피어 연결 옵션을 추가했습니다. 자세한 내용은 [PartyDirectPeerConnectivityOptions::OnlyServers](/services/playfab/multiplayer/networking/reference/enums/partydirectpeerconnectivityoptions)를 참조하세요.
* 필터를 기반으로 엔드포인트의 편리한 목록을 검색하는 메서드를 추가했습니다. 자세한 내용은 [PartyNetwork::GetEndpointsByUserType](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_getendpointsbyusertype)을 참조하세요.
* PlayStation®4 및 PlayStation®5의 PlayFab Party에서 사용되는 타사 라이브러리에 의한 메모리 할당이 기본 할당자를 사용하고 있던 것이 Party의 메모리 콜백을 사용하도록 업데이트되었습니다. [PartyManager::SetMemoryCallbacks](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks)를 사용하여 타이틀별 메모리 할당 함수 할당을 구성하는 타이틀은 이제 이러한 할당을 확인하고 제어할 수 있습니다.

### 버그 수정

* 프로세스가 종료되는 동안 Windows 또는 XBOX에서 라이브러리가 크래시할 수 있는 문제를 수정했습니다.
* Windows가 아닌 플랫폼의 특정 경우에 이전 연결 시도가 실패한 후 발생하는 잘못된 직접 피어 연결 실패를 해결했습니다.
* 반복적인 Party 네트워크 생성 및 파기 중에 DestroyNetwork 이벤트가 발생하지 않는 문제를 수정했습니다.

### 알려진 문제

* 세 개 이상의 디바이스가 있는 네트워크에서 직접 피어 연결을 설정할 때 라이브러리가 가끔 크래시할 수 있습니다.

## 1.9.5

2024년 5월 3일

* 연결 공유와 같은 기능을 사용하는 Windows 디바이스에서 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 및 기타 작업에서 보고되는 간헐적 치명적 오류를 해결했습니다.
* Party를 사용하기 시작한 직후 프로세스가 종료되는 경우 Windows 및 XBOX에서 발생할 수 있는 크래시를 수정했습니다.
* [PartyLocalDevice::DestroyChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_destroychatcontrol) 호출 후 [`PartyChatControl`](/services/playfab/multiplayer/networking/reference/classes/PartyChatControl/partychatcontrol) 리소스가 때때로 해제되지 않고 [PartyManager::Cleanup](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup) 호출 후에만 해제되는 버그를 수정했습니다.
* Android: Party와 Multiplayer가 동일한 앱에서 사용될 때 중복 클래스 오류를 해결했습니다.

## 1.9.4

2024년 3월 20일

* 콘솔의 언어가 우크라이나어로 설정된 경우 PlayStation®4 및 PlayStation®5에서 [`PartyLocalDevice::CreateChatControl`](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)이 실패하는 버그를 수정했습니다.

## 1.9.3

2024년 3월 14일

* 음성-텍스트 변환이 활성화되었을 때 잠재적인 use-after-free 버그를 수정했습니다.
* 직접 피어 연결이 활성화되었을 때 발생할 수 있는 크래시를 수정했습니다.
* 내부 진단을 개선했습니다.

## 1.9.2

2024년 3월 5일

* Linux 플랫폼의 오디오 렌더링 버그를 패치했습니다. Linux 클라이언트는 이제 다른 플랫폼 클라이언트를 완전히 들을 수 있습니다.

## 1.9.1

2024년 2월 5일

* Party 라이브러리가 자동 지역 검색 및 연결 품질 측정을 수행하는 시기와 방법을 고급으로 제어할 수 있는 [`PartyOption::RegionUpdateConfiguration`](/services/playfab/multiplayer/networking/reference/enums/partyoption) 및 [`PartyOption::RegionQualityMeasurementConfiguration`](/services/playfab/multiplayer/networking/reference/enums/partyoption)을 추가했습니다.

## 1.8.11

2023년 11월 13일

* Nintendo Switch에서 클라이언트가 네트워크를 떠나려고 할 때 크래시가 발생할 수 있는 버그를 수정했습니다.

## 1.8.10

2023년 10월 19일

이 릴리스는 PlayFab Party Apple 및 Android 플랫폼의 최소 SDK 버전 및 대상 SDK 버전을 업데이트합니다.

Apple 플랫폼의 경우 Xcode 15 릴리스와 함께 [Apple의 Xcode 가이드라인](https://developer.apple.com/support/xcode/)을 따릅니다.

* iOS
  * 최소 배포 대상이 iOS 10에서 iOS 12로 상향되었습니다.
  * 대상 배포 버전이 iOS 16에서 iOS 17로 상향되었습니다.
* macOS
  * 대상 배포 버전이 macOS 13.3에서 macOS 14로 상향되었습니다.
  * 최소 배포 대상은 v.1.8.8 릴리스에서 macOS 12.3에서 macOS 10.13으로 낮아졌습니다.

Android 플랫폼의 경우 [Google의 대상 API 가이드라인](https://developer.android.com/google/play/requirements/target-sdk)을 따릅니다.

* Android
  * 최소 SDK 버전이 Android API 19에서 Android API 21로 상향되었습니다.
  * 대상 SDK 버전이 Android API 28에서 Android API 34로 상향되었습니다.
  * Compile SDK 버전이 Android API 28에서 Android API 34로 상향되었습니다.
  * 32비트 Android 플랫폼(arm7 및 x86)에 대한 지원은 2023년 10월 19일에 종료되었습니다. 해당 플랫폼에 대한 새로운 PlayFab Party 라이브러리 업데이트는 릴리스되지 않습니다. PlayFab Party 네트워킹 및 음성 서비스는 현재 32비트 Android 플랫폼에서 PlayFab Party 라이브러리를 사용하는 타이틀에 영향을 주지 않고 계속 작동합니다.

이러한 패키지 통합에 문제가 있는 경우, [PlayFab 지원 티켓을 제출하세요](/services/playfab/pricing/support).

## 1.8.9

2023년 10월 20일

* 엔드포인트에 대한 공유 속성을 구현했습니다. 공유 속성은 [`PartyNetwork::CreateEndpoint`](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint)를 통해 엔드포인트를 만들 때 설정할 수 있습니다. 공유 속성은 [`PartyEndpoint::GetSharedProperty`](/services/playfab/multiplayer/networking/reference/classes/PartyEndpoint/methods/partyendpoint_getsharedproperty)를 사용하여 검색할 수 있습니다.
* 일부 시나리오에서 인지되는 채팅 오디오 지연 시간을 줄이기 위해 오디오 패킷 큐잉을 개선했습니다.
* Opus 코덱의 내부 버전을 업그레이드했습니다.
* 낮은 빈도의 크래시를 수정했습니다.
* 내부 진단을 개선했습니다.
* Windows 7 지원을 제거했습니다.

이 버전의 NuGet 패키지는 런타임에 플랫폼별 DLL 버전을 동적으로 로드하는 대신 컴파일 시간에 PartyWin.dll에 대한 종속성을 추가합니다. PartyWin7.dll은 더 이상 NuGet에 포함되지 않으며 타이틀의 일부로 배포되지 않아야 합니다.

## 1.8.5

2023년 6월 28일

### 버그 수정

* Nintendo Switch, PlayStation®4 및 PlayStation®5에서 [`PartyLocalChatControl::SetAudioRenderVolume`](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiorendervolume)이 제대로 작동하지 않는 버그를 수정했습니다.

## 1.8.3

2023년 6월 2일

* PlayFab Party 1.8 버전이 마지막 Nintendo Switch 릴리스(1.7.15 버전) 이후의 모든 버그 수정 및 새 기능과 함께 Nintendo Switch용으로 릴리스되었습니다.

## 1.8.2

2023년 5월 30일

### 버그 수정

* PlayFab Party 라이브러리에서 macOS 버전이 13.1 이상이어야 하는 버그를 수정했습니다. 새 릴리스는 최소 macOS 버전을 12.3으로 설정합니다.

## 1.8.0

2023년 5월 8일

* 디바이스가 다른 디바이스에 설정하려고 시도하는 직접 피어 연결의 최대 수를 구성할 수 있는 옵션을 추가했습니다. 자세한 내용은 [`PartyOption::LocalDeviceMaxDirectPeerConnections`](/services/playfab/multiplayer/networking/reference/enums/partyoption)을 참조하세요.
* iOS, Android: 로컬 채팅 제어에서 캡처한 오디오에 대한 노이즈 억제 활성화 지원을 추가했습니다. 자세한 내용은 [`PartyLocalChatControl::SetVoiceAudioOptions`](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setvoiceaudiooptions)을 참조하세요.

### 버그 수정

* 사용자의 엔터티 토큰이 만료될 때 내부 진단 추적으로 인해 라이브러리가 메모리를 누수할 수 있는 버그를 수정했습니다.

## 1.7.23

2023년 4월 1일

* PlayStation®5 플랫폼에서 실시간 오디오 조작에 대한 지원을 추가했습니다.

## 1.7.22

2023년 3월 30일

### 버그 수정

* Party가 호스트 프로세스가 종료되기 시작하기 전에 정리되지 않은 경우 크래시할 수 있는 버그를 수정했습니다.
* 링크가 예기치 않게 연결이 끊긴 경우 릴레이 연결로 폴백하도록 피어 투 피어 연결 동작을 변경했습니다. 이전 동작은 두 디바이스 모두 네트워크에서 연결이 끊어졌습니다.

## 1.7.20

2023년 2월 8일

### 버그 수정

* 44.1kHz 마이크의 오디오가 왜곡되어 들릴 수 있는 버그를 수정했습니다.
* [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)에서 보고하는 네트워크 오류에 대한 진단 오류 메시지를 개선했습니다.

## 1.7.19

2022년 11월 11일

### 버그 수정

* Linux에서 특정 시점 이후에 웹 요청을 열지 못하는 버그를 수정했습니다.

## 1.7.17

2022년 10월 7일

### 버그 수정

* iOS에서 채팅 제어가 네트워크에 연결될 때 크래시가 발생할 수 있는 버그를 수정했습니다.
* iOS 로그를 활성화할 때 크래시가 발생할 수 있는 버그를 수정했습니다.

## 1.7.16

2022년 9월 27일

### macOS용 새로운 Bundle 릴리스

* Unity 플러그인 로딩 및 네이티브 macOS 개발을 위한 .bundle을 추가했습니다.

### 버그 수정

* macOS 로그를 활성화할 때 크래시가 발생할 수 있는 버그를 수정했습니다.

## 1.7.14

2022년 8월 12일

### Linux 및 macOS용 새로운 SDK

* Linux 및 macOS에서 PlayFab Party에 대한 네이티브 지원을 추가하여, 게임 개발자가 훨씬 더 많은 플랫폼에서 크로스 플랫폼 또는 다중 플랫폼 실시간 멀티플레이어 경험을 만들 수 있습니다. 이러한 SDK 릴리스 및 기타 SDK 릴리스에 대한 링크는 [PlayFab Party SDK](/services/playfab/multiplayer/networking/party-sdks/overview)를 참조하세요.

2022년 8월 11일

* Linux용 PlayFab Party 소개

## 1.7.11

2022년 6월 24일

### 버그 수정

* `PartyManager::Cleanup()` 호출 후에도 단일 메모리 할당이 남아 있는 문제를 수정했습니다.

## 1.7.8

2022년 4월 21일

### 버그 수정

* `PartyManager::Cleanup()`이 호출되었을 때 메모리가 완전히 정리되지 않는 문제를 수정했습니다.
* 동일한 오디오 디바이스 선택으로 `PartyLocalChatControl::SetAudioInput()` 또는 `PartyLocalChatControl::SetAudioOutput()`을 호출할 때 라이브러리가 불필요하게 오디오 디바이스를 다시 초기화하는 문제를 수정했습니다.

## 1.7.7

2022년 3월 16일

### 버그 수정

* PlayStation®4, PlayStation®5: 오디오 디바이스가 제거된 후 오디오 디바이스가 없을 때 발생하는 크래시를 수정했습니다.
* Switch: 여러 PlayFab 트랜잭션이 트리거되었을 때 웹 요청이 실패하는 문제를 수정했습니다.

## 1.7.6

2022년 2월 8일

### 성능 개선

* Windows, XDK, Nintendo Switch, PlayStation 4, PlayStation 5: 두 개의 워커 스레드를 제거하고 사전 존재하는 낮은 빈도의 작업 스레드에서 관련 작업을 수행합니다. 라이브러리의 Microsoft Game Development Kit(GDK) 버전에는 이미 이 결합된 작업 동작이 있었습니다.

### 버그 수정

* iOS, Android, Switch, PlayStation 4, PlayStation 5 및 Stadia: 초기화 중에 할당된 소량의 메모리가 정리 중에 제대로 해제되지 않는 문제를 수정했습니다.
* 텍스트 조정이 활성화되지 않은 경우 PartyChatTextReceivedStateChange에서 PartyChatTextReceivedOptions::FilteredDueToError 플래그를 보고하지 않도록 했습니다.

## 1.7.5

2021년 9월 30일

### 버그 수정

* 일부 16kHz 마이크가 작동하지 않는 문제를 수정했습니다.
* Windows에서 마이크 권한 변경이 처리되지 않는 문제를 수정했습니다.
* 일부 `PartyManager::CreateNewNetwork()` 실패 조건에서 메모리 누수를 수정했습니다.
* `PartyLocalEndpoint::GetEndpointStatistics()`에서 가끔 발생하는 크래시를 수정했습니다.

## 1.7.0

2021년 6월 29일

### 새로운 프로파일링 후크 및 채팅 제어 표시기

* 내부 라이브러리 함수에 시간이 소비되는 위치에 관심 있는 개발자는 이제 선호하는 고성능 계측 방법에 후크할 수 있도록 선택적 메서드 진입 및 종료 콜백을 구성할 수 있습니다. 자세한 내용은 [`PartyManager::SetProfilingCallbacksForMethodEntryExit`](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setprofilingcallbacksformethodentryexit)을 참조하세요. 이번 릴리스에서는 콜백이 Windows, XBOX One XDK 및 Microsoft Game Core 플랫폼에서만 지원됩니다.
* 새로운 NoRemoteInput 및 RemoteAudioInputMuted 채팅 제어 표시기는 현재 무음 오디오 상태에 대한 세분화된 정보를 제공합니다. 자세한 내용은 [`PartyChatControlChatIndicator`](/services/playfab/multiplayer/networking/reference/enums/partychatcontrolchatindicator)을 참조하세요.

### 엔드포인트 메시지 동작 개선

* ['PartySendMessageQueuingConfiguration'](/services/playfab/multiplayer/networking/reference/structs/partysendmessagequeuingconfiguration) `timeoutInMilliseconds` 필드는 이제 원격 대상의 다른 네트워크 상태 또는 응답성으로 인해 전달 전에 메시지를 큐잉해야 하는 경우 투명 클라우드 릴레이에서도 평가됩니다.
* 네트워크에 완전히 인증되면, 0개 항목 배열로의 전송이 그 시점에 라이브러리가 네트워크에서 현재 보고하는 모든 원격 엔드포인트의 정확한 세트를 올바르게 대상으로 지정합니다. 메시지가 전송되는 과정에서 생성되는 엔드포인트는 더 이상 잠재적으로 포함되지 않습니다.

## 1.6.1

### 버그 수정

* 채팅 제어가 다른 네트워크에서 연결을 끊는 동안 동일한 채팅 제어가 네트워크에 연결될 때 크래시가 발생할 수 있는 버그를 수정했습니다.

## 1.6.0

2021년 4월 12일

### 새로운 스레드 제어 및 텍스트 조정 기능

* 이제 라이브러리의 작업을 게임 제어 스레드에서 수동으로 실행할 수 있습니다. 자세한 내용은 [`PartyManager::SetWorkMode`](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setworkmode)를 참조하세요.
* 이제 공격적인 텍스트 채팅을 선택적으로 필터링할 수 있습니다. 자세한 내용은 [텍스트 조정 사용](/services/playfab/community/voice-communications/concepts-text-moderation)을 참조하세요.

### 헤더의 명시적 열거형 번호 매김

* 헤더의 열거형 값은 이제 명시적 번호 매김을 가집니다.

## 1.5.13

2021년 3월 26일

### 버그 수정

* Bluetooth 헤드셋을 사용하는 iOS 디바이스에서 오디오가 끊기는 버그를 수정했습니다.
* Windows 플랫폼에서 앱에 마이크를 활성화할 권한이 없을 때 잘못된 오류 코드가 생성되는 버그를 수정했습니다.
* 다른 것이 새로 고침을 강제하지 않는 한 비정상 디바이스가 새로 고쳐지지 않는 버그를 수정했습니다.
* 해당 채널과 연관된 원본 엔드포인트가 무효화된 후 전송 채널의 사용자 데이터를 역참조할 때 크래시가 발생할 수 있는 버그를 수정했습니다.
* 원격 채팅 제어에 언어 코드가 없는 경우 클라이언트가 자동 실패를 경험하는 버그를 수정했습니다.

## 1.5.10

### 버그 수정

* 프로세스의 프로세서 어피니티와 라이브러리의 기본 스레드 어피니티 간의 불일치로 인해 일부 Windows 디바이스에서 라이브러리 초기화가 실패할 수 있는 버그를 수정했습니다.
* 내부 웹 요청 실패로 인해 작업이 실패했을 때 라이브러리가 오류를 제공하지 않을 수 있는 버그를 수정했습니다.
* 직접 피어 연결이 활성화되었고 라이브러리가 다른 디바이스에 직접 피어 연결을 설정하려고 시도할 때 크래시가 발생할 수 있는 버그를 수정했습니다.
* 지지직거리거나 왜곡된 오디오가 발생할 수 있는 버그를 수정했습니다.

## 1.5.1

2020년 9월 5일

### 버그 수정

* iOS에서 라이브러리가 마이크를 활성화하지 못하는 버그를 수정했습니다.

## 1.5.0

### 새로운 직접 피어 투 피어 연결, 지연 시간 및 음성-텍스트 변환 기능

* 이제 Windows 10 및 Microsoft Game Core 버전의 라이브러리에서 직접 피어 투 피어 연결이 지원됩니다. 자세한 내용은 [직접 피어 투 피어 연결 사용](/services/playfab/multiplayer/networking/concepts-direct-peer-connectivity)을 참조하세요.
* 이제 라이브러리를 통해 로컬 디바이스와 원격 디바이스 간의 왕복 지연 시간을 쿼리할 수 있습니다. 자세한 내용은 [`PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds`](/services/playfab/multiplayer/networking/reference/enums/partyendpointstatistic)을 참조하세요.
* 이제 음성-텍스트 변환 욕설 마스킹을 비활성화할 수 있습니다. 자세한 내용은 [`PartyVoiceChatTranscriptionOptions::DisableProfanityMasking`](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions)을 참조하세요.

### Android 및 iOS 오디오 버그 수정

* Android: `PartyManager::Initialize()`가 호출될 때가 아니라 `PartyLocalDevice::CreateChatControl()`이 처음 호출될 때 Bluetooth 관리자가 초기화됩니다.
* iOS: `PartyManager::Initialize()`가 호출될 때의 사소한 사운드 아티팩트를 수정했습니다.

## 1.4.13

### Windows 8.1 종속성 문제

이 릴리스는 이전 버전이 Windows 8.1에서 작동하지 못하게 했던 api-ms-win-core-version-l1-1-1.dll에 대한 불필요한 종속성을 제거합니다.

## 1.4.8

2020년 4월 30일

### TLS1.2

* Windows 7, Android 및 iOS에서 TLS1.2를 사용하도록 필사 스택이 업데이트되었습니다. TLS1.1 지원이 2020년 9월부터 [Azure Speech Services](https://azure.microsoft.com/updates/azuretls12/)에 의해 사용 중단될 예정이므로, 이러한 플랫폼 중 하나를 사용하는 경우 업그레이드하세요. 다른 모든 플랫폼은 이미 TLS1.2를 지원하며 업그레이드가 필요하지 않습니다.

### 버그 수정

* `PartyCreateChatControlCompletedStateChange` 구조체의 `languageCode` 필드가 채워지지 않는 버그를 수정했습니다.
* `PartyManager::GetRegions()`에서 보고되는 지연 시간 측정을 인위적으로 부풀리는 버그를 수정했습니다.
* 안전하지 않은 시점에 `PartyManager::SetMemoryCallbacks()`을 호출할 수 있게 하는 버그를 수정했습니다.
* `PartyNetwork`에 있는 `PartyLocalUser`로 `PartyManager::DestroyLocalUser()`를 호출하면 removedReason 필드에 잘못된 값 `PartyLocalUserRemovedReason::RemoveLocalUser`가 있는 `PartyLocalUserRemovedStateChange`가 생성되는 대신 올바른 값 `PartyLocalUserRemovedReason::DestroyLocalUser`가 생성되는 버그를 수정했습니다.

### 기타 변경 사항

* 채팅 데이터에 사용되는 대역폭이 감소되었습니다.
* 이제 XBOX에서 샌드박스 문제가 발생할 때 더 자세한 오류 코드와 오류 메시지가 제공됩니다.
* 빈 PlayFab 타이틀 ID가 제공되면 이제 `PartyManager::Initialize()`이 실패합니다.
* 유효하지 않은 PlayFab 엔터티 토큰을 `PartyManager::CreateLocalUser()`에 전달하면 유효한 토큰에 의존하는 작업의 상태 변경 결과에서 더 자세한 오류 메시지가 발생합니다.
* 헤더 문서의 오타가 수정되었습니다.
* 유효하지 않은 지역이 `PartyManager::CreateNewNetwork()`에 전달될 때 더 자세한 오류 코드와 오류 메시지가 제공됩니다.
* Party.h의 구조체 및 인터페이스에 대한 `PartyString` 값의 수명에 대한 문서가 명확해졌습니다.
* `PartyManager::Cleanup()`에 대한 문서에서 스레드 안전 호출이 아님을 설명하도록 명확해졌습니다.
* `PartyManager::ConnectToNetwork()`이 인터넷 연결 오류로 인해 비동기적으로 실패할 때 더 자세한 오류 코드와 오류 메시지가 제공됩니다.

## 1.3.0

### 채팅 API 변경 사항

* 발신 또는 수신 음성 채팅 오디오를 수정하는 데 사용할 수 있는 실시간 오디오 조작 함수가 Windows 및 XBOX용으로 구현됩니다. 자세한 내용은 [실시간 오디오 조작을 사용하여 사용자 지정 음성 효과 적용](/services/playfab/community/voice-communications/concepts-realtime-audio-manipulation)을 참조하세요.
* 채팅 권한 옵션에는 텍스트 음성 변환 및 마이크 오디오 권한을 독립적으로 구성할 수 있는 더 많은 옵션이 있습니다. 자세한 내용은 [`PartyChatPermissionOptions`](/services/playfab/multiplayer/networking/reference/enums/partychatpermissionoptions)을 참조하세요.
* 이는 이전 릴리스의 XBOX Live Helper 라이브러리와의 호환성을 손상시킵니다. 이 릴리스는 XBOX Live Helper 라이브러리 버전 1.2.0과 호환됩니다. 자세한 내용은 [XBOX Live Helper Library 릴리스 정보](/services/playfab/multiplayer/networking/party-xboxlive-relnotes)를 참조하세요.
* 이제 각 필사 상태 변경은 텍스트 음성 변환 또는 마이크 오디오를 나타내는지 여부를 표시합니다. 자세한 내용은 [`PartyVoiceChatTranscriptionReceivedStateChange`](/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange)을 참조하세요.

## 1.2.2

### iOS 변경 사항

* 볼륨 제어 API에 대한 지원을 추가합니다.

## 1.2.0

### Android 변경 사항

* 볼륨 제어 API에 대한 지원을 추가합니다.
* 라이브러리에서 오디오 포커스 처리를 제거합니다. 호스트 애플리케이션은 이제 자체 포커스 처리 로직을 구현해야 합니다.

## 1.0.2

* 백그라운드 원격 분석의 크래시를 수정했습니다.

## 1.0.1

### Party API 변경 사항

#### PartyManager::SetMemoryCallbacks 변경 사항

이 Party 릴리스는 `PartyManager::SetMemoryCallbacks()`에 대한 수정과 이 API 호출이 안전한 시점에 대한 제한 사항을 추가합니다. 자세한 내용은 Party.h의 API 참조 문서를 확인하세요.

#### PartyStateChangeResult::TitleCreateNetworkThrottled 제거

Party 라이브러리가 이 값을 생성하지 않기 때문에 `PartyStateChangeResult` 값 `TitleCreateNetworkThrottled`가 API에서 제거되었습니다.

## 0.7.0-prerelease

### Windows 패키징 변경 사항

이 Party 릴리스는 새로운 NuGet 패키지 [Microsoft.PlayFab.PlayFabParty.Cpp.Windows](https://www.nuget.org/packages/Microsoft.PlayFab.PlayFabParty.Cpp.Windows)를 도입하여, Windows 10 및 Windows 7 관련 NuGet 패키지(각각 Microsoft.PlayFab.PlayFabParty.Cpp.Win10 및 Microsoft.PlayFab.PlayFabParty.Cpp.Win7)를 대체하고 사용 중단합니다. 새로운 통합 Windows NuGet 패키지에는 두 개의 새로운 DLL, PartyWin.dll(Windows 8.1 이상 지원) 및 PartyWin7.dll(Windows 7 전용)이 포함되어 있습니다. 새 Windows 통합 NuGet 패키지에서는 런타임에 OS 버전을 감지한 기반으로 올바른 Party DLL이 로드되므로, PartyWin.dll과 PartyWin7.dll을 모두 게임 배포 패키지에 포함해야 합니다.

### Android 변경 사항

Android 플레이버는 이제 정적 라이브러리(libparty.a) 대신 Party에 대한 공유 개체(libparty.so)를 사용합니다.

이 릴리스에는 오디오 디바이스 선택에 대한 Android 특정 버그 수정도 포함되어 있습니다.

### iOS 변경 사항

Party의 iOS 플레이버는 이제 정적으로 빌드된 libparty.a 대신 libparty를 동적으로 로드하기 위한 프레임워크 패키지가 포함되어 있습니다.

### API 변경 사항

#### UpdateEntityToken API

이 Party 릴리스는 PlayFab 엔터티 토큰 처리와 관련된 변경 사항을 도입합니다. 이전 버전에서는 게임이 `PartyManager::CreateLocalUser()` API에서 사용자의 엔터티 토큰을 Party에 제공했습니다. 이후 Party는 내부적으로 엔터티 토큰을 새로 고쳐 최신 상태로 유지했습니다.

이 버전에서는 내부 토큰 새로 고침 동작이 제거되고 새로운 API `PartyLocalUser::UpdateEntityToken()`으로 대체되었습니다. 호출자는 이제 `PartyManager::CreateLocalUser()` 및 `PartyLocalUser::UpdateEntityToken()`에 제공된 엔터티 토큰의 만료를 모니터링할 책임이 있습니다. 토큰이 만료 시간에 가까워지거나 지난 경우, PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 `PartyLocalUser::UpdateEntityToken()`을 호출하여 Party 라이브러리에 제공해야 합니다. 이전에 제공된 토큰의 유효 기간이 절반 지났을 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태에 들어가거나 애플리케이션 실행이 오랫동안 일시 중지되는 플랫폼에서는 토큰이 만료되기 전에 새로 고쳐지지 못할 수 있습니다. 실행이 재개되면 토큰의 만료 여부를 확인해야 합니다.

대략적인 흐름은 다음과 같습니다.

1. 게임이 `LoginWith*` PlayFab API를 호출합니다.
2. PlayFab의 응답에는 엔터티 토큰과 만료 시간이 포함됩니다.
3. 이전과 같이 `PartyManager::CreateLocalUser()` API로 토큰 정보를 Party에 제공합니다.
4. \[신규] 새로 고쳐야 할 시기를 알기 위해 만료 시간을 기록합니다.
5. \[신규] 토큰 만료 시간의 절반이 지나면(또는 그 시간 이후 가장 이른 기회에), `LoginWith*`를 다시 호출하여 새 토큰을 획득하고 새 토큰의 만료 시간을 추적합니다.
6. \[신규] `PartyLocalUser::UpdateEntityToken()`을 호출하여 새 토큰을 Party에 전달합니다.

추가 참고 사항:

* 엔터티 토큰을 획득하는 행위는 이전에 획득한 엔터티 토큰을 무효화하지 않습니다. 이들은 만료될 때까지 유효한 상태로 유지됩니다.
* 대부분의 게임이 자체 PlayFab 호출을 할 것으로 예상되기 때문에 내부 새로 고침 기능이 제거되었습니다. 게임과 Party 라이브러리가 모두 엔터티 토큰을 가져오면 두 세트의 토큰을 관리하기 위한 불필요한 서비스 부하가 발생합니다.

#### 채팅 API 변경 사항

`PartyVoiceChatTranscriptionReceivedStateChange`에 이제 필사의 언어를 나타내는 `languageCode` 필드가 포함됩니다.

`PartyChatTextReceivedStateChange`에 이제 채팅 텍스트의 언어를 나타내는 `languageCode` 필드가 포함됩니다. `languageCode` 필드는 `PartyLocalChatControl::SetTextChatOptions()`을 통해 채팅 텍스트 번역이 활성화되었을 때 채워집니다.

## 0.6.0-prerelease

iOS, Android 및 Nintendo Switch 플랫폼에 대한 지원이 추가되었습니다.

자세한 내용은 다음 링크를 참조하세요.

[iOS/Android](https://github.com/PlayFab/PlayFabParty/releases)

## 0.5.0-prerelease

### API 변경 사항

#### 접근 가능한 채팅

* 텍스트 음성 변환 내레이션에 대한 지원을 추가했습니다. (`PartyLocalChatControl::SetTextToSpeechProfile()` 참조)
* 음성-텍스트 변환이 발생하는 시기를 제어하기 위한 더 많은 옵션을 추가했습니다. (`PartyLocalChatControl::SetTranscriptionOptions()` 참조)
* 아직 지원되지는 않지만 텍스트-텍스트 번역을 API에 추가했습니다. (`PartyLocalChatControl::SetTextChatOptions()` 참조)
* 텍스트 음성 변환 대역폭 및 메모리 사용량을 줄였습니다.

#### 네트워크 액세스 제어

* `PartyNetwork::SetAccessControlList()` 및 관련 메서드가 API에서 제거되었습니다. 새로운 `PartyInvitation` 클래스 및 관련 메서드를 사용하여 열린 초대를 만들거나 Party 네트워크에 특정 PlayFab 사용자에게 액세스를 부여합니다.

## 0.4.6-prerelease

### API 변경 사항

새로운 공개 API `PartyLocalUser::UpdateEntityToken()`을 추가했습니다.

## 0.2.0-prerelease

### API 변경 사항

* 이제 `PartyManager::Initialize`는 유효한 PlayFab 타이틀 ID가 전달되어야 합니다.

"PlayStation"은 Sony Interactive Entertainment Inc.의 등록 상표 또는 상표입니다.


## Related topics

- [PlayFab Multiplayer C++ SDK 릴리스 정보](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PlayFab Services C/C++ SDK 릴리스 정보](/ko/services/playfab/release-notes/playfab-c/index.md)
- [PlayFab Services SDK 릴리스 정보 2024](/ko/services/playfab/release-notes/2024.md)
- [PlayFab Services SDK 릴리스 정보 2025](/ko/services/playfab/release-notes/2025.md)
- [릴리스 정보](/ko/tools/tools-pc/xbox-pc-remote-tools/release-notes/index.md)
