Criar um lobby

Este artigo explica como criar um lobby.

Como os lobbies são criados?

Há várias formas de criar um lobby.

Pelos seus jogadores: os lobbies podem ser criados por jogadores que querem reunir uma equipe de jogadores para jogar. Esses são lobbies pertencentes ao cliente.
Pelos seus servidores de jogo: os servidores de jogo do seu título podem criar lobbies e aguardar que os jogadores ingressem. Esses são lobbies pertencentes ao servidor.
Pelo matchmaking: depois que um grupo de jogadores é formado após o matchmaking, um lobby é criado como local de espera antes do início do jogo. Esses são lobbies pertencentes ao cliente.

Do ponto de vista técnico, todos os lobbies se enquadram em duas categorias principais com base na propriedade: pertencentes ao servidor e pertencentes ao cliente. Para saber mais, consulte Requisitos e privilégios do proprietário. O uso geral do PlayFab Lobby é manter temporariamente um grupo de jogadores juntos. Para conhecer as aplicações mais comuns do Lobby, consulte a visão geral do PlayFab Lobby.

Tipos de entidade compatíveis

Antes que um lobby possa ser criado, seu título precisa fazer login como uma entidade do PlayFab.

Ao criar lobbies pertencentes ao cliente em nome dos seus jogadores, faça login como uma entidade title_player_account. Para obter mais informações, consulte Noções básicas e práticas recomendadas de login.
Ao criar lobbies pertencentes ao servidor em nome dos seus servidores de jogo, faça login como uma entidade game_server. Para obter mais informações, consulte AuthenticateGameServerWithCustomId.

Como os lobbies são configurados

Várias configurações importantes de um lobby são definidas durante a criação: maxMemberCount, accessPolicy, owner e ownerMigrationPolicy.

maxMemberCount define quantos jogadores o lobby pode comportar
accessPolicy define quem pode descobrir a cadeia de conexão do lobby
owner define o proprietário do lobby, que tem permissões especiais para atualizar os dados do lobby. Esse valor é, implicitamente, a entidade de cliente ou de servidor que está criando o lobby.
ownerMigrationPolicy define políticas sobre como a propriedade do lobby deve ser transferida se o proprietário atual sair do lobby ou tiver problemas para manter a conexão com o lobby.

Além disso, durante a criação, o criador do lobby também pode definir propriedades personalizadas do lobby e propriedades de pesquisa para anexar dados personalizados à sessão do lobby. Essas propriedades personalizadas também podem ser modificadas pelo proprietário do lobby ao longo da vida útil do lobby. Para obter mais informações, consulte Propriedades do lobby.

Exemplo de criação de um lobby pertencente ao cliente usando o SDK de Lobby e Matchmaking

Este exemplo usa um jogador local que fez login no PlayFab como uma entidade title_player_account. Neste trecho de código, as propriedades do lobby são passadas como lobbyConfiguration, e o jogador que está criando o lobby passa suas propriedades iniciais de membro por meio de creatorMemberConfiguration. O jogador local se torna o proprietário do lobby, portanto é um lobby pertencente ao cliente. Depois que o lobby é criado com êxito, o PFLobbyHandle pode ser usado para convidar outros jogadores com 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);

Quando a chamada para criar um lobby for concluída, uma PFLobbyCreateAndJoinLobbyCompletedStateChange será fornecida por PFMultiplayerStartProcessingLobbyStateChanges.

Exemplo de criação de um lobby pertencente ao servidor usando o SDK de Lobby e Matchmaking

Este exemplo é semelhante ao exemplo de lobby pertencente ao cliente, exceto que cria o lobby como uma entidade game_server e chama PFMultiplayerCreateAndClaimServerLobby em vez 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);

Quando a chamada para criar um lobby for concluída, uma PFLobbyCreateAndClaimServerLobbyCompletedStateChange será fornecida por PFMultiplayerStartProcessingLobbyStateChanges. Para obter mais informações sobre as diferenças entre lobbies pertencentes ao cliente e lobbies pertencentes ao servidor, consulte Servidores de jogo e lobbies.

Para habilitar as APIs de servidor de jogo no PlayFab Multiplayer, você precisa definir PFMULTIPLAYER_INCLUDE_SERVER_APIS antes de incluir PFLobby.h. Para obter mais informações, consulte Servidores de jogo e lobbies

XBOX Services

PlayFab

Como os lobbies são criados?

Tipos de entidade compatíveis

Como os lobbies são configurados

Exemplo de criação de um lobby pertencente ao cliente usando o SDK de Lobby e Matchmaking

Exemplo de criação de um lobby pertencente ao servidor usando o SDK de Lobby e Matchmaking

Confira também

​Como os lobbies são criados?

​Tipos de entidade compatíveis

​Como os lobbies são configurados

​Exemplo de criação de um lobby pertencente ao cliente usando o SDK de Lobby e Matchmaking

​Exemplo de criação de um lobby pertencente ao servidor usando o SDK de Lobby e Matchmaking

​Confira também

Como os lobbies são criados?

Tipos de entidade compatíveis

Como os lobbies são configurados

Exemplo de criação de um lobby pertencente ao cliente usando o SDK de Lobby e Matchmaking

Exemplo de criação de um lobby pertencente ao servidor usando o SDK de Lobby e Matchmaking

Confira também