Passer au contenu principal
Demande de mise à jour de la partie partagée du lobby.

Syntaxe

Membres

newOwner   const PFEntityKey*
peut être nullptr
Nouveau propriétaire facultatif du lobby. Cette valeur ne peut être mise à jour que dans l’une des conditions suivantes :
  • Le membre qui met à jour ce champ est le propriétaire actuel du lobby
  • La stratégie de migration du propriétaire est PFLobbyOwnerMigrationPolicy::Manual et il n’y a actuellement aucun propriétaire
  • La stratégie de migration du propriétaire est PFLobbyOwnerMigrationPolicy::None

    Si ce lobby est détenu par un client (le propriétaire actuel est une entité title_player_account), le nouveau propriétaire doit également être une entité title_player_account. Si ce lobby est détenu par un serveur (le propriétaire actuel est une entité game_server), le nouveau propriétaire doit également être une entité game_server.
maxMemberCount   const uint32_t*
peut être nullptr
Capacité mise à jour facultative pour le nombre de membres de ce lobby. Cette nouvelle valeur doit être supérieure au nombre de membres actuellement présents dans le lobby et inférieure à PFLobbyMaxMemberCountUpperLimit.

Cette valeur ne peut être mise à jour que par le propriétaire actuel du lobby.
accessPolicy   const PFLobbyAccessPolicy*
peut être nullptr
Stratégie d’accès mise à jour facultative pour ce lobby. Cette valeur ne peut être mise à jour que par le propriétaire actuel du lobby. membershipLock   const PFLobbyMembershipLock*
peut être nullptr
Mise à jour facultative du verrouillage d’appartenance de ce lobby. Cette valeur ne peut être mise à jour que par le propriétaire actuel du lobby. searchPropertyCount   uint32_t Nombre de propriétés de recherche à mettre à jour. Seul le propriétaire actuel du lobby peut mettre à jour les propriétés de recherche.

Il ne peut y avoir que PFLobbyMaxSearchPropertyCount propriétés de recherche simultanées à tout moment. Par conséquent, au maximum deux fois plus de propriétés uniques peuvent être spécifiées dans cette mise à jour si la moitié d’entre elles sont supprimées.

Si les limites de propriétés ne sont pas respectées, l’ensemble de l’opération de mise à jour échoue.
searchPropertyKeys   const char* const*
tableau de taille searchPropertyCount
Clés des propriétés de recherche à mettre à jour. Seul le propriétaire actuel du lobby peut mettre à jour les propriétés du lobby.

Les propriétés de recherche sont visibles par les non-membres du lobby en tant que métadonnées, qui peuvent être utilisées pour filtrer et trier les résultats de recherche de lobbies.

Seules les propriétés spécifiées dans cette liste de clés sont mises à jour. Si la clé n’existe pas encore, la propriété est créée. Si la nouvelle valeur de la propriété est nullptr, la propriété est supprimée. Les propriétés existantes omises de cette liste restent inchangées.

Les propriétés de recherche doivent être de la forme string_keyN ou number_keyN, où « N » est un nombre compris entre 1 et PFLobbyMaxSearchPropertyCount. Par exemple, string_key1, number_key14, etc.
searchPropertyValues   const char* const*
tableau de taille searchPropertyCount
Valeurs des propriétés de recherche à mettre à jour. Seul le propriétaire actuel du lobby peut mettre à jour les propriétés de recherche.

Les propriétés de recherche sont visibles par les non-membres du lobby en tant que métadonnées, qui peuvent être utilisées pour filtrer et trier les résultats de recherche de lobbies.

Pour supprimer une valeur, indiquez nullptr comme nouvelle valeur.
lobbyPropertyCount   uint32_t Nombre de propriétés du lobby à mettre à jour. Seul le propriétaire actuel du lobby peut mettre à jour les propriétés du lobby.

Il ne peut y avoir que PFLobbyMaxLobbyPropertyCount propriétés de lobby simultanées à tout moment. Par conséquent, au maximum deux fois plus de propriétés uniques peuvent être spécifiées dans cette mise à jour si la moitié d’entre elles sont supprimées.

Si les limites de propriétés ne sont pas respectées, l’ensemble de l’opération de mise à jour échoue.
lobbyPropertyKeys   const char* const*
tableau de taille lobbyPropertyCount
Clés des propriétés du lobby à mettre à jour. Seul le propriétaire actuel du lobby peut mettre à jour les propriétés du lobby.

Les propriétés du lobby ne sont visibles que par les membres du lobby.

Seules les propriétés spécifiées dans cette liste de clés sont mises à jour. Si la clé n’existe pas encore, la propriété est créée. Si la nouvelle valeur de la propriété est nullptr, la propriété est supprimée. Les propriétés existantes omises de cette liste restent inchangées.
lobbyPropertyValues   const char* const*
tableau de taille lobbyPropertyCount
Valeurs des propriétés du lobby à mettre à jour. Seul le propriétaire actuel du lobby peut mettre à jour les propriétés du lobby.

Les propriétés du lobby ne sont visibles que par les membres du lobby.

Pour supprimer une valeur, indiquez nullptr comme nouvelle valeur.
restrictInvitesToLobbyOwner   const bool*
peut être nullptr
Mise à jour facultative de la stratégie indiquant si seul le propriétaire du lobby peut envoyer des invitations à le rejoindre. Si la valeur est true, seul le propriétaire du lobby peut envoyer des invitations. Si elle est false, n’importe quel membre peut en envoyer. Ne peut être true que pour les lobbies détenus par un client.

Remarques

La plupart des données de la partie partagée du lobby ne peuvent être mises à jour que par le propriétaire. Consultez la documentation de chaque champ pour confirmation.

Configuration requise

En-tête : PFLobby.h

Voir aussi

Membres de PFLobby
Dernière modification le 8 octobre 2026