在线服务用户文件接口(Online Services User File Interface) 支持你的游戏在运行时从平台的后端在线服务读取特定于用户的文件。
你的游戏可能需要你读取没有随作品打包的用户文件。示例可能包括配置文件或特定于用户的游戏存档文件。此接口可帮助你访问和下载这些文件,供在运行时使用。
对于特定于作品的文件存储,请参阅作品文件接口。
API概述
函数
下表概述了用户文件接口提供的函数:
| 函数 | 说明 |
|---|---|
EnumerateFiles |
枚举所有可用文件。 |
GetEnumeratedFiles |
检索通过调用 EnumerateFiles 枚举的文件的缓存列表。 |
ReadFile |
读取文件并返回其内容。 |
WriteFile |
将文件内容写入带有提供的名称的文件。 |
CopyFile |
将文件内容复制到另一个文件。 |
DeleteFile |
删除文件。 |
读取文件的流程
要使用用户文件接口从后端在线服务读取、复制或删除文件,请执行以下步骤:
1.EnumerateFiles 会缓存一个文件列表,列明所有可使用接口从在线服务检索的文件。
1.GetEnumeratedFiles 会检索通过 EnumerateFiles 使用接口缓存的文件的列表。
1.对于检索的列表中的每个文件, ReadFile 会读取该文件并返回其内容。
修改文件
用户文件接口还支持修改文件的操作:
WriteFile会创建新文件或覆盖现有文件。CopyFile会将用户文件的内容复制到不同的用户文件。DeleteFile会从后端在线服务删除带有提供的名称的用户文件。
更多信息
头文件
直接查阅 UserFile.h 头文件,根据需要了解更多信息。用户文件接口头文件 UserFile.h 位于以下目录中:
UNREAL_ENGINE_ROOT\Engine\Plugins\Online\OnlineServices\Source\OnlineServicesInterface\Public\Online
如需有关如何获取UE源代码的说明,请参阅关于下载虚幻引擎源代码的文档。