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

# 处理游戏 Presence 更改

> 订阅 XBOX Live 游戏 Presence 更改，并在用户启动、停止或挂起特定游戏时连接处理程序的 XSAPI 示例。

本主题提供处理游戏 Presence 更改的示例代码。

## 订阅游戏 Presence 更改

#### Flat C API

```cpp theme={null}
uint64_t xuid{ 123 };

HRESULT hr = XblPresenceSubscribeToTitlePresenceChange(
    xboxLiveContext,
    xuid,
    titleId,
    &state.titlePresenceChangeSubscription
);
```

## 取消订阅游戏 Presence 更改

#### Flat C API

```cpp theme={null}
HRESULT hr = XblPresenceUnsubscribeFromTitlePresenceChange(
    xboxLiveContext,
    state.titlePresenceChangeSubscription
);

state.titlePresenceChangeSubscription = nullptr;
```

## 添加游戏 Presence 更改处理程序

#### Flat C API

```cpp theme={null}
state.titlePresenceChangedHandlerToken =  XblPresenceAddTitlePresenceChangedHandler(
    xboxLiveContext,
    [](void* context, uint64_t xuid, uint32_t titleId, XblPresenceTitleState titleState)
    {
        UNREFERENCED_PARAMETER(context);
        LogToFile("Title presence change notification received:");
        LogToFile("Xuid = %u, titleId = %u, titleState = %u", xuid, titleId, titleState);
    },
    nullptr
);
```

有关详细信息，请参阅
[XblPresenceTitleState](/reference/live/xsapi-c/presence_c/enums/xblpresencetitlestate)。

## 删除游戏 Presence 更改处理程序

#### Flat C API

```cpp theme={null}
HRESULT hr = XblPresenceRemoveTitlePresenceChangedHandler(
    xboxLiveContext,
    state.titlePresenceChangedHandlerToken
);

state.titlePresenceChangedHandlerToken = 0;
```


## Related topics

- [Rich Presence 示例代码](/zh-CN/services/xbox-services/community/presence/how-to/live-presence-howto-nav.md)
- [处理设备 Presence 更改](/zh-CN/services/xbox-services/community/presence/how-to/live-handling-a-device-presence-change.md)
- [操作指南](/zh-CN/services/xbox-services/community/presence/how-to/index.md)
- [XblPresenceAddTitlePresenceChangedHandler](/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresenceaddtitlepresencechangedhandler.md)
- [多人游戏会话高级主题](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)