Skip to main content

XblMultiplayerActivitySetActivityAsync

Define ou atualiza a atividade multijogador de um usuário local.

Sintaxe

Parâmetros

xblContext   _In_
Tipo: XblContextHandle
Contexto do XBOX Live para o usuário local. activityInfo   _In_
Tipo: XblMultiplayerActivityInfo*
Informações sobre a atividade. Os campos maxPlayers e currentPlayers são opcionais; eles são ignorados se definidos como 0. O valor do campo platform é ignorado; o XSAPI define automaticamente a atividade na plataforma local apropriada. allowCrossPlatformJoin   _In_
Tipo: bool
True se for possível ingressar na atividade em outras plataformas compatíveis com o título. async   _In_
Tipo: XAsyncBlock*
O XAsyncBlock para esta operação.

Valor retornado

Tipo: HRESULT Código de retorno HRESULT para esta operação de API.

Comentários

Quando um título inicia ou ingressa em uma experiência multijogador, ele deve criar uma atividade. Isso permite que tanto o shell quanto outros jogadores do seu título vejam a atividade do jogador. Seu título pode permitir que outros jogadores ingressem no jogo em andamento. Se um jogador quiser ingressar em uma atividade do seu título e ele não estiver em execução, o título será ativado e a cadeia de conexão será passada para ele.

Para ver como essa função é usada, consulte “Definir uma atividade” na seção Atividades de Código de exemplo para o Multiplayer Activity.

Chamada REST

Chama PUT /titles//users//activites

Requisitos

Cabeçalho: multiplayer_activity_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

multiplayer_activity_c
Last modified on October 6, 2026