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

# Tratando uma alteração de presença do título

> Exemplos da XSAPI para assinar alterações de presença do título do XBOX Live e configurar manipuladores quando um usuário inicia, interrompe ou suspende um título específico.

Este tópico fornece um exemplo de código para tratar uma alteração de presença do título.

## Assinando uma alteração de presença do título

#### API C simples

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

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

## Cancelando a assinatura de uma alteração de presença do título

#### API C simples

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

state.titlePresenceChangeSubscription = nullptr;
```

## Adicionando um manipulador de alteração de presença do título

#### API C simples

```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
);
```

Para obter mais informações, consulte
[XblPresenceTitleState](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/enums/xblpresencetitlestate.md).

## Removendo um manipulador de alteração de presença do título

#### API C simples

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

state.titlePresenceChangedHandlerToken = 0;
```


## Related topics

- [Código de exemplo do Rich Presence (conteúdo)](https://docs.xbox.com/pt-BR/services/xbox-services/community/presence/how-to/live-presence-howto-nav.md)
- [Instruções](https://docs.xbox.com/pt-BR/services/xbox-services/community/presence/how-to/index.md)
- [Tratando uma alteração de presença do dispositivo](https://docs.xbox.com/pt-BR/services/xbox-services/community/presence/how-to/live-handling-a-device-presence-change.md)
- [Tratando uma alteração de relacionamento social](https://docs.xbox.com/pt-BR/services/xbox-services/community/people-system/how-to/live-handling-a-relationship-change.md)
- [Presença](https://docs.xbox.com/pt-BR/services/xbox-services/community/presence/index.md)