Skip to main content

​
GET (/handles//session)

Obtém um objeto de sessão para o identificador especificado.
Importante:
Este método é usado pelo Multiplayer 2015 e se aplica somente a essa versão multijogador e posteriores. Ele se destina ao uso com o contrato de modelo 104/105 ou posterior e requer um elemento de cabeçalho X-Xbl-Contract-Version: 104/105 ou posterior em todas as solicitações.

​
Comentários

Este método HTTP/REST recupera um objeto de sessão do servidor, usando o ponteiro do lado do serviço fornecido para a sessão (identificador). O retorno é o objeto de sessão, com todos os seus atributos. Este método pode ser encapsulado por Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync. O chamador deste método obtém a ID do identificador a partir do objeto MultiplayerActivityDetails de um jogador. Como alternativa, o chamador obtém a ID de uma ativação de protocolo depois que um usuário aceita um convite de jogo.

​
Parâmetros de URI

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | | handleId| GUID| A ID exclusiva do identificador da sessão.|

​
Códigos de status HTTP

O serviço retorna um código de status HTTP conforme aplicável ao MPSD.

​
Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

​
Corpo da resposta

Veja a estrutura da resposta em MultiplayerSession (JSON).

​
Confira também

Pai
/handles//session
Last modified on October 6, 2026

Related topics

XblMultiplayerGetSessionByHandleAsyncXblMultiplayerWriteSessionByHandleAsync