> ## 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 enregistrer automatiquement depuis le client le temps de focus et la durée de session des joueurs.

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

## Versions de SDK prises en charge

La prise en charge des sessions est actuellement disponible *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 ultérieure. Ce SDK introduit pour la première fois deux nouveaux événements qui peuvent être configurés pour être émis automatiquement depuis le client :

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

## Journalisation et gestion des événements

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

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

Actuellement, ces événements sont désactivés par défaut, mais nous prévoyons de changer cela à l’avenir. Vous pouvez gérer la collecte du temps de focus depuis Game Manager :

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

<Note>
  La désactivation de cette option empêche 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 depuis le code, en définissant l’option ci-dessous sur `true` dans la configuration de votre titre, comme indiqué ci-dessous.

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

## Instructions héritées

Si votre jeu utilise un SDK compris entre **180716** et **180809**, vous pouvez envoyer les événements de temps de focus, mais 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 la mise à jour du 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 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/services/xbox-services/multiplayer/mpsd/live-xbox-multiplayer-session-directory.md)
- [XblMultiplayerSessionTimeOfSession](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessiontimeofsession.md)
- [XblMultiplayerSessionSessionConstants](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionconstants.md)
- [XblMultiplayerSessionSessionProperties](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionproperties.md)
- [XblMultiplayerSessionSessionReference](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionreference.md)