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

# gamesave_version_finalized

> gamesave_version_finalized 事件。

当游戏存档版本在所有文件完全上传后完成最终确定时触发此事件。

## 属性

| 名称                     | 类型                                                                                      | 说明                                                         |
| :--------------------- | :-------------------------------------------------------------------------------------- | :--------------------------------------------------------- |
| Version                | Int64                                                                                   | 被最终确定的游戏存档版本。                                              |
| PlayerIdentityProvider | String                                                                                  | 上传游戏存档的玩家使用的登录身份提供程序。                                      |
| DeviceType             | String                                                                                  | 此游戏存档版本使用的设备类型。                                            |
| FinalizedAt            | DateTime                                                                                | 游戏存档版本被最终确定的时间。                                            |
| NewFileCount           | Int32                                                                                   | 为此版本添加到游戏存档存储中的新文件数量。                                      |
| NewFilesSizeBytes      | Int64                                                                                   | 为此版本添加到游戏存档存储中的新文件的大小（字节）。                                 |
| TotalFileCount         | Int32                                                                                   | 最终确定的游戏存档版本中包含的文件总数。                                       |
| TotalSizeBytes         | Int64                                                                                   | 最终确定的游戏存档版本的总大小（字节），包括所有文件。                                |
| IsGeneratedByRollback  | Boolean                                                                                 | 该版本是否由回滚操作生成并最终确定。                                         |
| Conflict               | [GameSaveConflict](/services/playfab/api-references/events/data-types/gamesaveconflict) | 关于在最终确定游戏存档版本过程中发生的任何冲突的数据。如果该版本不是在冲突解决操作期间最终确定的，通常为 null。 |

## 通用属性

所有 V2 PlayStream 事件均格式化为 JSON 对象，并且大多数事件共享以下通用属性：

| 名称                 | 类型                                                                            | 说明                             |
| :----------------- | :---------------------------------------------------------------------------- | :----------------------------- |
| SchemaVersion      | String                                                                        | PlayStream 事件格式版本，遵循语义化版本控制方案。 |
| FullName           | [Object](/services/playfab/api-references/events/data-types/fullnameobject)   | 事件名称和事件命名空间的组合，用于完全指定事件类型。     |
| Id                 | String                                                                        | PlayFab 为此事件分配的唯一标识符。          |
| Timestamp          | DateTime                                                                      | 与此事件关联的时间（UTC）。                |
| Entity             | [Object](/services/playfab/api-references/events/data-types/entityobject)     | 与此事件相关的实体的详细信息，包括实体 ID 和实体类型。  |
| Originator         | [Object](/services/playfab/api-references/events/data-types/originatorobject) | 描述发起此事件的来源和来源类型的对象。            |
| PayloadContentType | String                                                                        | 指定事件负载的内容。默认为 "JSON"。          |
| Origin Info        | Object                                                                        | 可选字段，包含关于源自 PlayFab 外部的事件的信息。  |


## Related topics

- [游戏存档 PlayStream 事件](/zh-CN/services/playfab/player-progression/game-saves/playstream-events.md)
- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [gamesave_version_marked_known_good](/zh-CN/services/playfab/api-references/events/GameSave/gamesave-version-marked-known-good.md)
- [GameSaveConflict](/zh-CN/services/playfab/api-references/events/data-types/gamesaveconflict.md)
- [XBOX Live 页面](/zh-CN/tools/tools-console/wdp/windows-device-portal-on-xbox-xbl.md)