Skip to main content
Os usuários convidados, também conhecidos como Convidados Patrocinados ou Contas de Convidado, permitem que os jogadores interajam com muitos XBOX services sem precisar criar uma conta completa do XBOX. Quando um título permite a participação de contas de convidado, ele usa Convidados Patrocinados para facilitar isso.
Existe outro tipo de conta de convidado, conhecido como Convidado Puro. Esse é o tipo de conta que existe na ausência de uma conta conectada. Ela não pode fazer chamadas autenticadas aos XBOX services nem jogar jogos que exijam que um usuário do XBOX esteja conectado.
Os usuários convidados são contas de sessão única patrocinadas por outro usuário do XBOX já conectado ao dispositivo. Elas permitem que um jogador interaja com muitos XBOX services sem precisar criar uma conta completa do XBOX e duram até que uma das seguintes condições seja atendida:
  • A conta de convidado sai
  • O usuário patrocinador sai
  • O dispositivo é desligado
Da perspectiva do usuário final, as contas de convidado permitem que um jogador participe com mais facilidade de um jogo multijogador local ou online no mesmo console que seu patrocinador, reduzindo a barreira de entrada. Durante uma única sessão de jogo, esse convidado aproveita muitos dos mesmos benefícios da conta patrocinadora, incluindo a comunicação por voz.

Suporte a contas de convidado no seu título

O suporte a usuários convidados no seu título não é obrigatório, mas é uma ótima maneira de permitir que jogadores sem uma conta do XBOX experimentem seu conteúdo no dispositivo patrocinado sem exigir mudanças substanciais no tratamento de usuários. Assim como os usuários completos do XBOX, os usuários convidados podem ser conectados chamando XUserAddAsync com a opçãoXUserAddOptions::AllowGuests. Ao entrar, o convidado recebe umXUserHandle que funciona com todas as APIs que recebem umXUserHandle como parâmetro.
Uma diferença fundamental entre um usuário do XBOX e um usuário convidado é a capacidade de identificar um usuário de forma determinística. Quando um convidado entra, ele não tem controle sobre qual conta é escolhida para patrociná-lo. Se um convidado sair e depois um convidado entrar, você não terá como determinar se é o mesmo usuário de antes. Lembre-se disso se estiver pensando em armazenar preferências do jogador ou dados em cache associados a um usuário específico.

Usuários do XBOX x usuários convidados na interação com os XBOX services

Em seguida, XblContextCreateHandle pode ser chamado para esse usuário para se comunicar com os XBOX services. Você pode verificar se um usuário é convidado chamando XUserGetIsGuest com um identificador de usuário. As diferenças entre usuários do XBOX e usuários convidados dependem das APIs consumidas. Para serviços que oferecem suporte total a contas de convidado, como a consulta das informações de perfil público de outro jogador, os dois tipos de usuários se comportam de forma idêntica usando os privilégios da conta patrocinadora. Os XBOX services que não oferecem suporte a usuários convidados normalmente são aqueles que armazenam ou gerenciam dados de longo prazo associados a um usuário específico (por exemplo, Statistics, conquistas, relacionamentos sociais etc.). As chamadas a esses serviços retornarão um erro (normalmente HTTP_E_STATUS_BAD_REQUEST) quando invocadas com um usuário convidado.
É responsabilidade do desenvolvedor evitar usar contas de convidado com APIs que não oferecem suporte a elas. Uma lista de serviços e seu nível de suporte pode ser encontrada abaixo.

Status da assinatura e controles parentais da conta de usuário do XBOX

Como as contas de convidado herdam os recursos da conta patrocinadora, quaisquer limitações impostas pelo tipo de assinatura (Gold x Silver) e quaisquer controles parentais habilitados para essa conta também são herdados. Por exemplo, se a conta patrocinadora tiver algum privilégio revogado pela equipe de Política e Fiscalização da Comunidade XBOX, esses privilégios também serão removidos do usuário convidado.

Suporte a contas de convidado com os XBOX services

Suporte das APIs dos XBOX services a usuários convidados

  • Armazenamento em nuvem
    • Sem suporte
  • Geral
    • O suporte à Real-Time Activity (RTA) é determinado pelos serviços assinados
  • Identidade
    • Autenticação
      • Herdada da conta patrocinadora
    • Privacidade
      • Verificação de permissões / listas de silenciados / evitados
        • Herdadas da conta patrocinadora
    • Privilégios
      • Controles parentais
        • Herdados da conta patrocinadora
      • Configurações de privacidade
        • Herdadas da conta patrocinadora
      • Privilégios removidos para contas de convidado patrocinadas
        • XPRIVILEGE_BROADCAST
        • XPRIVILEGE_MANAGE_PROFILE_PRIVACY_SETTING
        • XPRIVILEGE_GAME_DVR
        • XPRIVILEGE_SOCIAL_NETWORK_SHARING
        • XPRIVILEGE_ADD_FRIEND
    • Perfil do usuário - Suporte parcial
      • Os convidados podem visualizar os dados públicos do perfil do XBOX
  • Multijogador
    • Herdado da conta patrocinadora
  • Dados do jogador
    • Conquistas - Sem suporte
    • Estatísticas - Sem suporte
  • Serviço Web personalizado autenticado e chamadas de serviço para serviço
    • As contas de convidado podem fazer chamadas autenticadas a serviços Web personalizados
    • As contas de convidado podem ser usadas em chamadas de serviço para serviço
  • Social
    • Cadeias de caracteres localizadas - Sem suporte
    • People-System - Sem suporte
    • Presença - Sem suporte
    • Reputação - Sem suporte
    • Social Manager - Sem suporte

PlayFab

  • Chat do PlayFab Party
    • Os convidados herdam as permissões do usuário patrocinador e podem participar se a conta patrocinadora tiver privilégios de multijogador e de comunicação

Perguntas frequentes

Várias contas de convidado podem estar conectadas ao mesmo tempo?

Várias contas de convidado podem ter o mesmo patrocinador e podem estar conectadas simultaneamente.

As contas de convidado têm acesso aos direitos do dispositivo?

Os direitos do dispositivo são propagados para as contas de convidado da mesma forma que para os usuários do XBOX. As contas de convidado também têm o mesmo acesso ao conteúdo instalado que a conta patrocinadora

Como as contas de convidado interagem com plataformas que não oferecem suporte a contas de convidado (por exemplo, PC, dispositivos móveis)?

As contas de convidado aparecem como contas normais, com as mesmas permissões da conta patrocinadora, e não exigem código adicional.

Como as contas de convidado são testadas na certificação?

A funcionalidade de contas de convidado não é testada especificamente no processo de certificação. Além disso, cabe ao desenvolvedor decidir se um título oferecerá suporte a contas de convidado.

Confira também

Identidade do usuário e XUser Visão geral dos privilégios de usuário dos XBOX services Uso no lado do cliente dos privilégios de usuário dos XBOX services
Last modified on October 6, 2026