XGameUiShowSendGameInviteAsync
Este método mostra uma interface do usuário de seleção preenchida com a lista de amigos e a lista de amigos sugeridos do jogador selecionado para enviar convites de jogo.Sintaxe
Parâmetros
async _In_Tipo: XAsyncBlock* Um ponteiro para o XAsyncBlock que é passado para XAsyncRun. requestingUser _In_
Tipo: XUserHandle Um identificador para o usuário que está enviando os convites. sessionConfigurationId _In_
Tipo: char* Especifica uma cadeia de caracteres que indica a ID de configuração de serviço do título. sessionTemplateName _In_
Tipo: char* Especifica uma cadeia de caracteres que indica o nome do modelo de sessão multijogador. sessionId _In_
Tipo: char* Especifica uma cadeia de caracteres que indica o ID da sessão multijogador para a qual as pessoas serão convidadas. invitationText _In_opt_
Tipo: char* Especifica uma cadeia de caracteres que indica o ID da cadeia de caracteres de convite personalizada.
Esse ID de cadeia de caracteres é definido na configuração de serviço do XBOX Live para identificar o texto de convite adicional ao texto de convite padrão. A cadeia de caracteres de ID deve ter o prefixo ”///”. Passe uma cadeia de caracteres vazia se não quiser adicionar uma cadeia de caracteres personalizada ao convite. customActivationContext _In_opt_
Tipo: char* O contexto de ativação personalizado que fica disponível para o convidado no URI de ativação de um convite. A cadeia de caracteres do contexto de ativação personalizado deve ser segura para URL, e o conteúdo binário deve ser codificado com a codificação base64 segura para URL. O comprimento máximo é de 160 caracteres.
Valor retornado
Tipo: HRESULT Código de êxito ou de erro HRESULT da chamada assíncrona.Comentários
Depois que a lista é preenchida, os jogadores podem ser selecionados. O jogador pode enviar um convite para jogar e/ou para um chat de grupo em uma sessão de jogo especificada às pessoas selecionadas na interface do usuário de seleção. Solicitar uma interface do usuário fará com que seu jogo entre no modo restrito. No modo restrito, seu título receberá menos recursos do sistema enquanto estiver em segundo plano em relação à interface do usuário solicitada. Para saber mais sobre o modo restrito e outros modos operacionais do seu título, leia Ciclo de vida do jogo XBOX (tópico sob NDA).Requisitos
Cabeçalho: XGameUI.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, Steam Deck, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
Confira também
XGameUIXGameUiShowSendGameInviteResult
Ciclo de vida do jogo XBOX (tópico sob NDA)