跳转到主要内容
playfab file 管理存储在 PlayFab 实体(例如玩家)上的文件。
每个文件命令都需要 --entity-id 和 --entity-type。对于玩家,请使用 --entity-type title_player_account 传递其游戏玩家帐户 ID,而不是其主玩家帐户 ID;playfab player account get 会将其返回为 UserInfo.TitleInfo.TitlePlayerAccount.Id。

输出

playfab file list 将文件的元数据以 JSON 形式写入 stdout;使用 --output table 时则以表格形式写入,表格显示 FILE NAME、LAST MODIFIED 和 CHECKSUM。 upload、download 和 delete 是文件操作,类似于 cp 和 rm。它们不向 stdout 写入任何内容,而是在 stderr 上报告其执行的操作: 这些消息可能会在不同版本之间发生更改,因此脚本应检查退出代码:操作成功时为 0,失败时为非零值,并且错误会输出到 stderr。这三个命令不接受 --output table,--data-only 也不会更改它们写入的内容。

playfab file list

playfab file download

download 会替换目标路径中已存在的本地文件。
当实体中没有具有该名称的文件时,错误会显示要运行的 file list 命令:

playfab file upload

如果上传失败

在上传过程中,PlayFab 会阻止向该实体的文件进行的所有其他上传,包括游戏自身的上传,这些上传会失败并显示 EntityFileOperationPending。因此,当上传中途失败或你按下 Ctrl+C 时,CLI 会取消上传,并在 stderr 上说明取消是否成功。取消成功时,实体的文件保持不变。 当 CLI 无法取消上传,或者无法判断上传或取消是否已生效时,它会说明这一点。它会输出用于取消挂起上传的命令;当文件可能已更改时,还会输出用于检查的 file list 命令。仅当后续上传因 EntityFileOperationPending 而失败时才运行取消命令,因为它也会取消游戏发起的该文件的上传。

playfab file delete

最后修改于 2026年11月19日