> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameActivation

> XGameActivation

# XGameActivation

Material de referência para as APIs do XGameActivation.

<Note>As APIs do **XGameActivation** substituem as APIs preteridas [XGameProtocol](/pt-BR/reference/system/xgameprotocol/xgameprotocol_members) e [XGameInvite](/pt-BR/reference/system/xgameinvite/xgameinvite_members). Os novos jogos devem usar o **XGameActivation** para ativação de protocolo, ativação de arquivo e tratamento de convites de jogo. Para obter diretrizes de migração, consulte [Comentários](#remarks).</Note>

## Funções

| Função | Descrição |
| - | - |
| [XGameActivationCallback](/pt-BR/reference/system/xgameactivation/functions/xgameactivationcallback) | Um retorno de chamada que um aplicativo define para eventos de ativação. |
| [XGameActivationRegisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationregisterforevent) | Registra um retorno de chamada para eventos de ativação. |
| [XGameActivationUnregisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) | Cancela o registro de um retorno de chamada para eventos de ativação. |
| [XGameActivationAcceptPendingInvite](/pt-BR/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) | Aceita um convite de jogo pendente. |

## Estruturas

| Estrutura | Descrição |
| - | - |
| [XGameActivationInfo](/pt-BR/reference/system/xgameactivation/structs/xgameactivationinfo) | Contém as informações de ativação passadas para o retorno de chamada de ativação. |

## Enumerações

| Enumeração | Descrição |
| - | - |
| [XGameActivationType](/pt-BR/reference/system/xgameactivation/enums/xgameactivationtype) | Especifica o tipo de ativação que ocorreu. |

<a id="remarks" />

## Comentários

As APIs do **XGameActivation** fornecem um mecanismo unificado de retorno de chamada para todas as formas de ativação de jogo, incluindo ativação de protocolo, ativação de arquivo e tratamento de convites de jogo. Isso elimina a necessidade de registrar separadamente com [XGameProtocolRegisterForActivation](/pt-BR/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation) e [XGameInviteRegisterForEvent](/pt-BR/reference/system/xgameinvite/functions/xgameinviteregisterforevent).

### Migrando do XGameProtocol e do XGameInvite

| API preterida | Substituição |
| - | - |
| `XGameProtocolRegisterForActivation` | [XGameActivationRegisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationregisterforevent) |
| `XGameProtocolUnregisterForActivation` | [XGameActivationUnregisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) |
| `XGameInviteRegisterForEvent` | [XGameActivationRegisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationregisterforevent) |
| `XGameInviteUnregisterForEvent` | [XGameActivationUnregisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) |
| `XGameInviteRegisterForPendingEvent` | [XGameActivationRegisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationregisterforevent) |
| `XGameInviteUnregisterForPendingEvent` | [XGameActivationUnregisterForEvent](/pt-BR/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) |
| `XGameInviteAcceptPendingInvite` | [XGameActivationAcceptPendingInvite](/pt-BR/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) |

## Documentação conceitual

* [Ativação de tipo de arquivo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [Recebendo convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)
* [Enviando convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-send)
* [Visão geral dos convites](/pt-BR/services/xbox-services/multiplayer/invites/live-multiplayer-invites-overview)

## Confira também

[Referência de API do sistema](/pt-BR/reference/system/gc-reference-system-toc)\
[Ativação de protocolo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/protocolactivation)\
[Ativação de tipo de arquivo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)


## Related topics

- [XGameActivation](/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback.md)