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

## 함수

| 함수                                                                                                                   | 설명                              |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)                       | 활성화 이벤트에 대해 애플리케이션이 정의하는 콜백입니다. |
| [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent)       | 활성화 이벤트에 대한 콜백을 등록합니다.          |
| [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)   | 활성화 이벤트에 대한 콜백을 등록 해제합니다.       |
| [XGameActivationAcceptPendingInvite](/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite) | 보류 중인 게임 초대를 수락합니다.             |

## 구조체

| 구조체                                                                                  | 설명                          |
| ------------------------------------------------------------------------------------ | --------------------------- |
| [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) | 활성화 콜백에 전달되는 활성화 정보를 포함합니다. |

## 열거형

| 열거형                                                                                | 설명                  |
| ---------------------------------------------------------------------------------- | ------------------- |
| [XGameActivationType](/reference/system/xgameactivation/enums/xgameactivationtype) | 발생한 활성화의 유형을 지정합니다. |

<a id="remarks" />

## 설명

**XGameActivation** API는 프로토콜 활성화, 파일 활성화 및 게임 초대 처리를 포함한 모든 형태의 게임 활성화에 대해 통합된 콜백 메커니즘을 제공합니다. 이는 [XGameProtocolRegisterForActivation](/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation) 및 [XGameInviteRegisterForEvent](/reference/system/xgameinvite/functions/xgameinviteregisterforevent)에 별도로 등록해야 할 필요성을 없앱니다.

### XGameProtocol 및 XGameInvite에서 마이그레이션

| 사용되지 않는 API                            | 대체 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) |

## 개념 문서

* [파일 형식 활성화](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)

## 함께 보기

[시스템 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)