XUserAddAsync
Adiciona de forma assíncrona um usuário a uma sessão de jogo.Sintaxe
Parâmetros
options _In_Tipo: XUserAddOptions Opções para adicionar um usuário a uma sessão de jogo. async _Inout_
Tipo: XAsyncBlock* Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada.
Valor retornado
Tipo: HRESULT Código de sucesso ou de erro HRESULT. Para obter uma lista de códigos de erro, consulte Códigos de erro.Comentários
XUserAddAsync inicia uma operação assíncrona para adicionar um usuário ao jogo. Use XUserAddResult para recuperar os resultados da operação. XUserAddAsync sempre exibe uma interface do usuário do Seletor de Contas, a menos que XUserAddOptions::AddDefaultUserSilently ou XUserAddOptions::AddDefaultUserAllowingUI seja passado para o parâmetro options. Se você usar XUserAddOptions::AddDefaultUserSilently, XUserAddAsync não exibirá uma interface do usuário. Há algumas considerações sobre esta função ao usar o modelo de usuário simplificado (tópico sob NDA):- Com o modelo de usuário simplificado, os desenvolvedores devem garantir que options esteja definido como XUserAddOptions::AddDefaultUserSilently:
- No console, jogos implantados de forma solta que usam o modelo de usuário simplificado não poderão ser iniciados, a menos que já haja um usuário padrão conectado.
- No PC, jogos implantados de forma solta que usam o modelo de usuário simplificado podem ser iniciados sem um usuário; no entanto, quando o jogo chamar XUserAddAsync, se ninguém estiver conectado, o jogo será encerrado e o PC Bootstrapper será iniciado para ajudar um usuário a entrar. As inicializações seguintes funcionarão normalmente, desde que o usuário esteja totalmente conectado ao XBOX Live.
- 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.
- 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.
Requisitos
Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, Steam Deck, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
- Executar tarefa de API do Microsoft Game Development Kit (GDK)
- Metas de design e melhorias da programação assíncrona
- Implementar a entrada do jogador no seu jogo
- Introdução ao Game Chat 2
- Usar a API C++ do Game Chat 2
- Implementar a entrada do jogador
