Skip to main content
ロビーの共有部分に対する更新の要求。

構文

メンバー

newOwner   const PFEntityKey*
nullptr の場合があります
ロビーの新しい所有者 (省略可能)。 この値は、以下のいずれかの条件でのみ更新できます。
  • このフィールドを更新するメンバーがロビーの現在の所有者である
  • オーナー移行ポリシーが PFLobbyOwnerMigrationPolicy::Manual で、かつ現在所有者が存在しない
  • オーナー移行ポリシーが PFLobbyOwnerMigrationPolicy::None である

    このロビーがクライアント所有 (現在の所有者が title_player_account エンティティ) の場合、新しい所有者も title_player_account エンティティである必要があります。このロビーがサーバー所有 (現在の所有者が game_server エンティティ) の場合、新しい所有者も game_server エンティティである必要があります。
maxMemberCount   const uint32_t*
nullptr の場合があります
このロビーのメンバー数容量の更新値 (省略可能)。 この新しい値は、現在ロビーに参加しているメンバー数より大きく、かつ PFLobbyMaxMemberCountUpperLimit 未満である必要があります。

この値は、現在のロビー所有者のみが更新できます。
accessPolicy   const PFLobbyAccessPolicy*
nullptr の場合があります
このロビーに対する更新済みのアクセス ポリシー (省略可能)。 この値は、現在のロビー所有者のみが更新できます。 membershipLock   const PFLobbyMembershipLock*
nullptr の場合があります
このロビーのメンバーシップ ロックに対する更新 (省略可能)。 この値は、現在のロビー所有者のみが更新できます。 searchPropertyCount   uint32_t 更新する検索プロパティの数。 検索プロパティを更新できるのは、現在のロビー所有者のみです。

同時に存在できる検索プロパティは、任意の時点で PFLobbyMaxSearchPropertyCount 件までです。したがって、そのうち半数のプロパティを削除する場合、この更新で指定できる一意なプロパティの数は最大でその 2 倍となります。

プロパティの上限に違反した場合、更新操作全体が失敗します。
searchPropertyKeys   const char* const*
サイズ searchPropertyCount の配列
更新する検索プロパティのキー。 ロビー プロパティを更新できるのは、現在のロビー所有者のみです。

検索プロパティは、ロビーのメンバー以外にも、ロビー検索結果の絞り込みや並べ替えに使えるメタデータとして参照できます。

更新されるのは、このキーの一覧で指定したプロパティのみです。キーがまだ存在しない場合はプロパティが作成されます。新しいプロパティ値が nullptr の場合はプロパティが削除されます。この一覧から外れた既存のプロパティは変更されません。

検索プロパティは、string_keyN または number_keyN の形式である必要があります。ここで “N” は 1 以上 PFLobbyMaxSearchPropertyCount 以下の数値です (例: string_key1、number_key14 など)。
searchPropertyValues   const char* const*
サイズ searchPropertyCount の配列
更新する検索プロパティの値。 検索プロパティを更新できるのは、現在のロビー所有者のみです。

検索プロパティは、ロビーのメンバー以外にも、ロビー検索結果の絞り込みや並べ替えに使えるメタデータとして参照できます。

値を削除するには、新しい値として nullptr を指定します。
lobbyPropertyCount   uint32_t 更新するロビー プロパティの数。 ロビー プロパティを更新できるのは、現在のロビー所有者のみです。

同時に存在できるロビー プロパティは、任意の時点で PFLobbyMaxLobbyPropertyCount 件までです。したがって、そのうち半数のプロパティを削除する場合、この更新で指定できる一意なプロパティの数は最大でその 2 倍となります。

プロパティの上限に違反した場合、更新操作全体が失敗します。
lobbyPropertyKeys   const char* const*
サイズ lobbyPropertyCount の配列
更新するロビー プロパティのキー。 ロビー プロパティを更新できるのは、現在のロビー所有者のみです。

ロビー プロパティは、ロビーのメンバーのみから参照できます。

更新されるのは、このキーの一覧で指定したプロパティのみです。キーがまだ存在しない場合はプロパティが作成されます。新しいプロパティ値が nullptr の場合はプロパティが削除されます。この一覧から外れた既存のプロパティは変更されません。
lobbyPropertyValues   const char* const*
サイズ lobbyPropertyCount の配列
更新するロビー プロパティの値。 ロビー プロパティを更新できるのは、現在のロビー所有者のみです。

ロビー プロパティは、ロビーのメンバーのみから参照できます。

値を削除するには、新しい値として nullptr を指定します。
restrictInvitesToLobbyOwner   const bool*
nullptr の場合があります
ロビー オーナーのみがロビー参加への招待を送信できるかどうかを示すポリシーに対する更新 (省略可能)。 true の場合は、ロビー オーナーのみが招待を送信できます。false の場合は、任意のメンバーが招待を送信できます。true に設定できるのは、クライアント所有のロビーの場合のみです。

解説

ロビーの共有部分にあるほとんどのデータは、所有者のみが更新できます。詳細は各フィールドのドキュメントで確認してください。

要件

ヘッダー: PFLobby.h

関連項目

PFLobby メンバー
最終更新日 2026年8月13日