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 而失败时才运行取消命令,因为它也会取消游戏发起的该文件的上传。
