Skip to main content

POST (/handles)

Define a sessão multijogador da atividade atual do usuário e convida membros da sessão, se necessário.
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 pode ser usado para definir a sessão da atividade atual. Nesse caso, o método pode ser encapsulado por Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SetActivityAsync. O corpo da solicitação deve definir a referência da sessão, usando o objeto sessionRef no arquivo JSON, com o campo type definido como “activity”. Nenhum corpo de resposta é recuperado. Para obter as definições dos itens especificados em uma referência de sessão, consulte Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference. Este método POST também pode ser usado para convidar para uma sessão os usuários especificados pelos identificadores. Nesse caso, o método pode ser encapsulado por Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync. Esse uso do método POST exige que o corpo da solicitação defina a referência da sessão, mas com o campo type definido como “invite”. O corpo da resposta é um identificador de convite.

Parâmetros de URI

Nenhum

Códigos de status HTTP

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

Corpo da solicitação

Corpo da solicitação para definir a atividade

Corpo da solicitação para enviar convites

Corpo da resposta

Corpo da resposta para definir a atividade

Nenhum.

Corpo da resposta para enviar convites

Um identificador de convite.

Confira também

Pai
/handles
Last modified on October 6, 2026