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

# Sessions

> Comment activer et gérer les événements de session PlayFab dans le SDK Unity pour journaliser automatiquement, à partir du client, le temps d'activité et la durée des sessions des joueurs.

PlayFab prend en charge la journalisation d'événements pour calculer le temps d'activité (focus time) et la durée des sessions. Vous pouvez en apprendre davantage sur notre [blogue](https://blog.playfab.com/blog/sessions-preview-is-live).

## Versions de SDK prises en charge

La prise en charge des sessions est actuellement offerte *uniquement* dans le SDK Unity. La prise en charge de nos autres SDK sera ajoutée ultérieurement.

Vous devez disposer de la version **180829** ou d'une version plus récente. Ce SDK introduit d'abord deux nouveaux événements qui peuvent être configurés pour être émis automatiquement à partir du client :

1. [client\_session\_start](/fr-CA/services/playfab/api-references/events/Session/client-session-start)
2. [client\_focus\_change](/fr-CA/services/playfab/api-references/events/Session/client-focus-change)

## Journaliser et gérer les événements

Pour commencer à collecter ces deux événements, vous devez d'abord intégrer le SDK Unity dans votre client.

Les instructions pour le faire se trouvent dans le [démarrage rapide Unity3D](/fr-CA/services/playfab/sdks/unity3d/quickstart).

Actuellement, ces événements sont désactivés par défaut, bien que nous prévoyions changer cela à l'avenir. Vous pouvez gérer la collecte du temps d'activité à partir de Game Manager :

* Accédez à **Settings**.
* Allez dans **Data Collection**.
* Dans la section **Options**, réglez cette option sur **ON** ou **OFF**.

<Note>
  La désactivation de cette option empêchera le client d'émettre ces événements.
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/data-analytics/legacy/tutorials/game-manager-settings-data-collection.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=44102c22ead45a94d4544d00873a19c9" alt="Game Manager - Settings - Data Collection" width="873" height="650" data-path="images/playfab/data-analytics/legacy/tutorials/game-manager-settings-data-collection.png" />

Vous pouvez également les désactiver à partir du code, en réglant l'option illustrée ci-dessous à `true` dans la configuration de votre titre.

```csharp theme={null}
PlayFabSettings.DisableFocusTimeCollection = true
```

## Instructions héritées

Si votre jeu utilise un SDK entre les versions **180716** et **180809**, il vous est possible d'envoyer les événements de temps d'activité, bien que cela nécessite des étapes supplémentaires.

Comme ces événements s'appuient sur l'API [WriteEvents](xref:titleid.playfabapi.com.events.playstreamevents.writeevents), vous devez d'abord vous assurer que l'indicateur **Enable Entity API** est activé (coché) dans les paramètres du SDK au moment de mettre à jour le SDK.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/data-analytics/legacy/tutorials/playfab-settings-enable-entity-api.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=be9f6c7db1aae958fb23c8a31c8d11bf" alt="PlayFab - Settings - Enable Entity API" width="701" height="699" data-path="images/playfab/data-analytics/legacy/tutorials/playfab-settings-enable-entity-api.png" />

Ensuite, vous devez vous connecter au système d'entités en ajoutant la ligne illustrée ci-dessous à chacune de vos requêtes de connexion.

```csharp theme={null}
LoginTitlePlayerAccountEntity
```

Une fois cela fait, vous devriez voir ces mêmes événements.


## Related topics

- [Multiplayer Session Directory](/fr-CA/services/xbox-services/multiplayer/mpsd/live-xbox-multiplayer-session-directory.md)
- [XblMultiplayerSessionSessionReference](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionreference.md)
- [XblMultiplayerSessionTimeOfSession](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessiontimeofsession.md)
- [XblMultiplayerSessionSessionConstants](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionconstants.md)
- [XblMultiplayerSessionSessionProperties](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionproperties.md)