Crear una sala

Este artículo explica cómo crear una sala.

¿Cómo se crean las salas?

Hay varias formas de crear una sala.

Por sus jugadores: los jugadores que quieran reunir un equipo de jugadores para jugar pueden crear salas. Estas son salas de propiedad del cliente.
Por sus servidores de juegos: los servidores de juegos de su título pueden crear salas y esperar a que los jugadores se unan. Estas son salas de propiedad del servidor.
Por emparejamiento: después de que se forme un grupo de jugadores tras el emparejamiento, se crea una sala como lugar de espera antes de que comience el juego. Estas son salas de propiedad del cliente.

Desde una perspectiva técnica, todas las salas se dividen en dos categorías principales según la propiedad: de propiedad del servidor y de propiedad del cliente. Para obtener más información, consulte Requisitos y privilegios del propietario. El uso general de Lobby de PlayFab es mantener temporalmente unido a un grupo de jugadores. Para conocer las aplicaciones de uso común de Lobby, consulte la información general de Lobby de PlayFab.

Tipos de entidad admitidos

Antes de poder crear una sala, su título debe iniciar sesión como una entidad de PlayFab.

Al crear salas de propiedad del cliente en nombre de sus jugadores, inicie sesión como una entidad title_player_account. Para obtener más información, consulte Conceptos básicos y procedimientos recomendados de inicio de sesión.
Al crear salas de propiedad del servidor en nombre de sus servidores de juegos, inicie sesión como una entidad game_server. Para obtener más información, consulte AuthenticateGameServerWithCustomId.

Cómo se configuran las salas

Varios ajustes importantes de una sala se configuran durante la creación: maxMemberCount, accessPolicy, owner y ownerMigrationPolicy.

maxMemberCount define cuántos jugadores puede contener la sala
accessPolicy define quién puede descubrir la cadena de conexión de la sala
owner define el propietario de la sala, que tiene permisos especiales para actualizar los datos de la sala. Este valor es implícitamente la entidad de cliente o servidor que crea la sala.
ownerMigrationPolicy define las directivas sobre cómo debe transferirse la propiedad de la sala si el propietario actual la abandona o tiene problemas para mantener una conexión con la sala.

Además, durante la creación, el creador de la sala también puede definir propiedades de sala personalizadas y propiedades de búsqueda para anexar datos personalizados a la sesión de la sala. El propietario de la sala también puede modificar estas propiedades personalizadas a lo largo de la vida de la sala. Para obtener más información, consulte Propiedades de la sala.

Ejemplo de creación de una sala de propiedad del cliente mediante el SDK de Lobby y Matchmaking

Este ejemplo usa un jugador local que ha iniciado sesión en PlayFab como una entidad title_player_account. En este fragmento de código, las propiedades de la sala se pasan como lobbyConfiguration y el jugador que crea la sala pasa sus propiedades de miembro iniciales mediante creatorMemberConfiguration. El jugador local se convierte en el propietario de la sala, por lo que se trata de una sala de propiedad del cliente. Después de crear correctamente la sala, se puede usar el PFLobbyHandle para invitar a otros jugadores con PFLobbySendInvite.

    // Retrieved elsewhere from SDK's PFMultiplayerInitialize API
    PFMultiplayerHandle apiHandle = g_pfmHandle;

    // Retrieved elsewhere from one of PlayFab's title_player_account login APIs
    const PFEntityKey* clientOwner = m_localPlayerTitlePlayerAccounts[0];

    // Initialize the lobby configuration
    const char* gameModePropertyKey = "GameMode";
    const char* gameModePropertyValue = "GameMode_Foo";

    PFLobbyCreateConfiguration lobbyConfiguration{};
    lobbyConfiguration.maxMemberCount = 16;
    lobbyConfiguration.ownerMigrationPolicy = PFLobbyOwnerMigrationPolicy::Automatic;
    lobbyConfiguration.accessPolicy = PFLobbyAccessPolicy::Private;
    lobbyConfiguration.lobbyPropertyCount = 1;
    lobbyConfiguration.lobbyPropertyKeys = &gameModePropertyKey;
    lobbyConfiguration.lobbyPropertyValues = &gameModePropertyValue;
    
    // Initialize the creator's member properties
    const char* playerColorPropertyKey = "PlayerColor";
    const char* playerColorPropertyValue = "Red";

    PFLobbyJoinConfiguration creatorMemberConfiguration{};
    creatorMemberConfiguration.memberPropertyCount = 1;
    creatorMemberConfiguration.memberPropertyKeys = &playerColorPropertyKey;
    creatorMemberConfiguration.memberPropertyValues = &playerColorPropertyValue;

    // Create a lobby using our first player
    PFLobbyHandle lobby;
    HRESULT error = PFMultiplayerCreateAndJoinLobby(
        apiHandle,
        clientOwner,
        &lobbyConfiguration,
        &creatorMemberConfiguration,
        nullptr,
        &lobby);

