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

# 会话

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

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

## 支持的 SDK 版本

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

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

1. [client\_session\_start](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Session/client-session-start.md)
2. [client\_focus\_change](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Session/client-focus-change.md)

## 记录和管理事件

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

有关如何执行此操作的说明，可以在 [Unity3D 快速入门](https://docs.xbox.com/zh-CN/services/playfab/sdks/unity3d/quickstart.md) 中找到。

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

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

> [!NOTE]
>
> 禁用此选项将阻止客户端发出这些事件。

![Game Manager - Settings - Data Collection](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)

你还可以通过代码禁用这些，通过在你的 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** 标志已启用（选中）。

![PlayFab - Settings - Enable Entity API](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)

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

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

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


## Related topics

- [会话模板常量](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md)
- [多人游戏会话目录](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpsd/live-xbox-multiplayer-session-directory.md)
- [多人游戏会话模板](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates.md)
- [验证会话票证](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/server/authentication/authenticate-session-ticket.md)
- [按会话 ID 获取多人游戏会话日志](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/multiplayer/multiplayer-server/get-multiplayer-session-logs-by-session-id.md)