> ## 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](/zh-TW/services/playfab/api-references/events/Session/client-session-start)
2. [client\_focus\_change](/zh-TW/services/playfab/api-references/events/Session/client-focus-change)

## 記錄和管理事件

若要開始收集這兩個事件，您必須先在用戶端中整合 Unity SDK。

如需相關操作說明，請參閱 [Unity3D 快速入門](/zh-TW/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" />

您也可以從程式碼停用這些事件，方法是在遊戲設定中將下列選項設定為 `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-TW/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants.md)
- [多人遊戲工作階段目錄](/zh-TW/services/xbox-services/multiplayer/mpsd/live-xbox-multiplayer-session-directory.md)
- [多人遊戲工作階段瀏覽](/zh-TW/services/xbox-services/multiplayer/concepts/live-session-browse.md)
- [多人遊戲工作階段範本](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates.md)
- [多人遊戲工作階段進階主題](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)