Skip to main content

POST (/serviceconfigs//sessiontemplates//batch)

Cria uma consulta em lote em várias IDs de usuário do XBOX.
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 cria consultas em lote em várias IDs de usuário do XBOX no nível do modelo de sessão. Este método pode ser encapsulado por Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync. Para o Multiplayer 2015, você pode combinar várias consultas em uma única chamada se todas as consultas forem iguais, mas tratarem de IDs de usuário do XBOX (XUIDs) diferentes, conforme representado no parâmetro de cadeia de consulta xuid. Observe que os parâmetros da cadeia de consulta e as respostas são os mesmos para consultas regulares e consultas em lote. Para uma consulta em lote, as sessões pertencentes a cada XUID são gravadas na resposta na mesma ordem em que os parâmetros xuid são apresentados na solicitação. É possível que a mesma sessão apareça várias vezes na resposta, uma vez para cada xuid ao qual ela corresponde.

Parâmetros de URI

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | | scid| GUID| Identificador de configuração de serviço (SCID). Parte 1 do identificador da sessão.| | sessionTemplateName| string| Nome da instância atual do modelo de sessão. Parte 2 do identificador da sessão.|

Parâmetros da cadeia de consulta

Uma consulta pode ser modificada usando os parâmetros da cadeia de consulta na tabela a seguir. | Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | | keyword| string| Uma palavra-chave, por exemplo, “foo”, que deve ser encontrada nas sessões ou nos modelos para que eles sejam recuperados. | | xuid| inteiro sem sinal de 64 bits| A ID de usuário do XBOX, por exemplo, “123”, das sessões a serem incluídas na consulta. Por padrão, o usuário deve estar ativo na sessão para que ela seja incluída. | | reservations| booliano| True para incluir sessões nas quais o usuário está definido como um jogador reservado, mas ainda não ingressou para se tornar um jogador ativo. Este parâmetro é usado somente ao consultar suas próprias sessões ou ao consultar as sessões de um usuário específico de servidor para servidor. | | inactive| booliano| True para incluir sessões que o usuário aceitou, mas nas quais não está jogando ativamente. As sessões nas quais o usuário está “ready”, mas não “active”, contam como inativas. | | private| booliano| True para incluir sessões privadas. Este parâmetro é usado somente ao consultar suas próprias sessões ou ao consultar as sessões de um usuário específico de servidor para servidor. | | visibility| string| Estado de visibilidade das sessões. Os valores possíveis são definidos por MultiplayerSessionVisibility. Se este parâmetro for definido como “open”, a consulta deverá incluir somente sessões abertas. Se for definido como “private”, o parâmetro private deverá ser definido como true. | | version| inteiro com sinal de 32 bits| A versão máxima da sessão que deve ser incluída. Por exemplo, um valor de 2 especifica que somente as sessões com uma versão principal de sessão de 2 ou inferior devem ser incluídas. O número da versão deve ser menor ou igual à versão do contrato da solicitação mod 100. | | take| inteiro com sinal de 32 bits| O número máximo de sessões a serem recuperadas. Esse número deve estar entre 0 e 100. | Definir private ou reservations como true requer acesso no nível do servidor à sessão. Como alternativa, essas configurações exigem que a declaração de XUID do chamador corresponda ao filtro de XUID no URI. Caso contrário, o código de status HTTP/403 será retornado, independentemente de essas sessões realmente existirem ou nã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

Corpo da resposta

O retorno deste método é uma matriz JSON de referências de sessão, com alguns dados de sessão incluídos embutidos.

Confira também

Pai
/serviceconfigs//sessiontemplates//batch
Last modified on October 6, 2026