Visão geral do Multiplayer Manager

​

Principais recursos

• Gerenciamento de sessões e matchmaking dos serviços do XBOX simplificados
• Modelo de programação baseado em estado e em eventos
• Garante as práticas recomendadas dos serviços do XBOX, além de estar em conformidade com os XRs de Multiplayer
• Implementa os fluxogramas do Multiplayer 2015

• Sessões grandes do MPSD (mais de 100 membros) não são compatíveis.
• Destina-se apenas a designs multiplayer hospedados por pares. Títulos com servidores dedicados devem usar o serviço Multiplayer Activity ou as APIs do serviço Multiplayer e chamadas de serviço para serviço (tópico sob NDA).

​

Visão geral

• Sessão de lobby: uma sessão persistente usada para gerenciar os usuários locais do dispositivo e os amigos convidados que desejam jogar juntos. O grupo pode jogar o jogo; por exemplo, várias rodadas, mapas e níveis. A sessão de lobby acompanha esse grupo principal de amigos (incluindo os jogadores locais do dispositivo). Normalmente, esse grupo é formado enquanto o host navega pelos menus e conversa com os membros do grupo para decidir qual modo de jogo desejam jogar.
• Sessão de jogo: acompanha os jogadores que estão jogando uma instância específica do jogo. Por exemplo, uma corrida, um mapa ou um nível. Você pode criar uma nova sessão de jogo por meio de XblMultiplayerManagerJoinGameFromLobby que inclua os membros da sessão de lobby. Quando um membro aceita um convite, ele é adicionado ao lobby e à sessão de jogo (se houver espaço). Jogadores adicionais podem ser adicionados à sessão de jogo se o matchmaking estiver habilitado, mas esses jogadores adicionais não são adicionados à sessão de lobby. Isso significa que, quando o jogo termina, os jogadores da sessão de lobby continuam juntos, enquanto os jogadores extras do matchmaking não.
• XblMultiplayerManagerMember: representa um usuário individual conectado em um dispositivo local ou remoto.
• XblMultiplayerManagerDoWork: garante que as atualizações adequadas do estado do jogo sejam mantidas entre o título e o serviço Multiplayer dos serviços do XBOX. Para garantir o melhor desempenho, XblMultiplayerManagerDoWork deve ser chamado com frequência, por exemplo, uma vez por quadro. XblMultiplayerManagerDoWork fornece uma matriz de eventos de retorno de chamada XblMultiplayerEvent para o jogo tratar.

​

Máquina de estado

​

Threading

​

Atualização do modelo baseado em estado

​

Eventos e notificações

​

API C simples

size_t eventCount{ 0 };
const XblMultiplayerEvent* events{ nullptr };
HRESULT hr = XblMultiplayerManagerDoWork(&events, &eventCount);
if (FAILED(hr))
{
    // Handle failure.
}

for (auto i = 0u; i < eventCount; ++i)
{
    switch (events[i].EventType)
    {
        case XblMultiplayerEventType::MemberJoined:
        {
            // Handle MemberJoined.
            size_t memberCount = 0;
            hr = XblMultiplayerEventArgsMembersCount(events[i].EventArgsHandle, &memberCount);
            assert(SUCCEEDED(hr));

            std::vector<XblMultiplayerManagerMember> members(memberCount);
            hr = XblMultiplayerEventArgsMembers(events[i].EventArgsHandle, memberCount, members.data());
            assert(SUCCEEDED(hr));
            ...

            break;
        }

        case XblMultiplayerEventType::SessionPropertyChanged:
        {
            // Handle SessionPropertyChanged.
            const char* changedProperty{ nullptr };
            hr = XblMultiplayerEventArgsPropertiesJson(events[i].EventArgsHandle, &changedProperty);
            assert(SUCCEEDED(hr));
            ...

            break;
        }
        ...
    }
}

• XblMultiplayerEvent
• XblMultiplayerEventArgsMembers
• XblMultiplayerEventArgsMembersCount
• XblMultiplayerEventArgsPropertiesJson
• XblMultiplayerEventType
• XblMultiplayerManagerDoWork
• XblMultiplayerManagerMember

​

Cenários

• Habilitar jogos multiplayer com amigos usando o Multiplayer Manager
• Encontrando um jogo multiplayer usando o SmartMatch com o Multiplayer Manager
• Enviando convites de jogo usando o Multiplayer Manager
• Tratando a ativação de protocolo para iniciar um jogo usando o Multiplayer Manager

​

O que o Multiplayer Manager não faz

• Jogos em servidores online persistentes, como jogos multiplayer massivos online (MMO), ou outros tipos de jogos que exigem sessões grandes (mais de 100 jogadores em uma sessão)
• Gerenciamento de sessões de servidor para servidor
• Limitação de chamadas do MPSD para respeitar a limitação de taxa refinada
• Mistura das APIs do serviço Multiplayer com as APIs do Multiplayer Manager

​

Recursos