> ## 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（API 内容）

> XGameActivation

# XGameActivation

XGameActivation API 参考资料。

> [!NOTE]
>
> **XGameActivation** API 替代已弃用的 [XGameProtocol](https://docs.xbox.com/zh-CN/reference/system/xgameprotocol/xgameprotocol_members.md) 和 [XGameInvite](https://docs.xbox.com/zh-CN/reference/system/xgameinvite/xgameinvite_members.md) API。新游戏应使用 **XGameActivation** 来处理协议激活、文件激活和游戏邀请。有关迁移指南，请参阅[备注](#remarks)。

## Functions

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

## Structures

| Structure | Description |
| - | - |
| [XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md) | 包含传递给激活回调的激活信息。 |

## Enumerations

| Enumeration | Description |
| - | - |
| [XGameActivationType](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/enums/xgameactivationtype.md) | 指定发生的激活类型。 |

## Remarks

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

### 从 XGameProtocol 和 XGameInvite 迁移

| 已弃用的 API | 替代项 |
| - | - |
| `XGameProtocolRegisterForActivation` | [XGameActivationRegisterForEvent](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md) |
| `XGameProtocolUnregisterForActivation` | [XGameActivationUnregisterForEvent](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md) |
| `XGameInviteRegisterForEvent` | [XGameActivationRegisterForEvent](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md) |
| `XGameInviteUnregisterForEvent` | [XGameActivationUnregisterForEvent](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md) |
| `XGameInviteRegisterForPendingEvent` | [XGameActivationRegisterForEvent](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md) |
| `XGameInviteUnregisterForPendingEvent` | [XGameActivationUnregisterForEvent](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md) |
| `XGameInviteAcceptPendingInvite` | [XGameActivationAcceptPendingInvite](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md) |

## Conceptual documentation

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

## See also

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


## Related topics

- [XGame（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xgame/xgame_members.md)
- [XGameUI（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xgameui/xgameui_members.md)
- [XGameSave（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xgamesave/xgamesave_members.md)
- [XGameStreaming（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameEvent（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xgameevent/xgameevent_members.md)