XDK 및 Windows 7 플랫폼에 대한 지원은 2023년 8월 1일에 종료되었습니다. 해당 플랫폼에 대한 새로운 PlayFab Party 라이브러리 업데이트는 릴리스되지 않습니다. PlayFab Party 네트워킹 및 음성 서비스는 현재 PlayFab Party 라이브러리의 Windows 7 또는 XDK 버전을 사용하는 타이틀에 영향을 주지 않고 계속 작동합니다.
32비트 Android 플랫폼(arm7 및 x86)에 대한 지원은 2023년 10월 19일에 종료되었습니다. 해당 플랫폼에 대한 새로운 PlayFab Party 라이브러리 업데이트는 릴리스되지 않습니다. PlayFab Party 네트워킹 및 음성 서비스는 현재 32비트 Android 플랫폼에서 PlayFab Party 라이브러리를 사용하는 타이틀에 영향을 주지 않고 계속 작동합니다.
1.10.25
2026년 7월 24일버그 수정
- GDK: PC에서 기본 멀티플레이어 포트 쿼리 실패에 대한 복원력이 향상되었습니다. 복구 가능한 실패는 PC에서 임시 포트 선택으로 대체됩니다. GDK PC 포트 선택에 대한 더 엄격한 제어를 원하는 타이틀은
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직후에PartyManager::Initialize를 호출할 때 발생할 수 있는 크래시를 수정했습니다. - Android:
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에 대한 지원을 추가했습니다.
버그 수정
- 다중 네트워크 전환 시나리오에서 발생할 수 있는 크래시를 수정했습니다.
1.10.15
2025년 12월 17일- Nintendo Switch 2: 웹 요청에 10초 시간 제한을 추가했습니다.
1.10.14
2025년 12월 9일- 토큰 만료 전에 발생하는 일시적인 오류에 대해서는
PartyServiceError를 반환하고 토큰이 만료된 경우에만UserNotAuthorized를 반환하도록PartyNetwork::CreateEndpointPartyStatusChangeResult 동작을 변경했습니다. - Android: 새로운 Android 페이지 크기 요구 사항을 충족하기 위해 16KB 페이지 크기 지원을 추가했습니다.
1.10.13
2025년 10월 14일- iOS 26에서 마이크가 제대로 작동하지 않는 문제를 수정했습니다.
- Apple: iOS에서 Arm64.xcframework 지원을 추가했습니다.
1.10.12
2025년 10월 6일- 토큰 만료 전에 발생하는 일시적인 오류에 대해서는
PartyServiceError를 반환하고 토큰이 만료된 경우에만UserNotAuthorized를 반환하도록PartyNetwork::CreateEndpointPartyStatusChangeResult 동작을 변경했습니다. - Android: 새로운 Android 페이지 크기 요구 사항을 충족하기 위해 16KB 페이지 크기 지원을 추가했습니다.
- Apple: iOS에서 Arm64 시뮬레이터 빌드 지원을 추가했습니다.
버그 수정
- 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가 PartyEndpointStatistic::CurrentlyQueuedSendMessages 및 PartyEndpointStatistic::CurrentlyQueuedSendMessageBytes에 대해 잘못된 값을 보고하는 문제를 수정했습니다.
- macOS에서 프레임워크의 손상된 심볼릭 링크를 수정했습니다.
- SDK 로그 수집 중 Windows 이외의 플랫폼에 대한 로그 예외 처리를 개선했습니다.
1.10.4
2024년 11월 12일- PlayStation®4 및 PlayStation®5: 생성 및 파기 중 뮤텍스 작업 및 엔드포인트 상태 변경과 관련된 크래시를 해결했습니다.
1.10.3
2024년 10월 14일- 네트워크당 최대 128개의 디바이스에 대한 지원을 추가했습니다. 자세한 내용은 확장 가능한 네트워크를 참조하세요.
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을 통해 로컬 사용자로 추가할 수 있습니다.- 라이브러리의 각 엔터티와 연관된 엔터티 유형을 결정하는 메서드를 추가했습니다. 자세한 내용은 PartyLocalUser::GetEntityType, PartyEndpoint::GetEntityType, PartyChatControl::GetEntityType을 참조하세요.
title_player엔터티와 다른title_player엔터티 간의 직접 피어 연결을 허용하지 않으면서title_player및game_server엔터티 간의 직접 피어 연결을 활성화하는 직접 피어 연결 옵션을 추가했습니다. 자세한 내용은 PartyDirectPeerConnectivityOptions::OnlyServers를 참조하세요.- 필터를 기반으로 엔드포인트의 편리한 목록을 검색하는 메서드를 추가했습니다. 자세한 내용은 PartyNetwork::GetEndpointsByUserType을 참조하세요.
- PlayStation®4 및 PlayStation®5의 PlayFab Party에서 사용되는 타사 라이브러리에 의한 메모리 할당이 기본 할당자를 사용하고 있던 것이 Party의 메모리 콜백을 사용하도록 업데이트되었습니다. PartyManager::SetMemoryCallbacks를 사용하여 타이틀별 메모리 할당 함수 할당을 구성하는 타이틀은 이제 이러한 할당을 확인하고 제어할 수 있습니다.
버그 수정
- 프로세스가 종료되는 동안 Windows 또는 XBOX에서 라이브러리가 크래시할 수 있는 문제를 수정했습니다.
- Windows가 아닌 플랫폼의 특정 경우에 이전 연결 시도가 실패한 후 발생하는 잘못된 직접 피어 연결 실패를 해결했습니다.
- 반복적인 Party 네트워크 생성 및 파기 중에 DestroyNetwork 이벤트가 발생하지 않는 문제를 수정했습니다.
알려진 문제
- 세 개 이상의 디바이스가 있는 네트워크에서 직접 피어 연결을 설정할 때 라이브러리가 가끔 크래시할 수 있습니다.
1.9.5
2024년 5월 3일- 연결 공유와 같은 기능을 사용하는 Windows 디바이스에서 PartyRegionsChangedStateChange 및 기타 작업에서 보고되는 간헐적 치명적 오류를 해결했습니다.
- Party를 사용하기 시작한 직후 프로세스가 종료되는 경우 Windows 및 XBOX에서 발생할 수 있는 크래시를 수정했습니다.
- PartyLocalDevice::DestroyChatControl 호출 후
PartyChatControl리소스가 때때로 해제되지 않고 PartyManager::Cleanup 호출 후에만 해제되는 버그를 수정했습니다. - Android: Party와 Multiplayer가 동일한 앱에서 사용될 때 중복 클래스 오류를 해결했습니다.
1.9.4
2024년 3월 20일- 콘솔의 언어가 우크라이나어로 설정된 경우 PlayStation®4 및 PlayStation®5에서
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및PartyOption::RegionQualityMeasurementConfiguration을 추가했습니다.
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 가이드라인을 따릅니다.- 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
- 최소 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 라이브러리를 사용하는 타이틀에 영향을 주지 않고 계속 작동합니다.
1.8.9
2023년 10월 20일- 엔드포인트에 대한 공유 속성을 구현했습니다. 공유 속성은
PartyNetwork::CreateEndpoint를 통해 엔드포인트를 만들 때 설정할 수 있습니다. 공유 속성은PartyEndpoint::GetSharedProperty를 사용하여 검색할 수 있습니다. - 일부 시나리오에서 인지되는 채팅 오디오 지연 시간을 줄이기 위해 오디오 패킷 큐잉을 개선했습니다.
- Opus 코덱의 내부 버전을 업그레이드했습니다.
- 낮은 빈도의 크래시를 수정했습니다.
- 내부 진단을 개선했습니다.
- Windows 7 지원을 제거했습니다.
1.8.5
2023년 6월 28일버그 수정
- Nintendo Switch, PlayStation®4 및 PlayStation®5에서
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을 참조하세요. - iOS, Android: 로컬 채팅 제어에서 캡처한 오디오에 대한 노이즈 억제 활성화 지원을 추가했습니다. 자세한 내용은
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()에서 보고하는 네트워크 오류에 대한 진단 오류 메시지를 개선했습니다.
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를 참조하세요.
- 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을 참조하세요. 이번 릴리스에서는 콜백이 Windows, XBOX One XDK 및 Microsoft Game Core 플랫폼에서만 지원됩니다. - 새로운 NoRemoteInput 및 RemoteAudioInputMuted 채팅 제어 표시기는 현재 무음 오디오 상태에 대한 세분화된 정보를 제공합니다. 자세한 내용은
PartyChatControlChatIndicator을 참조하세요.
엔드포인트 메시지 동작 개선
- ‘PartySendMessageQueuingConfiguration’
timeoutInMilliseconds필드는 이제 원격 대상의 다른 네트워크 상태 또는 응답성으로 인해 전달 전에 메시지를 큐잉해야 하는 경우 투명 클라우드 릴레이에서도 평가됩니다. - 네트워크에 완전히 인증되면, 0개 항목 배열로의 전송이 그 시점에 라이브러리가 네트워크에서 현재 보고하는 모든 원격 엔드포인트의 정확한 세트를 올바르게 대상으로 지정합니다. 메시지가 전송되는 과정에서 생성되는 엔드포인트는 더 이상 잠재적으로 포함되지 않습니다.
1.6.1
버그 수정
- 채팅 제어가 다른 네트워크에서 연결을 끊는 동안 동일한 채팅 제어가 네트워크에 연결될 때 크래시가 발생할 수 있는 버그를 수정했습니다.
1.6.0
2021년 4월 12일새로운 스레드 제어 및 텍스트 조정 기능
- 이제 라이브러리의 작업을 게임 제어 스레드에서 수동으로 실행할 수 있습니다. 자세한 내용은
PartyManager::SetWorkMode를 참조하세요. - 이제 공격적인 텍스트 채팅을 선택적으로 필터링할 수 있습니다. 자세한 내용은 텍스트 조정 사용을 참조하세요.
헤더의 명시적 열거형 번호 매김
- 헤더의 열거형 값은 이제 명시적 번호 매김을 가집니다.
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 버전의 라이브러리에서 직접 피어 투 피어 연결이 지원됩니다. 자세한 내용은 직접 피어 투 피어 연결 사용을 참조하세요.
- 이제 라이브러리를 통해 로컬 디바이스와 원격 디바이스 간의 왕복 지연 시간을 쿼리할 수 있습니다. 자세한 내용은
PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds을 참조하세요. - 이제 음성-텍스트 변환 욕설 마스킹을 비활성화할 수 있습니다. 자세한 내용은
PartyVoiceChatTranscriptionOptions::DisableProfanityMasking을 참조하세요.
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에 의해 사용 중단될 예정이므로, 이러한 플랫폼 중 하나를 사용하는 경우 업그레이드하세요. 다른 모든 플랫폼은 이미 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용으로 구현됩니다. 자세한 내용은 실시간 오디오 조작을 사용하여 사용자 지정 음성 효과 적용을 참조하세요.
- 채팅 권한 옵션에는 텍스트 음성 변환 및 마이크 오디오 권한을 독립적으로 구성할 수 있는 더 많은 옵션이 있습니다. 자세한 내용은
PartyChatPermissionOptions을 참조하세요. - 이는 이전 릴리스의 XBOX Live Helper 라이브러리와의 호환성을 손상시킵니다. 이 릴리스는 XBOX Live Helper 라이브러리 버전 1.2.0과 호환됩니다. 자세한 내용은 XBOX Live Helper Library 릴리스 정보를 참조하세요.
- 이제 각 필사 상태 변경은 텍스트 음성 변환 또는 마이크 오디오를 나타내는지 여부를 표시합니다. 자세한 내용은
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를 도입하여, 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 라이브러리에 제공해야 합니다. 이전에 제공된 토큰의 유효 기간이 절반 지났을 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태에 들어가거나 애플리케이션 실행이 오랫동안 일시 중지되는 플랫폼에서는 토큰이 만료되기 전에 새로 고쳐지지 못할 수 있습니다. 실행이 재개되면 토큰의 만료 여부를 확인해야 합니다.
대략적인 흐름은 다음과 같습니다.
- 게임이
LoginWith*PlayFab API를 호출합니다. - PlayFab의 응답에는 엔터티 토큰과 만료 시간이 포함됩니다.
- 이전과 같이
PartyManager::CreateLocalUser()API로 토큰 정보를 Party에 제공합니다. - [신규] 새로 고쳐야 할 시기를 알기 위해 만료 시간을 기록합니다.
- [신규] 토큰 만료 시간의 절반이 지나면(또는 그 시간 이후 가장 이른 기회에),
LoginWith*를 다시 호출하여 새 토큰을 획득하고 새 토큰의 만료 시간을 추적합니다. - [신규]
PartyLocalUser::UpdateEntityToken()을 호출하여 새 토큰을 Party에 전달합니다.
- 엔터티 토큰을 획득하는 행위는 이전에 획득한 엔터티 토큰을 무효화하지 않습니다. 이들은 만료될 때까지 유효한 상태로 유지됩니다.
- 대부분의 게임이 자체 PlayFab 호출을 할 것으로 예상되기 때문에 내부 새로 고침 기능이 제거되었습니다. 게임과 Party 라이브러리가 모두 엔터티 토큰을 가져오면 두 세트의 토큰을 관리하기 위한 불필요한 서비스 부하가 발생합니다.
채팅 API 변경 사항
PartyVoiceChatTranscriptionReceivedStateChange에 이제 필사의 언어를 나타내는 languageCode 필드가 포함됩니다.
PartyChatTextReceivedStateChange에 이제 채팅 텍스트의 언어를 나타내는 languageCode 필드가 포함됩니다. languageCode 필드는 PartyLocalChatControl::SetTextChatOptions()을 통해 채팅 텍스트 번역이 활성화되었을 때 채워집니다.
0.6.0-prerelease
iOS, Android 및 Nintendo Switch 플랫폼에 대한 지원이 추가되었습니다. 자세한 내용은 다음 링크를 참조하세요. iOS/Android0.5.0-prerelease
API 변경 사항
접근 가능한 채팅
- 텍스트 음성 변환 내레이션에 대한 지원을 추가했습니다. (
PartyLocalChatControl::SetTextToSpeechProfile()참조) - 음성-텍스트 변환이 발생하는 시기를 제어하기 위한 더 많은 옵션을 추가했습니다. (
PartyLocalChatControl::SetTranscriptionOptions()참조) - 아직 지원되지는 않지만 텍스트-텍스트 번역을 API에 추가했습니다. (
PartyLocalChatControl::SetTextChatOptions()참조) - 텍스트 음성 변환 대역폭 및 메모리 사용량을 줄였습니다.
네트워크 액세스 제어
PartyNetwork::SetAccessControlList()및 관련 메서드가 API에서 제거되었습니다. 새로운PartyInvitation클래스 및 관련 메서드를 사용하여 열린 초대를 만들거나 Party 네트워크에 특정 PlayFab 사용자에게 액세스를 부여합니다.
0.4.6-prerelease
API 변경 사항
새로운 공개 APIPartyLocalUser::UpdateEntityToken()을 추가했습니다.
0.2.0-prerelease
API 변경 사항
- 이제
PartyManager::Initialize는 유효한 PlayFab 타이틀 ID가 전달되어야 합니다.
