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

# XGameActivation (conteúdo da API)

> XGameActivation

# XGameActivation

Material de referência para as APIs do XGameActivation.

> [!NOTE]
>
> As APIs do **XGameActivation** substituem as APIs preteridas [XGameProtocol](https://docs.xbox.com/pt-BR/reference/system/xgameprotocol/xgameprotocol_members.md) e [XGameInvite](https://docs.xbox.com/pt-BR/reference/system/xgameinvite/xgameinvite_members.md). 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).

## Funções

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

## Estruturas

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

## Enumerações

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

## 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](https://docs.xbox.com/pt-BR/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation.md) e [XGameInviteRegisterForEvent](https://docs.xbox.com/pt-BR/reference/system/xgameinvite/functions/xgameinviteregisterforevent.md).

### Migrando do XGameProtocol e do XGameInvite

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

## Documentação conceitual

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

## Confira também

[Referência de API do sistema](https://docs.xbox.com/pt-BR/reference/system/gc-reference-system-toc.md)\
[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

- [XGame (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xgame/xgame_members.md)
- [XGameUI (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xgameui/xgameui_members.md)
- [XGameEvent (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xgameevent/xgameevent_members.md)
- [XGameStreaming (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameSave (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xgamesave/xgamesave_members.md)