Cuando se completa la llamada para crear una sala, PFMultiplayerStartProcessingLobbyStateChanges proporcionará un PFLobbyCreateAndJoinLobbyCompletedStateChange.

Ejemplo de creación de una sala de propiedad del servidor mediante el SDK de Lobby y Matchmaking

Este ejemplo es similar al ejemplo de sala de propiedad del cliente, excepto que crea la sala como una entidad game_server y se llama a PFMultiplayerCreateAndClaimServerLobby en lugar de PFMultiplayerCreateAndJoinLobby.

    // Retrieved elsewhere from SDK's PFMultiplayerInitialize API
    PFMultiplayerHandle apiHandle = g_pfmHandle;

    // Retrieved elsewhere from one of PlayFab's game_server login APIs
    const PFEntityKey* serverOwner = m_gameServerEntityKey;

    const char* gameModePropertyKey = "GameMode";
    const char* gameModePropertyValue = "GameMode_Foo";
    
    // Initialize the lobby configuration
    PFLobbyCreateConfiguration lobbyConfiguration{};
    lobbyConfiguration.maxMemberCount = 16;
    lobbyConfiguration.ownerMigrationPolicy = PFLobbyOwnerMigrationPolicy::Automatic;
    lobbyConfiguration.accessPolicy = PFLobbyAccessPolicy::Public;
    lobbyConfiguration.lobbyPropertyCount = 1;
    lobbyConfiguration.lobbyPropertyKeys = &gameModePropertyKey;
    lobbyConfiguration.lobbyPropertyValues = &gameModePropertyValue;
    
    // Create a lobby using our first player
    PFLobbyHandle lobby;
    HRESULT error = PFMultiplayerCreateAndClaimServerLobby(
        apiHandle,
        serverOwner,
        &lobbyConfiguration,
        nullptr,
        &lobby);

Cuando se completa la llamada para crear una sala, PFMultiplayerStartProcessingLobbyStateChanges proporcionará un PFLobbyCreateAndClaimServerLobbyCompletedStateChange. Para obtener más información sobre las diferencias entre las salas de propiedad del cliente y las salas de propiedad del servidor, consulte Servidores de juegos y salas.

Para habilitar las API de servidor de juegos en PlayFab Multiplayer, debe definir PFMULTIPLAYER_INCLUDE_SERVER_APIS antes de incluir PFLobby.h. Para obtener más información, consulte Servidores de juegos y salas

XBOX Services

PlayFab

¿Cómo se crean las salas?

Tipos de entidad admitidos

Cómo se configuran las salas

Ejemplo de creación de una sala de propiedad del cliente mediante el SDK de Lobby y Matchmaking

Ejemplo de creación de una sala de propiedad del servidor mediante el SDK de Lobby y Matchmaking

Consulte también

​¿Cómo se crean las salas?

​Tipos de entidad admitidos

​Cómo se configuran las salas

​Ejemplo de creación de una sala de propiedad del cliente mediante el SDK de Lobby y Matchmaking

​Ejemplo de creación de una sala de propiedad del servidor mediante el SDK de Lobby y Matchmaking

​Consulte también

¿Cómo se crean las salas?

Tipos de entidad admitidos

Cómo se configuran las salas

Ejemplo de creación de una sala de propiedad del cliente mediante el SDK de Lobby y Matchmaking

Ejemplo de creación de una sala de propiedad del servidor mediante el SDK de Lobby y Matchmaking

Consulte también