XBOX 服务 Title Storage 概述

本主题介绍什么是 XBOX 服务 Title Storage,它有哪些功能,并演示如何进行配置。 XBOX 服务 Title Storage 服务提供云存储,用于存放大量按玩家或按游戏的数据。你可以使用它存储玩家统计信息和资产。运行于所有 XBOX 平台的游戏均可使用 Title Storage。

XBOX 服务 Title Storage 的功能

XBOX 服务 Title Storage 包括以下高级功能。

可跨玩家、title 和各种平台共享
支持 JSON、二进制和配置文件

存储类型

存储类型	配额 (Managed Partners)	配额 (Creators Program)	用途	平台	玩家
Trusted Platform	每位玩家 256 MB	每位玩家 64 MB	按玩家的数据,例如已保存的游戏或用于播放/暂停/继续的游戏状态。更安全,但存在平台限制。	任何平台均可读取,但只有 XBOX One 系列(或更高版本)、XBOX 360 或 Windows Phone 可写入。	可配置为公开或仅限所有者。
Universal Platform	每位玩家 64 MB	每位玩家 64 MB	按玩家的数据,例如已保存的游戏或用于播放/暂停/继续的游戏状态。	任何平台均可读取或写入。	可配置为公开或仅限所有者。
Global	256 MB	256 MB	所有人都可以读取的数据,例如名册、地图、挑战或美术资源。	只能通过 XBOX 开发者门户或合作伙伴中心写入,任何平台均可读取。	所有玩家均可读取。

限流限制

每分钟一个 title 可执行的读取和写入次数没有硬性限制,但在一小时会话内,平均每分钟通常不能超过一次。例如,一个 title 可在会话开始时进行 60 次读取或写入,但在该小时的其余时间内不能再执行更多。Title 应做好准备,以应对之后调用被限制的情况,以防 XBOX 服务需要对请求进行限流。

如果你的 title 有特殊的分区需求(例如额外的读取或写入),请联系你的 Microsoft 代表。

数据类型

本节介绍三种受支持的类型。

二进制信息
JSON 信息
配置信息

二进制信息

二进制信息包括图像、声音和自定义数据等。由于数据必须通过 HTTP 传输,二进制数据必须编码为 HTTP 可接受的字符。例如,你可以将数据转换为十六进制字符串,或使用 base64 编码。Title Storage 不会处理已编码的数据,因此你的游戏在从 Title Storage 读取和写入数据时,必须使用相同的方案进行编码和解码。

JSON 信息

JSON 信息包括结构化数据(键值对)。你可以在支持的语言(例如 JavaScript)中使用 JSON 对象。从 JSON 文件检索数据时,游戏可以提供 selectQuery 参数,以返回结构中特定的项。例如,你可以使用包含以下信息的 JSON 文件。

{
"difficulty" : 1,
"level" :
    [
        { "number" : "1", "quest" : "swords" },
        { "number" : "2", "quest" : "iron" },
        { "number" : "3", "quest" : "gold" },
        { "number" : "4", "quest" : "queen" }
        ],
"weapon" :
    {
            "name" : "poison",
            "timeleft" : "2mins"
    }
}

出于安全原因,JSON 数据的第一个元素不能是数组。以数组为根提交的 JSON 数据将被服务拒绝。

你的游戏可以将 JSON 结构的部分选中为 selectQuery(例如 weapon.name),然后将收到以下内容:

{
    "name" : "poison"
}

配置信息

配置 blob 是存储在 global title storage 中的数据结构。配置 blob 的格式类似于 JSON 对象。配置 blob 可以包含虚拟节点,这些节点会从可能的选项列表中返回一个设置。虚拟节点对于为特定情形(例如某个 title 或区域设置)提供设置非常有用。虚拟节点包括多个可能的设置,以及用于从这些值中选择的值和条件。在下面的示例中,defaultCardDesign 设置可以取虚拟节点中的一个值。

{
    "defaultCardDesign":
    {
    "_virtualNode":
    {
        "_selectBy":"titleId",
        "_sourceNodes":
        [
        {"_selector":"123456799", "_data":"RobotUnicornCard.png,binary"},
        {"_selector":"default", "_data":"StandardCard.png,binary"}
        ]
    }
    },
}

当游戏读取此文件时,系统会从 \_sourceNodes 数组中选择一个值。在本例中,该项是根据游戏的 title ID 选择的。例如,玩游戏 12456799 的玩家会看到以下内容:

{
    "defaultCardDesign":"RobotUnicornCard.png,binary",
    "_sourceNodes":["defaultCardDesign:titleID:1234567899"]
}

未玩该游戏的玩家会看到以下内容:

{
    "defaultCardDesign":"StandardCard.png,binary",
    "_sourceNodes":["defaultCardDesign:titleID:default"]
}

游戏可以定义与请求中的某个参数匹配的自定义选择器。例如,考虑此配置 blob 中的以下 JSON 对象。

{
    "defaultCardDesign":
    {
        "_virtualNode":
        {
            "_selectBy":"custom:gameMode",
            "_sourceNodes":
            [
                {"_selector":"silly", "_data":"RobotUnicornCard.png,binary"},
                {"_selector":"serious", "_data":"SeriousCard.png,binary"},
                {"_selector":"default", "_data":"StandardCard.png,binary"}
                ]
        }
    },
    "backgroundColor":"green",
    "dealerHitsOnSoft17":true
}

游戏在 customSelector 参数中传入字符串以选择要返回的项。例如,要获取第二个选项,游戏应将 gameMode.serious 作为 selectQuery 请求。

开始使用 XBOX 服务 Title Storage

确定你要存储哪种数据。示例包括已保存的游戏、游戏状态、每日挑战、游戏地图和美术资源。
确定哪些 title 和平台需要访问该数据。Title Storage 支持从单个平台上的单个 title 以及多个平台上的多个 title 进行云数据访问。

XBOX Services

PlayFab

XBOX 服务 Title Storage 的功能

存储类型

限流限制

数据类型

二进制信息

JSON 信息

配置信息

开始使用 XBOX 服务 Title Storage

​XBOX 服务 Title Storage 的功能

​存储类型

​限流限制

​数据类型

​二进制信息

​JSON 信息

​配置信息

​开始使用 XBOX 服务 Title Storage

XBOX 服务 Title Storage 的功能

存储类型

限流限制

数据类型

二进制信息

JSON 信息

配置信息

开始使用 XBOX 服务 Title Storage