Skip to main content

XUserAddOptions

Especifica as opções para adicionar um usuário.

Sintaxe

Constantes

Comentários

Há alguns casos extremos que os desenvolvedores devem conhecer se chamarem repetidamente XUserAddAsync com options definido como XUserAddOptions::AddDefaultUserSilently:
  • Se você chamar isso repetidamente e soubermos qual é o usuário padrão que iniciou o jogo, o mesmo usuário será retornado.
  • Se o usuário padrão conhecido anteriormente tiver saído e houver apenas um usuário conectado ao dispositivo, esse usuário será marcado como o novo usuário “padrão” e retornado.
  • Se o usuário padrão conhecido anteriormente tiver saído e houver vários usuários conectados ao dispositivo, será retornado E_GAMEUSER_NO_DEFAULT_USER.
  • Em inicializações de desenvolvedor, o usuário padrão será o usuário de entrada automática, que pode ser especificado definindo esse usuário como o usuário de entrada automática no DevHome ou usando xbconfig (tópico sob NDA) DefaultUser.
Se um usuário padrão não estiver disponível*, XUserAddResult retornará E_GAMEUSER_NO_DEFAULT_USER. Você deve chamar XUserAddAsync com options não definido como XUserAddOptions::AddDefaultUserSilently. Também há alguns casos extremos que os desenvolvedores devem conhecer se chamarem repetidamente XUserAddAsync com options definido como XUserAddOptions::AddDefaultUserAllowingUI. Eles são muito semelhantes (mas não idênticos) ao caso silencioso:
  • Se você chamar isso repetidamente e soubermos qual é o usuário padrão que iniciou o jogo, o mesmo usuário será retornado.
  • Se o usuário padrão conhecido anteriormente tiver saído e houver apenas um usuário conectado ao dispositivo, esse usuário será marcado como o novo usuário “padrão” e retornado.
  • Se o usuário que iniciou o jogo originalmente tiver saído e o número de usuários for 0 ou mais de 1, o sistema exibirá a interface do usuário para obter o usuário e, em seguida, definirá esse usuário como padrão.
Em XUserAddAsync, você não pode usar XUserAddOptions::AllowGuests com XUserAddOptions::AddDefaultUserSilently. Um convidado não pode ser o usuário padrão. Você pode usar XUserAddOptions::AllowGuests mesmo que a plataforma atual não ofereça suporte a convidados. O exemplo a seguir demonstra como adicionar um usuário a uma sessão de jogo de forma assíncrona.

Requisitos


Cabeçalho: XUser.h
Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

XUser XUserAddAsync XUserAddResult
Last modified on October 6, 2026