> ## 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 網路與語音服務會繼續運作,對目前使用 Windows 7 或 XDK 版本 PlayFab Party 程式庫的任何標題皆無影響。
</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:修正 HTTPS 要求,使其驗證伺服器的 TLS 認證。
* Android:修正使用 NDK 25 或更舊版本時,PartyCleanup 期間可能發生的記憶體洩漏。
* 修正 Websocket 連線,使其驗證伺服器的 TLS 認證。

## 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) 支援,該支援曾在先前版本中被意外移除。
* 修正一個可能的釋放後使用 (use-after-free) 問題:內部 HTTP 追蹤物件可能在其背後的非同步工作完成之前就被刪除。
* Linux:防止多個共用物件連結相同相依性時,因靜態程式庫被覆寫所導致的潛在當機。

## 1.10.20

2026 年 4 月 29 日

* PlayStation®5:修正 HTTP 回應剖析,以正確傳播 null JSON 值。

## 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:新增對使用同處理程序 (in-proc) GRTS 之環境的支援。
* GDK:新增對 [`PartyAudioDeviceSelectionType::SystemDefault`](/services/playfab/multiplayer/networking/reference/enums/partyaudiodeviceselectiontype) 的支援。

### 錯誤修正

* 修正多網路轉換情境中可能發生的當機。

## 1.10.15

2025 年 12 月 17 日

* Nintendo Switch 2:為 Web 要求新增 10 秒逾時。

## 1.10.14

2025 年 12 月 9 日

