跳轉到主要內容
playfab file 管理儲存在 PlayFab 實體 (例如玩家) 上的檔案。
每個檔案命令都需要 --entity-id 和 --entity-type。若是玩家,請搭配 --entity-type title_player_account 傳遞其遊戲玩家帳戶 ID,而不是其主要玩家帳戶 ID;playfab player account get 會以 UserInfo.TitleInfo.TitlePlayerAccount.Id 傳回該 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日