Visão geral do Multiplayer Session Directory

• Sessões do MPSD
• Tratamento de notificações de alteração e detecção de desconexão do MPSD
• Identificadores do MPSD para sessões
• Sincronização de atualizações de sessão
• Chamar o MPSD
• Multiplayer Session Explorer

​

Sessões do MPSD

• É criada e gerenciada pelos títulos.
• Tem um URI exclusivo. Para obter mais informações, veja URIs do Session Directory.
• Permite a conectividade entre os usuários, chamados de membros da sessão.
• Armazena dados que viabilizam o jogo, como atributos por membro, configurações do jogo, informações de inicialização e informações do servidor de jogo.

​

Tratamento de notificações de alteração e detecção de desconexão do MPSD

• Enviar notificações breves (shoulder taps) quando ocorrem alterações na sessão, com base nas assinaturas de eventos iniciadas pelos títulos.
• Detectar desconexões de usuários.
• Definir usuários como inativos e, em seguida, removê-los da sessão, com base na detecção de desconexão.

​

Fazer conexões de usuários

1. O título chama XblMultiplayerSetSubscriptionsEnabled. Esse método informa à XSAPI que o cliente pretende usar uma conexão RTA para fins de multijogador.
2. Quando o título faz sua primeira chamada a XblMultiplayerWriteSessionAsync ou XblMultiplayerWriteSessionByHandleAsync, com o usuário atual definido no estado Active, uma conexão é criada e vinculada ao MPSD.

​

Assinar alterações na sessão

​

Tratar shoulder taps

​

Tratar notificações de alterações no estado da conexão

• Manipulador XblMultiplayerSessionSubscriptionLostHandler: disparado quando a conexão do título com o MPSD por meio do serviço RTA é perdida. Quando esse evento ocorre, o título deve encerrar o multijogador.
• Manipulador XblRealTimeActivityConnectionStateChangeHandler: disparado em uma alteração temporária na integridade da conexão do título com o serviço RTA. O título não é obrigado a tomar nenhuma ação ao receber esse evento, mas o evento pode ser útil para fins de diagnóstico.

​

Desconectar clientes

​

Detecção de desconexão

​

Tratar reconexões do RTA

void* context{ nullptr };
XblFunctionContext connectionIdChangedFunctionContext = XblMultiplayerAddConnectionIdChangedHandler(
    xblContextHandle,
    [](void* context) {
        XblMultiplayerSessionHandle sessionHandle; // Retrieve the MPSD session to update
        XblMultiplayerSessionCurrentUserSetStatus(sessionHandle, XblMultiplayerSessionMemberStatus::Active);

        auto asyncBlock = std::make_unique<XAsyncBlock>();
        asyncBlock->queue = queue;
        asyncBlock->context = nullptr;
        asyncBlock->callback = [](XAsyncBlock* asyncBlock)
        {
            std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };

            XblMultiplayerSessionHandle sessionHandle;
            HRESULT hr = XblMultiplayerWriteSessionResult(asyncBlock, &sessionHandle);
            if (SUCCEEDED(hr))
            {
                // If the write call succeeds, the connection ID has been updated and no further action is needed.
            }
            else
            {
                // If the write call fails, it's likely that the user has been removed from the session.
            }
        };

        auto hr = XblMultiplayerWriteSessionAsync(xblContextHandle, sessionHandle, XblMultiplayerSessionWriteMode::UpdateExisting, asyncBlock.get());
        if (SUCCEEDED(hr))
        {
            asyncBlock.release();
        }
    }, 
    context);

​

Identificadores do MPSD para sessões

​

Tipos de identificador

​

Identificadores de convite

​

Criar um identificador de convite

​

Criar um identificador de atividade

​

Usar identificadores

1. Obter o ID do identificador nos parâmetros de ativação do título.
2. Criar um objeto de sessão do MPSD local e, em seguida, entrar nele como ativo.
3. Gravar a sessão, passando o identificador apropriado.

​

Sincronização de atualizações de sessão

