> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Atualizar atividade > Atualizar atividade # Atualizar atividade 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. ```http theme={null} PUT /titles/{titleId}/users/{xuid}/activities ``` ## Parâmetros de URI | Parâmetro | Em | Obrigatório | Tipo | Descrição | | - | - | - | - | - | | titleId | path | TRUE | integer | O titleId do jogo para o qual a solicitação está sendo enviada. | | xuid | path | TRUE | string | O XUID do usuário referenciado na solicitação atual. O XUID é representado como um inteiro de base 10. | ## Cabeçalho da solicitação | Nome | Obrigatório | Tipo | Descrição | | - | - | - | - | | Authorization | TRUE | integer | O chamador deve fornecer um XToken no formato de autorização XBL 3.0. Por exemplo, Authorization: XBL3.0 x=2553948354698;\) | | Content-Type | TRUE | string | ContentType deve ser definido como application/json | ## Corpo da solicitação | Nome | Obrigatório | Tipo | Descrição | | - | - | - | - | | connectionString | TRUE | 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. | | 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. | | platform | | [Platform](#platform) | | ## Respostas | Nome | Tipo | Descrição | | - | - | - | | 204 No Content | | A atividade foi definida com êxito. | | 400 Bad Request | [ErrorResponse](#errorresponse) | 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." | | Outros códigos de status | [ThrottledEntity](#throttledentity) | Excesso de solicitações. Cabeçalhos Retry-After: integer | ## Definições * [ErrorResponse](#errorresponse) * [JoinRestriction](#joinrestriction) * [Platform](#platform) * [SetActivityRequest](#setactivityrequest) * [ThrottleEntity](#throttleentity) ### ErrorResponse | Nome | Tipo | Descrição | | - | - | - | | debugMessage | string | Versão legível da mensagem de erro que pode ser usada para depuração. | | errorCode | string | Enumeração do código de erro. | ### JoinRestriction A configuração que define quem pode se juntar ao jogador atual. | Nome | Tipo | Descrição | | - | - | - | | Followed | string | | | InviteOnly | string | | | Public | string | | ### Platform | Nome | Tipo | Descrição | | - | - | - | | Android | string | | | IOS | string | | | Nintendo | string | | | PlayStation | string | | | Scarlett | string | | | Win32 | string | | | WindowsOneCore | string | | | XboxOne | string | | ## SetActivityRequest 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. | | joinRestriction | [JoinRestriction](#joinrestriction) | A configuração que define quem pode se juntar ao jogador atual. | | maxPlayers | integer | O número máximo de jogadores que podem jogar com este jogador na atividade atual. | | platform | [Platform](#platform) | | | sequenceNumber | 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. | ### ThrottledEntity | Nome | Tipo | Descrição | | - | - | - | | currentRequests | string | Número atual de solicitações - simultaneidade ou taxa. | | debugMessage | string | Versão legível da mensagem de limitação que pode ser usada para depuração. | | limitType | string | O tipo de limite, ou seja, simultaneidade ou taxa. | | maxRequests | string | Máximo de solicitações permitidas - simultaneidade ou taxa. | | periodInSeconds | string | O período em segundos que se aplica quando os limites de taxa ou simultaneidade são excedidos. | | version | string | Versão atual do contrato de limitação. | ## Related topics - [XR-064 Sessões de jogo com entrada permitida e jogo online](/pt-BR/publishing/certification/xr/xr-064.md) - [Requisitos XBOX testados na certificação para jogos de console XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md) - [Guia de BVT de console da certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md) - [Guia de BVT de PC da certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md) - [XR-045 Rede XBOX e privilégios de conta](/pt-BR/publishing/certification/xr/xr-045.md)