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

# 会话

> 如何在 Unity SDK 中启用和管理 PlayFab 会话事件，以自动从客户端记录玩家的焦点时间和会话持续时间。

PlayFab 支持记录事件以计算焦点时间和会话持续时间。你可以在我们的 [博客](https://blog.playfab.com/blog/sessions-preview-is-live) 上了解更多信息。

## 支持的 SDK 版本

目前会话支持*仅*在 Unity SDK 中可用。将来会添加对我们其他 SDK 的支持。

你需要具有 **180829** 版本或更新版本。此 SDK 首先引入了两个新事件，可以配置为从客户端自动发出：

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

## 记录和管理事件

若要开始收集这两个事件，你首先需要在你的客户端中集成 Unity SDK。

有关如何执行此操作的说明，可以在 [Unity3D 快速入门](/services/playfab/sdks/unity3d/quickstart) 中找到。

目前，这些事件默认情况下处于禁用状态，尽管我们计划将来更改此设置。你可以从 Game Manager 管理焦点时间的收集：

* 导航到 **Settings**。
* 前往 **Data Collection**。
* 在 **Options** 部分中，将此选项切换为 **ON** 或 **OFF**。

<Note>
  禁用此选项将阻止客户端发出这些事件。
</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" />

你还可以通过代码禁用这些，通过在你的 title 设置中将下面显示的选项设置为 `true`，如下所示。

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

## 旧版说明

如果你的游戏使用 **180716** 和 **180809** 之间的 SDK，你可以发送焦点时间事件，但需要额外的步骤。

由于这些事件利用 [WriteEvents](xref:titleid.playfabapi.com.events.playstreamevents.writeevents) API，你首先需要确保在更新 SDK 时 SDK 设置中的 **Enable Entity API** 标志已启用（选中）。

<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" />

接下来，你需要登录实体系统，方法是将下面显示的行添加到你的每个登录请求中。

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

完成后，你应该会看到这些相同的事件。


## Related topics

- [会话模板常量](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md)
- [多人游戏会话模板](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates.md)
- [多人游戏会话目录 (MPSD)](/zh-CN/services/xbox-services/multiplayer/mpsd/live-mpsd-nav.md)
- [多人游戏会话目录概述](/zh-CN/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [多人游戏会话高级主题](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)