> ## 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](/zh-TW/reference/system/xgameprotocol/xgameprotocol_members) 和 [XGameInvite](/zh-TW/reference/system/xgameinvite/xgameinvite_members) API。新遊戲應使用 **XGameActivation** 來處理通訊協定啟用、檔案啟用和遊戲邀請。如需移轉指引，請參閱[備註](#remarks)。</Note>

## 函式

| 函式 | 描述 |
| - | - |
| [XGameActivationCallback](/zh-TW/reference/system/xgameactivation/functions/xgameactivationcallback) | 應用程式為啟用事件定義的回呼。 |
| [XGameActivationRegisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationregisterforevent) | 註冊啟用事件的回呼。 |
| [XGameActivationUnregisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) | 取消註冊啟用事件的回呼。 |
| [XGameActivationAcceptPendingInvite](/zh-TW/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) | 接受擱置中的遊戲邀請。 |

## 結構

| 結構 | 描述 |
| - | - |
| [XGameActivationInfo](/zh-TW/reference/system/xgameactivation/structs/xgameactivationinfo) | 包含傳遞給啟用回呼的啟用資訊。 |

## 列舉

| 列舉 | 描述 |
| - | - |
| [XGameActivationType](/zh-TW/reference/system/xgameactivation/enums/xgameactivationtype) | 指定所發生的啟用類型。 |

<a id="remarks" />

## 備註

**XGameActivation** API 為所有形式的遊戲啟用提供統一的回呼機制，包括通訊協定啟用、檔案啟用和遊戲邀請處理。如此一來，就不需要分別向 [XGameProtocolRegisterForActivation](/zh-TW/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation) 和 [XGameInviteRegisterForEvent](/zh-TW/reference/system/xgameinvite/functions/xgameinviteregisterforevent) 註冊。

### 從 XGameProtocol 和 XGameInvite 移轉

| 已淘汰的 API | 取代項目 |
| - | - |
| `XGameProtocolRegisterForActivation` | [XGameActivationRegisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationregisterforevent) |
| `XGameProtocolUnregisterForActivation` | [XGameActivationUnregisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) |
| `XGameInviteRegisterForEvent` | [XGameActivationRegisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationregisterforevent) |
| `XGameInviteUnregisterForEvent` | [XGameActivationUnregisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) |
| `XGameInviteRegisterForPendingEvent` | [XGameActivationRegisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationregisterforevent) |
| `XGameInviteUnregisterForPendingEvent` | [XGameActivationUnregisterForEvent](/zh-TW/reference/system/xgameactivation/functions/xgameactivationunregisterforevent) |
| `XGameInviteAcceptPendingInvite` | [XGameActivationAcceptPendingInvite](/zh-TW/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) |

## 概念文件

* [檔案類型啟用](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [接收邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)
* [傳送邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-send)
* [邀請概觀](/zh-TW/services/xbox-services/multiplayer/invites/live-multiplayer-invites-overview)

## 另請參閱

[系統 API 參考](/zh-TW/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

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