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

# XGameActivationType

> XGameActivationType

# XGameActivationType

指定发生的激活类型。

## Syntax

```cpp theme={null}
enum class XGameActivationType : uint32_t  
{  
    Protocol = 0,  
    File = 1,  
    PendingGameInvite = 2,  
    AcceptedGameInvite = 3  
}  
```

## Constants

| Constant | Description |
| - | - |
| Protocol | 游戏通过自定义协议 URI 激活。[XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md) 的 `protocolUri` 字段包含激活 URI。有关详细信息，请参阅[协议激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/protocolactivation)。 |
| File | 游戏通过文件关联激活。[XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md) 的 `file` 字段包含文件路径。有关详细信息，请参阅[文件类型激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)。 |
| PendingGameInvite | 游戏收到了尚未接受的游戏邀请。[XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md) 的 `inviteUri` 字段包含邀请 URI。游戏应向用户呈现 UI 以接受或拒绝邀请，如果用户接受，则调用 [XGameActivationAcceptPendingInvite](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)。 |
| AcceptedGameInvite | 因用户接受游戏邀请而激活游戏。[XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md) 的 `inviteUri` 字段包含邀请 URI。 |

## Remarks

**XGameActivationType** 由 [XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md) 结构使用，用于指示触发 [XGameActivationCallback](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationcallback.md) 的激活类型。激活类型决定了 `XGameActivationInfo` 联合的哪个字段包含有效数据。

此枚举设计为可扩展的。将来的 GDK 版本可能会添加其他激活类型。游戏应通过忽略未知值来正常处理它们。

## Requirements

**头文件：** XGameActivation.h

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## See also

[XGameActivation](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/xgameactivation_members.md)\
[XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md)\
[XGameActivationCallback](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationcallback.md)


## Related topics

- [XGameActivationInfo](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/structs/xgameactivationinfo.md)
- [XGameActivationCallback](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameActivation（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationAcceptPendingInvite](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationacceptpendinginvite.md)
- [XGameActivationRegisterForEvent](https://docs.xbox.com/zh-CN/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)