XDK および Windows 7 プラットフォームのサポートは 2023 年 8 月 1 日に終了しました。これらのプラットフォーム向けの PlayFab Party ライブラリの新しい更新はリリースされません。PlayFab Party のネットワーキングと音声サービスは引き続き動作し、現在 Windows 7 または XDK バージョンの PlayFab Party ライブラリを使用しているタイトルへの影響はありません。
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: 音声認識 (STT) およびその他の 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: in-proc GRTS を使用する環境のサポートを追加しました。
- GDK:
PartyAudioDeviceSelectionType::SystemDefaultのサポートを追加しました。
バグ修正
- マルチネットワーク遷移シナリオで発生する可能性のあるクラッシュを修正しました。
1.10.15
2025 年 12 月 17 日- Nintendo Switch 2: Web 要求に対して 10 秒のタイムアウトを追加しました。
1.10.14
2025 年 12 月 9 日PartyNetwork::CreateEndpointの PartyStatusChangeResult の動作を変更し、トークンの期限切れ前に発生する一時的エラーにはPartyServiceErrorを返し、トークンが期限切れの場合にのみUserNotAuthorizedを返すようにしました。- Android: 新しい Android ページ サイズ要件 を満たすため、16 KB ページ サイズのサポートを追加しました。
1.10.13
2025 年 10 月 14 日- iOS 26 でマイクが正常に機能しない問題を修正しました。
- Apple: iOS 上での Arm64.xcframework のサポートを追加しました。
1.10.12
2025 年 10 月 6 日PartyNetwork::CreateEndpointの PartyStatusChangeResult の動作を変更し、トークンの期限切れ前に発生する一時的エラーにはPartyServiceErrorを返し、トークンが期限切れの場合にのみUserNotAuthorizedを返すようにしました。- Android: 新しい Android ページ サイズ要件 を満たすため、16 KB ページ サイズのサポートを追加しました。
- Apple: iOS での Arm64 シミュレーター ビルドのサポートを追加しました。
バグ修正
- PartyManager::Cleanup が呼び出されたときにライブラリがクラッシュする可能性のある問題を修正しました。
- Apple: iOS 上での中断後のマイク フォーカス回復のためのリトライ ロジックを追加しました。
- Apple: Party の音声チャットと文字起こし中に発生する可能性のあるメモリ リークを修正しました。
- Apple: 複数のリモート プレイヤーが異なるプラットフォーム間で接続されているときに PartyLocalChatControl でフリーズする可能性のある問題を修正しました。
- Apple: iOS での Arm64 シミュレーター ビルドのサポートを追加しました。
1.10.9
2025 年 3 月 11 日- Nintendo Switch: ロギングが有効な状態でライブラリの出荷バリアントの 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 上でフレームワークの破損したシンボリック リンクを修正しました。
- 非 Windows プラットフォームで SDK ログを収集する際のログ例外の処理を改善しました。
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 日バグ修正
- 3 つ以上のデバイスがあるネットワークでダイレクト ピア接続を確立するときにライブラリがクラッシュする可能性のある問題を修正しました。
1.10.0
2024 年 8 月 5 日game_serverエンティティのサポートを追加し、サーバーが SDK を介して Party ネットワークに接続し、ゲーム クライアントによって安全に識別されるようにしました。AuthenticateGameServerWithCustomIdを介してgame_serverエンティティを認証した後、PartyManager::CreateLocalUserWithEntityType を介してローカル ユーザーとして追加できます。- ライブラリ内の各エンティティに関連付けられたエンティティ タイプを判別するためのメソッドを追加しました。詳細については、PartyLocalUser::GetEntityType、PartyEndpoint::GetEntityType、および PartyChatControl::GetEntityType を参照してください。
title_playerエンティティとgame_serverエンティティ間のダイレクト ピア接続を有効にする一方で、title_playerエンティティと他のtitle_playerエンティティ間のダイレクト ピア接続を許可しないダイレクト ピア接続オプションを追加しました。詳細については、PartyDirectPeerConnectivityOptions::OnlyServers を参照してください。- フィルターに基づくエンドポイントの便利なリストを取得するメソッドを追加しました。詳細については、PartyNetwork::GetEndpointsByUserType を参照してください。
- PlayStation®4 および PlayStation®5 上の PlayFab Party で使用されているサードパーティ ライブラリで既定のアロケーターを使用していたメモリ割り当てが、Party のメモリ コールバックを使用するように更新されました。PartyManager::SetMemoryCallbacks を使用してタイトル固有のメモリ割り当て関数を構成しているタイトルは、これらの割り当てを認識し、制御できるようになります。
バグ修正
- プロセスの終了中に Windows または XBOX でライブラリがクラッシュする可能性のある問題を修正しました。
- 非 Windows プラットフォームで、以前の接続試行が特定のケースで失敗した後にダイレクト ピア接続が誤って失敗する問題に対処しました。
- Party ネットワークの繰り返しの作成と破棄中に DestroyNetwork イベントが発生しない問題を修正しました。
既知の問題
- 3 つ以上のデバイスがあるネットワークでダイレクト ピア接続を確立するときにライブラリが時折クラッシュすることがあります。
1.9.5
2024 年 5 月 3 日- 接続共有などの機能を使用している Windows デバイスによる PartyRegionsChangedStateChange およびその他の操作で報告される断続的な致命的エラーに対処しました。
- Party の使用を開始してすぐにプロセスがシャットダウンした場合に Windows と XBOX で発生する可能性のあるクラッシュを修正しました。
PartyChatControlリソースが PartyLocalDevice::DestroyChatControl を呼び出した後に解放されず、PartyManager::Cleanup を呼び出した後にのみ解放されることがあるバグを修正しました。- Android: Party と Multiplayer が同じアプリで使用されているときの重複クラス エラーを解決しました。
1.9.4
2024 年 3 月 20 日- コンソールの言語としてウクライナ語が設定されている PlayStation®4 および PlayStation®5 で
PartyLocalDevice::CreateChatControlが失敗するバグを修正しました。
1.9.3
2024 年 3 月 14 日- 音声認識 (STT) が有効なときに発生する可能性のある 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 に引き上げられました。
- コンパイル 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 向けにリリースされ、前回の 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を参照してください。 - iOS、Android: ローカル チャット コントロールからキャプチャされたオーディオでノイズ抑制を有効にするサポートを追加しました。詳細については、
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() によって報告されるネットワーク エラーの診断エラー メッセージを改善しました。
1.7.19
2022 年 11 月 11 日バグ修正
- Linux 上で一定の時間経過後に Web 要求を開くことに失敗するバグを修正しました。
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 リリースへのリンクについては、PlayFab Party SDK を参照してください。
- PlayFab Party for Linux を導入します
1.7.11
2022 年 6 月 24 日バグ修正
PartyManager::Cleanup()の呼び出し後も 1 つのメモリ割り当てが残る問題を修正しました。
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: 2 つのワーカー スレッドを削除し、関連する作業を既存の低頻度作業スレッド上で実行するようにしました。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を参照してください。このリリースでは、コールバックは Windows、XBOX One XDK、および Microsoft Game Core プラットフォームでのみサポートされています。 - 新しい NoRemoteInput および RemoteAudioInputMuted チャット コントロール インジケーターは、現在無音のオーディオ状態についての詳細な粒度を提供します。詳細については、
PartyChatControlChatIndicatorを参照してください。
エンドポイント メッセージ動作の改善
- ‘PartySendMessageQueuingConfiguration’ の
timeoutInMillisecondsフィールドは、リモート ターゲットのネットワーク状態や応答性の違いにより転送前にメッセージをキューイングせざるを得ない場合、透過的クラウド リレーによっても評価されるようになりました。 - ネットワークに完全に認証されている場合、0 エントリの配列に送信すると、ライブラリがその時点でネットワーク内で報告する正確なリモート エンドポイントのセットに正しくターゲットされます。メッセージが送信中に作成されているエンドポイントは、含まれる可能性がなくなりました。
1.6.1
バグ修正
- チャット コントロールがネットワークに接続する際に、同じチャット コントロールが別のネットワークから切断中である場合にクラッシュが発生する可能性のあるバグを修正しました。
1.6.0
2021 年 4 月 12 日新しいスレッド制御とテキスト モデレーション機能
- ライブラリの作業を、ゲームが制御するスレッド上で手動で実行できるようになりました。詳細については、
PartyManager::SetWorkModeを参照してください。 - 不快なテキスト チャットをオプションでフィルタリングできるようになりました。詳細については、テキスト モデレーションの使用 を参照してください。
ヘッダーでの明示的な enum 番号付け
- ヘッダー内の enum 値に明示的な番号が付けられるようになりました。
1.5.13
2021 年 3 月 26 日バグ修正
- Bluetooth ヘッドセットを使用している iOS デバイスでオーディオが途切れるバグを修正しました。
- Windows プラットフォームでアプリにマイクをアクティブ化する権限がないときに誤ったエラー コードが生成されるバグを修正しました。
- 他のリフレッシュが強制されない限り、正常でないデバイスがリフレッシュされないバグを修正しました。
- そのチャネルに関連付けられたソース エンドポイントが無効になった後、送信チャネルのユーザー データを逆参照する際にクラッシュが発生する可能性のあるバグを修正しました。
- リモート チャット コントロールに言語コードがない場合、クライアントがサイレント失敗するバグを修正しました。
1.5.10
バグ修正
- プロセスのプロセッサ アフィニティとライブラリの既定のスレッド アフィニティが一致しないため、一部の Windows デバイスでライブラリの初期化に失敗するバグを修正しました。
- 内部 Web 要求の失敗により操作が失敗した場合にライブラリがエラーを提供しないバグを修正しました。
- ダイレクト ピア接続が有効になっており、ライブラリが別のデバイスに対してダイレクト ピア接続を確立しようとしたときにクラッシュが発生する可能性のあるバグを修正しました。
- パチパチとした音や歪んだオーディオを引き起こす可能性のあるバグを修正しました。
1.5.1
2020 年 9 月 5 日バグ修正
- iOS でライブラリがマイクをアクティブ化できないバグを修正しました。
1.5.0
新しいダイレクト ピアツーピア接続、レイテンシ、および音声認識機能
- ダイレクト ピアツーピア接続が、Windows 10 および Microsoft Game Core 版のライブラリでサポートされるようになりました。詳細については、ダイレクト ピアツーピア接続の使用 を参照してください。
- ローカル デバイスとリモート デバイス間のラウンドトリップ レイテンシをライブラリを介して照会できるようになりました。詳細については、
PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMillisecondsを参照してください。 - 音声認識の冒とく的な表現のマスキングを無効化できるようになりました。詳細については、
PartyVoiceChatTranscriptionOptions::DisableProfanityMaskingを参照してください。
Android と iOS のオーディオ バグ修正
- Android: Bluetooth マネージャーは、
PartyManager::Initialize()が呼び出されたときではなく、PartyLocalDevice::CreateChatControl()が初めて呼び出されたときに初期化されます。 - 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()を呼び出すと、PartyLocalUserRemovedStateChangeの removedReason フィールドに正しい値PartyLocalUserRemovedReason::DestroyLocalUserではなく、誤った値PartyLocalUserRemovedReason::RemoveLocalUserが生成されるバグを修正しました。
その他の変更
- チャット データによって使用される帯域幅が削減されました。
- 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 ライブラリのリリース ノート を参照してください。
- 各文字起こしの状態変更は、テキスト読み上げまたはマイク オーディオのどちらを表すかを示すようになりました。詳細については、
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 は、Party ライブラリがこれを生成することがないため、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 パッケージには、2 つの新しい 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 ライブラリの両方がエンティティ トークンを取得すると、2 セットのトークンを管理するために不要なサービス負荷が発生します。
チャット 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 から削除されました。オープンな招待を作成したり、Party ネットワークへのアクセスを特定の PlayFab ユーザーに付与したりするには、新しいPartyInvitationクラスと関連メソッドを使用します。
0.4.6-prerelease
API の変更
新しいパブリック APIPartyLocalUser::UpdateEntityToken() を追加しました。
0.2.0-prerelease
API の変更
PartyManager::Initializeは、有効な PlayFab タイトル ID を渡す必要があります。