* 變更 [`PartyNetwork::CreateEndpoint`](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint) 的 PartyStatusChangeResult 行為:對於權杖到期前發生的暫時性錯誤傳回 `PartyServiceError`,且僅在權杖已到期時才傳回 `UserNotAuthorized`。
* Android:新增對 16-KB 頁面大小的支援,以滿足新的 [Android 頁面大小需求](https://developer.android.com/guide/practices/page-sizes)。

## 1.10.13

2025 年 10 月 14 日

* 修正導致麥克風在 iOS 26 上無法正常運作的問題。
* Apple:新增 iOS 上 Arm64.xcframework 的支援。

## 1.10.12

2025 年 10 月 6 日

* 變更 [`PartyNetwork::CreateEndpoint`](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint) 的 PartyStatusChangeResult 行為:對於權杖到期前發生的暫時性錯誤傳回 `PartyServiceError`,且僅在權杖已到期時才傳回 `UserNotAuthorized`。
* Android:新增對 16-KB 頁面大小的支援,以滿足新的 [Android 頁面大小需求](https://developer.android.com/guide/practices/page-sizes)。
* 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 上架構 (framework) 損毀的符號連結。
* 改善收集 SDK 記錄期間,非 Windows 平台的記錄例外狀況處理。

## 1.10.4

2024 年 11 月 12 日

* PlayStation®4 與 PlayStation®5:解決建立與終結期間,與 mutex 作業及端點狀態變更相關的當機。

## 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` 與 `game_server` 實體之間的直接對等連線,同時禁止 `title_player` 實體與其他 `title_player` 實體之間的直接對等連線。如需詳細資訊,請見 [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 日

* 修正一個錯誤:當主機語言設定為烏克蘭文時,[`PartyLocalDevice::CreateChatControl`](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol) 在 PlayStation®4 與 PlayStation®5 上會失敗。

## 1.9.3

2024 年 3 月 14 日

* 修正啟用語音轉文字時潛在的釋放後使用 (use-after-free) 錯誤。
* 修正啟用直接對等連線時潛在的當機。
* 改善內部診斷。

## 1.9.2

2024 年 3 月 5 日

* 修補 Linux 平台上的音訊轉譯錯誤。Linux 用戶端現在可以完整聽到其他平台用戶端的聲音。

## 1.9.1

2024 年 2 月 5 日

* 新增 [`PartyOption::RegionUpdateConfiguration`](/services/playfab/multiplayer/networking/reference/enums/partyoption) 與 [`PartyOption::RegionQualityMeasurementConfiguration`](/services/playfab/multiplayer/networking/reference/enums/partyoption),可進階控制 Party 程式庫執行自動區域探索與連線品質量測的時機與方式。

## 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
  * 最低部署目標 (Minimum Deployment Target) 已從 iOS 10 提高為 iOS 12。
  * 目標部署版本 (Target Deployment Version) 已從 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。
  * 編譯 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 套件在編譯時期新增對 PartyWin.dll 的相依性,而不是在執行階段動態載入平台特定版本的 DLL。PartyWin7.dll 不再包含於 NuGet 中,也不應再作為標題的一部分散發。

## 1.8.5

2023 年 6 月 28 日

### 錯誤修正

* 修正一個錯誤:[`PartyLocalChatControl::SetAudioRenderVolume`](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_setaudiorendervolume) 在 Nintendo Switch、PlayStation®4 與 PlayStation®5 上無法正常運作。

## 1.8.3

2023 年 6 月 2 日

* PlayFab Party 1.8 版已針對 Nintendo Switch 發行,包含自上一個 Nintendo Switch 版本(1.7.15 版)以來的所有錯誤修正與新功能。

## 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,Party 可能會當機。
* 變更對等連線的行為:如果連結非預期中斷,會改回使用中繼連線。先前的行為會將兩部裝置同時中斷網路連線。

## 1.7.20

2023 年 2 月 8 日

### 錯誤修正

* 修正一個錯誤:來自 44.1-kHz 麥克風的音訊可能聽起來失真。
* 改善 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage) 所回報網路錯誤的診斷錯誤訊息。

## 1.7.19

2022 年 11 月 11 日

### 錯誤修正

* 修正在 Linux 上經過特定時間點後無法開啟 Web 要求的錯誤。

## 1.7.17

2022 年 10 月 7 日

### 錯誤修正

* 修正一個錯誤:聊天控制項連線至網路時,在 iOS 上可能發生當機。
* 修正一個錯誤:啟用 iOS 記錄時可能發生當機。

## 1.7.16

2022 年 9 月 27 日

### macOS 的全新 Bundle 版本

* 新增 .bundle,供 Unity 外掛程式載入與原生 macOS 開發使用。

### 錯誤修正

* 修正一個錯誤:啟用 macOS 記錄時可能發生當機。

## 1.7.14

2022 年 8 月 12 日

### 適用於 Linux 與 macOS 的全新 SDK

* 新增 Linux 與 macOS 上 PlayFab Party 的原生支援,讓遊戲開發者能在更多平台上打造跨平台或多平台的即時多人遊戲體驗。如需這些及其他 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 交易時,導致 Web 要求失敗的問題。

## 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 日

### 錯誤修正

* 修正部分 16 kHz 麥克風無法運作的問題。
* 修正 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 平台上沒有啟用麥克風的權限時,產生不正確錯誤代碼的錯誤。
* 修正一個錯誤:狀況不良的裝置除非有其他因素強制重新整理,否則不會重新整理。
* 修正一個錯誤:與傳送通道相關聯的來源端點失效後,對該通道的使用者資料取值 (dereference) 時可能發生當機。
* 修正一個錯誤:如果遠端聊天控制項沒有語言代碼,用戶端會發生無聲失敗。

## 1.5.10

### 錯誤修正

* 修正一個錯誤:由於處理程序的處理器親和性與程式庫的預設執行緒親和性不符,程式庫在某些 Windows 裝置上可能無法初始化。
* 修正一個錯誤:作業因內部 Web 要求失敗而失敗時,程式庫可能不會提供錯誤。
* 修正一個錯誤:啟用直接對等連線能力且程式庫嘗試對另一部裝置建立直接對等連線時,可能發生當機。
* 修正可能導致爆音或音訊失真的錯誤。

## 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:Bluetooth 管理員將在第一次呼叫 `PartyLocalDevice::CreateChatControl()` 時初始化,而不是在呼叫 `PartyManager::Initialize()` 時初始化。
* iOS:修正呼叫 `PartyManager::Initialize()` 時的輕微聲音瑕疵。

## 1.4.13

### Windows 8.1 相依性問題

此版本移除對 api-ms-win-core-version-l1-1-1.dll 的非必要相依性,該相依性導致先前的版本無法在 Windows 8.1 上運作

## 1.4.8

2020 年 4 月 30 日

### TLS1.2

* 轉錄堆疊已更新為在 Windows 7、Android 與 iOS 上使用 TLS1.2。如果您使用其中任何平台,請升級,因為 [Azure Speech Services](https://azure.microsoft.com/updates/azuretls12/) 自 2020 年 9 月起將淘汰 TLS1.1 支援。所有其他平台已支援 TLS1.2,無需升級。

### 錯誤修正

* 修正 `PartyCreateChatControlCompletedStateChange` 結構中 `languageCode` 欄位未填入的錯誤。
* 修正人為誇大 `PartyManager::GetRegions()` 所回報延遲量測值的錯誤。
* 修正允許在不安全的時機呼叫 `PartyManager::SetMemoryCallbacks()` 的錯誤。
* 修正一個錯誤:以位於 `PartyNetwork` 中的 `PartyLocalUser` 呼叫 `PartyManager::DestroyLocalUser()` 時,產生的 `PartyLocalUserRemovedStateChange` 其 removedReason 欄位為不正確的值 `PartyLocalUserRemovedReason::RemoveLocalUser`,而非正確的值 `PartyLocalUserRemovedReason::DestroyLocalUser`。

### 其他變更

* 聊天資料使用的頻寬已降低。
* 在 XBOX 上遇到沙箱問題時,現在會提供更具描述性的錯誤代碼與錯誤訊息。
* 如果提供空白的 PlayFab Title 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 程式庫的相容性。此版本與 1.2.0 版的 XBOX Live Helper 程式庫相容。如需詳細資訊,請見 [XBOX Live Helper 程式庫版本資訊](/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

`PartyStateChangeResult` 值 `TitleCreateNetworkThrottled` 已從 API 中移除,因為 Party 程式庫從未產生此值。

## 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 版本現在為 Party 使用共用物件 (libparty.so),而不是靜態程式庫 (libparty.a)。

此版本也包含 Android 特定的音訊裝置選取錯誤修正。

### iOS 變更

Party 的 iOS 版本現在包含架構套件,可動態載入 libparty,而不是使用靜態建置的 libparty.a。

### 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` 欄位,指出聊天文字的語言。透過 `PartyLocalChatControl::SetTextChatOptions()` 啟用聊天文字翻譯後,便會填入 `languageCode` 欄位。

## 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 Title ID。

“PlayStation” 是 Sony Interactive Entertainment Inc. 的註冊商標或商標。


## Related topics

- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PlayFab Services SDK 2026 版本資訊](/zh-TW/services/playfab/release-notes/index.md)