Define ou atualiza a atividade de um usuário que está jogando um título específico.
Esta API permite que um cliente ou servidor de jogo defina/atualize a atividade multijogador de um usuário que está jogando um título específico. A atividade deve ser definida assim que o usuário estiver ativo em uma atividade multijogador. Os usuários do XBOX Live poderão assinar alterações na atividade de outros usuários (geralmente amigos), e essas atualizações serão enviadas por push aos clientes XBOX via RTA.
A cadeia de conexão é o objeto passado ao cliente que está se conectando para entrar no jogo. A cadeia de conexão geralmente contém informações como o IP do servidor para permitir que o usuário que está entrando se conecte. O comprimento da cadeia de conexão é limitado a 512 caracteres.
joinRestriction
TRUE
JoinRestriction
A configuração que define quem pode se juntar ao jogador atual.
sequenceNumber
TRUE
string
Esta é uma representação em cadeia de caracteres de um número monotonicamente crescente (ulong) que o cliente deve passar em cada solicitação. Ela é usada para garantir a ordem das atualizações de uma atividade. Um bom exemplo de sequenceNumber pode ser o horário Unix do cliente, já que ele é garantidamente crescente. Deve ser maior que 0 e não pode ser maior que o ulong máximo.
currentPlayers
integer
O número de jogadores que já estão jogando com o usuário em uma atividade multijogador.
groupId
string
Um identificador exclusivo para agrupar todos os usuários que estão jogando como parte do mesmo jogo.
maxPlayers
integer
O número máximo de jogadores que podem jogar com este jogador na atividade atual.
Ocorreu um erro ao processar a solicitação. Possíveis códigos de erro: “RequestValidationError: falha na validação da solicitação.”, ” AuthorizationError: o chamador não tem permissão para acessar o recurso. Excesso de solicitações.”
Se a plataforma da atividade for definida na solicitação, só será possível entrar nela por essa plataforma. Se a plataforma não for definida, será possível entrar na atividade em todas as plataformas nas quais o jogo está disponível para ser jogado.
Nome
Tipo
Descrição
connectionString
string
A cadeia de conexão é o objeto passado ao cliente que está se conectando para entrar no jogo. A cadeia de conexão geralmente contém informações como o IP do servidor para permitir que o usuário que está entrando se conecte. O comprimento da cadeia de conexão é limitado a 512 caracteres.
currentPlayers
integer
O número de jogadores que já estão jogando com o usuário em uma atividade multijogador.
groupId
string
Um identificador exclusivo para agrupar todos os usuários que estão jogando como parte do mesmo jogo.
Esta é uma representação em cadeia de caracteres de um número monotonicamente crescente (ulong) que o cliente deve passar em cada solicitação. Ela é usada para garantir a ordem das atualizações de uma atividade. Um bom exemplo de sequenceNumber pode ser o horário Unix do cliente, já que ele é garantidamente crescente. Deve ser maior que 0 e não pode ser maior que o ulong máximo.