• Um árbitro atualiza as partes compartilhadas da sessão. Se a sua implementação envolver um único árbitro, você poderá evitar o uso de atualizações sincronizadas para a maioria das operações de gravação. O título pode evitar a sincronização nos casos a seguir.
  • Qualquer atualização que o árbitro faça nas partes compartilhadas da sessão, a menos que estejam relacionadas à comunicação da identidade do árbitro
  • Qualquer atualização que um título faça na área de membros da sessão

  [!NOTE] Embora os tipos de atualização mencionados anteriormente não precisem de sincronização, ainda é importante sincronizar quaisquer atualizações na propriedade XblMultiplayerSessionProperties::HostDeviceToken. Essa propriedade é usada para comunicar a identidade do árbitro, por exemplo, como parte da migração de árbitro.

• Todos os clientes atualizam as partes compartilhadas da sessão. Nesse caso, todas as atualizações nas partes compartilhadas da sessão devem ser sincronizadas. No entanto, os títulos ainda podem gravar em suas próprias áreas de membro sem sincronização.

​

Atualizar a sincronização da sessão usando a API Multiplayer

• XblMultiplayerWriteSessionAsync
• XblMultiplayerWriteSessionByHandleAsync

​

Atualizar a sincronização da sessão usando a API REST Multiplayer

​

Chamar o MPSD

• Recomendamos que você use a API multijogador, que contém classes que atuam como wrappers para a funcionalidade RESTful. Para obter mais informações, veja as funções com o prefixo XblMultiplayer. Para o matchmaking do SmartMatch, use a API de matchmaking, representada pelas funções com o prefixo XblMatchmaking.
• Use chamadas HTTP padrão diretas para as APIs REST de multijogador e matchmaking incluídas na referência RESTful dos serviços XBOX. Os URIs aplicáveis são descritos nas seções URIs do Session Directory (para multijogador) e URIs de matchmaking (para matchmaking). Os objetos JSON relacionados são descritos na seção Referência de objetos JavaScript Object Notation (JSON).

​

Usar a API Multiplayer para chamar o MPSD

​

Usar a API REST Multiplayer para interagir com o MPSD

​

Consultar sessões e modelos de sessão (REST)

​

Consultar informações básicas da sessão

​

Consultar modelos de sessão

• /serviceconfigs//sessiontemplates
• /serviceconfigs//sessiontemplates/

​

Consultar o estado da sessão

• /serviceconfigs//sessions
• /serviceconfigs//sessiontemplates//sessions

​

Multiplayer Session Explorer

​

Acessar o Multiplayer Session Explorer

​

Abrir a página principal

1. Abra a página principal da ferramenta. Ela exibe o contexto de segurança (usuário conectado e sandbox) e uma lista de SCIDs na sandbox.
2. Pressione o botão Menu para fixar esta página na Página Inicial para que você não precise digitar o URI novamente.

​

Exibir as sessões e os modelos disponíveis

1. Selecione um SCID na ferramenta para exibir uma lista de sessões desse SCID que incluem o usuário conectado como membro.
2. Nessa mesma página, você pode selecionar o SCID e exibir os modelos de sessão e as cadeias de caracteres de localização na configuração de serviço do SCID. Esses itens são ingeridos por meio do Partner Center.

​

Exibir o conteúdo completo de uma sessão

• A chamada GET pode estar usando uma versão de contrato mais antiga no cabeçalho X-Xbl-Contract-Version. O Multiplayer Session Explorer sempre exibe a sessão usando a versão de contrato mais atual.
• Quando uma sessão é solicitada normalmente via GET, transformações e efeitos colaterais podem ser disparados, como tempos limite expirados. O Multiplayer Session Explorer exibe um instantâneo da sessão como ela está armazenada, sem executar nenhuma lógica, transformação ou efeito colateral.
• O campo de objeto JSON nextTimer não está presente nas sessões do MPSD porque é calculado ao mesmo tempo que os efeitos colaterais.

​

Veja também

• A seção Visão geral da sessão no tópico Tópicos avançados de sessões multijogador
• Códigos de status de sessões multijogador
• A seção Atualizar uma sessão do MPSD no tópico Tarefas de multijogador
• A seção Entrar em uma sessão do MPSD a partir de uma ativação do título no tópico Tarefas de multijogador
• A seção Assinar notificações de alteração de sessão do MPSD no tópico Tarefas de multijogador
• Visão geral do matchmaking