Passer au contenu principal
playfab file gère les fichiers stockés sur une entité PlayFab, comme un joueur.
Chaque commande de fichier nécessite --entity-id et --entity-type. Pour un joueur, passez l’ID de son compte joueur de titre avec --entity-type title_player_account, et non l’ID de son compte joueur principal ; playfab player account get le renvoie sous la forme UserInfo.TitleInfo.TitlePlayerAccount.Id.

Sortie

playfab file list écrit les métadonnées des fichiers sur stdout au format JSON, ou sous forme de tableau avec --output table, qui affiche FILE NAME, LAST MODIFIED et CHECKSUM. upload, download et delete sont des opérations sur les fichiers, comme cp et rm. Elles n’écrivent rien sur stdout et signalent ce qu’elles ont fait sur stderr : Ces messages peuvent changer d’une version à l’autre : les scripts doivent donc vérifier le code de sortie, 0 lorsque l’opération a réussi, et une valeur différente de zéro lorsqu’elle a échoué, avec l’erreur sur stderr. Ces trois commandes n’acceptent pas --output table, et --data-only ne modifie pas ce qu’elles écrivent.

playfab file list

playfab file download

download remplace un fichier local qui se trouve déjà au chemin de destination.
Lorsque l’entité n’a aucun fichier portant ce nom, l’erreur affiche la commande file list à exécuter :

playfab file upload

En cas d’échec d’un chargement

Pendant qu’un chargement est en cours, PlayFab bloque tous les autres chargements vers les fichiers de l’entité, y compris ceux du jeu lui-même, qui échouent avec EntityFileOperationPending. Ainsi, lorsqu’un chargement échoue en cours de route, ou que vous appuyez sur Ctrl+C, la CLI l’annule et indique sur stderr si l’annulation a fonctionné. Lorsque l’annulation fonctionne, les fichiers de l’entité restent inchangés. Lorsque la CLI ne peut pas annuler le chargement, ou ne peut pas déterminer si le chargement ou l’annulation a été appliqué, elle l’indique. Elle affiche la commande qui annule le chargement en attente et, lorsque le fichier a pu être modifié, la commande file list permettant de le vérifier. N’exécutez la commande d’annulation que si les chargements suivants échouent avec EntityFileOperationPending, car elle annule également un chargement de ce fichier que le jeu a démarré.

playfab file delete

Dernière modification le 19 novembre 2026