设置
登录,将你的 PlayFab 游戏 ID 保存为默认值,然后发出只读请求。 请将ABC123 替换为你的游戏 ID。
--playfab-title-id。请参阅
上下文。
查找 API
PlayFab 记录了每个操作、其请求和响应架构、哪些字段是必填字段,以及它接受哪些凭据:- PlayFab REST API 参考是面向人员编写的。
- PlayFab Swagger 规范
是机器可读的。这些文件以 PlayFab 的 API 组命名,而不是以路径的第一段命名,因此请在文件的
paths中搜索该操作。例如,/Catalog和/Inventory位于Economy.swagger.json中,/Match、/Lobby和/MultiplayerServer位于Multiplayer.swagger.json中。 - 每个操作的
security字段指明其接受的凭据:SecretKey(游戏机密密钥)、EntityToken、SessionTicket(玩家会话)或None。某些操作还会在其说明中列出允许的实体令牌类型。
/<Prefix>/<Operation>,例如 /Admin/GetTitleData,请求正文是该操作的 JSON 请求对象。
示例
这些示例使用playfab api 调用 API,该页面提供了完整的选项参考。Delete* 和 Shutdown* 操作在终端中会先询问,在其他环境中则需要
--confirm;请参阅安全性和破坏性操作。
获取游戏数据
获取一个游戏数据键
设置游戏数据
使用--body 以内联方式传递请求正文:
--body-file 从文件中读取请求正文,此处以 PowerShell 为例:
仅获取数据并输出为单行
--data-only 会去掉响应信封,--output json-compact 会写入单行 JSON,以便通过管道传输:
错误响应
失败的调用会以代码1 退出:
- 当 PlayFab 返回错误时,命令会将 PlayFab 的错误 JSON 写入 stderr,格式由
--output决定。 - 其他失败(例如网络错误)会将纯文本消息写入 stderr。
- 使用
--data-only时,出错时 stdout 为空。
