> ## 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

XGameActivation API 参考资料。

<Note>**XGameActivation** API 替代已弃用的 [XGameProtocol](/reference/system/xgameprotocol/xgameprotocol_members) 和 [XGameInvite](/reference/system/xgameinvite/xgameinvite_members) API。新游戏应使用 **XGameActivation** 来处理协议激活、文件激活和游戏邀请。有关迁移指南，请参阅[备注](#remarks)。</Note>

## Functions

| Function                                                                                                             | Description     |
| -------------------------------------------------------------------------------------------------------------------- | --------------- |
| [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)                       | 应用程序为激活事件定义的回调。 |
| [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       | 注册激活事件的回调。      |
| [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   | 取消注册激活事件的回调。    |
| [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) | 接受挂起的游戏邀请。      |

## Structures

| Structure                                                                            | Description     |
| ------------------------------------------------------------------------------------ | --------------- |
| [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) | 包含传递给激活回调的激活信息。 |

## Enumerations

| Enumeration                                                                        | Description |
| ---------------------------------------------------------------------------------- | ----------- |
| [XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype) | 指定发生的激活类型。  |

<a id="remarks" />

## Remarks

**XGameActivation** API 为所有形式的游戏激活（包括协议激活、文件激活和游戏邀请处理）提供统一的回调机制。这消除了单独向 [XGameProtocolRegisterForActivation](/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation) 和 [XGameInviteRegisterForEvent](/reference/system/xgameinvite/functions/xgameinviteregisterforevent) 注册的需要。

### 从 XGameProtocol 和 XGameInvite 迁移

| 已弃用的 API                               | 替代项                                                                                                                  |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `XGameProtocolRegisterForActivation`   | [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       |
| `XGameProtocolUnregisterForActivation` | [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   |
| `XGameInviteRegisterForEvent`          | [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       |
| `XGameInviteUnregisterForEvent`        | [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   |
| `XGameInviteRegisterForPendingEvent`   | [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       |
| `XGameInviteUnregisterForPendingEvent` | [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   |
| `XGameInviteAcceptPendingInvite`       | [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) |

## Conceptual documentation

* [文件类型激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [接收邀请](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)
* [发送邀请](/services/xbox-services/multiplayer/invites/how-to/live-invites-send)
* [邀请概述](/services/xbox-services/multiplayer/invites/live-multiplayer-invites-overview)

## See also

[系统 API 参考](/reference/system/gc-reference-system-toc)\
[协议激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/protocolactivation)\
[文件类型激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)


## Related topics

- [XGameActivationCallback](/zh-CN/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivationInfo](/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md)
- [XGameActivationType](/zh-CN/reference/system/xgameactivation/enums/xgameactivationtype.md)
- [XGameActivationRegisterForEvent](/zh-CN/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)
- [XGameActivationUnregisterForEvent](/zh-CN/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md)