> ## 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. # 实体文件 > 以任何格式读取、写入和上传附加到 PlayFab 实体的文件，附带完整的 Unity C# 实体文件循环，涵盖登录、加载和上传。 实体文件使你能够以任何格式读取和写入附加到实体的文件。以下示例演示了完整的实体文件循环，从登录、加载文件到上传新文件。 ```csharp theme={null} #if !DISABLE_PLAYFABENTITY_API && !DISABLE_PLAYFABCLIENT_API using PlayFab; using PlayFab.Internal; using System; using System.Collections.Generic; using System.Text; using UnityEngine; public class EntityFileExample : MonoBehaviour { public string entityId; // Id representing the logged in player public string entityType; // entityType representing the logged in player private readonly Dictionary _entityFileJson = new Dictionary(); private readonly Dictionary _tempUpdates = new Dictionary(); public string ActiveUploadFileName; public string NewFileName; public int GlobalFileLock = 0; // Kind of cheap and simple way to handle this kind of lock void OnSharedFailure(PlayFabError error) { Debug.LogError(error.GenerateErrorReport()); GlobalFileLock -= 1; } void OnGUI() { if (!PlayFabClientAPI.IsClientLoggedIn() && GUI.Button(new Rect(0, 0, 100, 30), "Login")) Login(); if (PlayFabClientAPI.IsClientLoggedIn() && GUI.Button(new Rect(0, 0, 100, 30), "LogOut")) PlayFabClientAPI.ForgetAllCredentials(); if (PlayFabClientAPI.IsClientLoggedIn() && GUI.Button(new Rect(100, 0, 100, 30), "(re)Load Files")) LoadAllFiles(); if (PlayFabClientAPI.IsClientLoggedIn()) { // Display existing files _tempUpdates.Clear(); var index = 0; foreach (var each in _entityFileJson) { GUI.Label(new Rect(100 * index, 60, 100, 30), each.Key); var tempInput = _entityFileJson[each.Key]; var tempOutput = GUI.TextField(new Rect(100 * index, 90, 100, 30), tempInput); if (tempInput != tempOutput) _tempUpdates[each.Key] = tempOutput; if (GUI.Button(new Rect(100 * index, 120, 100, 30), "Save " + each.Key)) UploadFile(each.Key); index++; } // Apply any changes foreach (var each in _tempUpdates) _entityFileJson[each.Key] = each.Value; // Add a new file NewFileName = GUI.TextField(new Rect(100 * index, 60, 100, 30), NewFileName); if (GUI.Button(new Rect(100 * index, 90, 100, 60), "Create " + NewFileName)) UploadFile(NewFileName); } } void Login() { var request = new PlayFab.ClientModels.LoginWithCustomIDRequest { CustomId = SystemInfo.deviceUniqueIdentifier, CreateAccount = true }; PlayFabClientAPI.LoginWithCustomID(request, OnLogin, OnSharedFailure); } void OnLogin(PlayFab.ClientModels.LoginResult result) { entityId = result.EntityToken.Entity.Id; entityType = result.EntityToken.Entity.Type; } void LoadAllFiles() { if (GlobalFileLock != 0) throw new Exception("This example overly restricts file operations for safety. Careful consideration must be made when doing multiple file operations in parallel to avoid conflict."); GlobalFileLock += 1; // Start GetFiles var request = new PlayFab.DataModels.GetFilesRequest { Entity = new PlayFab.DataModels.EntityKey { Id = entityId, Type = entityType } }; PlayFabDataAPI.GetFiles(request, OnGetFileMeta, OnSharedFailure); } void OnGetFileMeta(PlayFab.DataModels.GetFilesResponse result) { Debug.Log("Loading " + result.Metadata.Count + " files"); _entityFileJson.Clear(); foreach (var eachFilePair in result.Metadata) { _entityFileJson.Add(eachFilePair.Key, null); GetActualFile(eachFilePair.Value); } GlobalFileLock -= 1; // Finish GetFiles } void GetActualFile(PlayFab.DataModels.GetFileMetadata fileData) { GlobalFileLock += 1; // Start Each SimpleGetCall PlayFabHttp.SimpleGetCall(fileData.DownloadUrl, result => { _entityFileJson[fileData.FileName] = Encoding.UTF8.GetString(result); GlobalFileLock -= 1; }, // Finish Each SimpleGetCall error => { Debug.Log(error); } ); } void UploadFile(string fileName) { if (GlobalFileLock != 0) throw new Exception("This example overly restricts file operations for safety. Careful consideration must be made when doing multiple file operations in parallel to avoid conflict."); ActiveUploadFileName = fileName; GlobalFileLock += 1; // Start InitiateFileUploads var request = new PlayFab.DataModels.InitiateFileUploadsRequest { Entity = new PlayFab.DataModels.EntityKey { Id = entityId, Type = entityType }, FileNames = new List { ActiveUploadFileName }, }; PlayFabDataAPI.InitiateFileUploads(request, OnInitFileUpload, OnInitFailed); } void OnInitFailed(PlayFabError error) { if (error.Error == PlayFabErrorCode.EntityFileOperationPending) { // This is an error you should handle when calling InitiateFileUploads, but your resolution path might vary GlobalFileLock += 1; // Start AbortFileUploads var request = new PlayFab.DataModels.AbortFileUploadsRequest { Entity = new PlayFab.DataModels.EntityKey { Id = entityId, Type = entityType }, FileNames = new List { ActiveUploadFileName }, }; PlayFabDataAPI.AbortFileUploads(request, (result) => { GlobalFileLock -= 1; UploadFile(ActiveUploadFileName); }, OnSharedFailure); GlobalFileLock -= 1; // Finish AbortFileUploads GlobalFileLock -= 1; // Failed InitiateFileUploads } else OnSharedFailure(error); } void OnInitFileUpload(PlayFab.DataModels.InitiateFileUploadsResponse response) { string payloadStr; if (!_entityFileJson.TryGetValue(ActiveUploadFileName, out payloadStr)) payloadStr = "{}"; var payload = Encoding.UTF8.GetBytes(payloadStr); GlobalFileLock += 1; // Start SimplePutCall PlayFabHttp.SimplePutCall(response.UploadDetails[0].UploadUrl, payload, FinalizeUpload, error => { Debug.Log(error); } ); GlobalFileLock -= 1; // Finish InitiateFileUploads } void FinalizeUpload(byte[] body) // body is unused in this example { GlobalFileLock += 1; // Start FinalizeFileUploads var request = new PlayFab.DataModels.FinalizeFileUploadsRequest { Entity = new PlayFab.DataModels.EntityKey { Id = entityId, Type = entityType }, FileNames = new List { ActiveUploadFileName }, }; PlayFabDataAPI.FinalizeFileUploads(request, OnUploadSuccess, OnSharedFailure); GlobalFileLock -= 1; // Finish SimplePutCall } void OnUploadSuccess(PlayFab.DataModels.FinalizeFileUploadsResponse result) { Debug.Log("File upload success: " + ActiveUploadFileName); GlobalFileLock -= 1; // Finish FinalizeFileUploads } } #endif ``` ## 解构此示例 * `GlobalFileLock` 是避免文件冲突的一种简单化方法，专门为此示例设计。 * 独立的文件操作不会导致任何问题。 * 每个文件操作需要许多步骤和多个 API 调用，因此不要尝试同时以多种方式访问同一文件。 * 如果你小心谨慎，则不需要任何锁定机制。 * 如果你想做一些复杂的事情，你的锁定机制可能会复杂得多。 * `OnGUI` 是一种老式但非常密集的方法，用于完全在脚本中构建 Unity GUI。 * 你的 GUI 将好得多，并且是游戏特定的。 * 所有 PlayFab 功能*首先*都需要登录或身份验证。 * `LoadAllFiles()` 完全按照它所说的执行。对于当前登录的实体，它加载保存到 PlayFab 的所有文件。 * 此函数需要多个步骤： * 询问 PlayFab 文件所在的位置， * 然后单独下载它们。 * `UploadFile(string fileName)` 将文件保存到实体的服务中。 * 为简单起见，此示例一次保存一个文件，但你也可以以原子方式集合上传文件。 * 此操作的步骤是： * 初始化原子上传操作， * 上传所有文件， * 完成原子上传操作。 * 直到原子上传操作成功完成之前，实体不会将文件上传视为完成，也不会反映给其他调用者的任何更改。 ## Game Manager 和实体 Game Manager 允许你为玩家操作对象和文件。玩家概览已更新，可同时显示 title player 和 master player account 信息。 Game Manager - Entities - Player overview 此外，**Players** 选项卡现在包括文件和对象的独立部分。 Game Manager - Entities - Player Files and Objects ## 相关功能 实体对象和文件在多个 PlayFab 功能中使用，每个功能都作用于不同的实体类型： | 功能 | 实体类型 | 用例 | | ---------------------------------------------------------------------------------- | ------------------------------------------------------------ | ----------------- | | [Game Server 配置](/services/playfab/live-service-management/game-configuration) | `game_server` | 服务器端设置和服务器权威数据 | | [Title 数据](/services/playfab/live-service-management/game-configuration/titledata) | `namespace`, `title` | 在所有玩家之间共享的全局键/值配置 | | [玩家数据](/services/playfab/player-progression/player-data) | `title_player_account`, `master_player_account`, `character` | 每位玩家的配置文件、进度和偏好存储 | | [群组](/services/playfab/community/associations/groups) | `group` | 在玩家群组或公会内共享的数据 | ## Related topics - [实体快速入门](/zh-CN/services/playfab/live-service-management/game-configuration/entities/quickstart.md) - [PlayFab GDPR - 删除玩家数据](/zh-CN/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md) - [PlayFab GDPR - 导出玩家数据](/zh-CN/services/playfab/data-analytics/privacy-compliance/gdpr-exporting-player-data.md) - [游戏服务器配置概述](/zh-CN/services/playfab/live-service-management/game-configuration/index.md) - [PFProfilesEntityProfileFileMetadata](/zh-CN/services/playfab/api-references/c/pfprofilestypes/structs/pfprofilesentityprofilefilemetadata.md)