Cloud Save 查询

Understand indexes and query types for both numerical and text data stored in player and game data.

阅读时间4 分钟

最后更新于 8 个月前

您可以使用 Cloud Save 来查询存储在玩家数据和游戏数据中的数字和文本数据。

查询功能可用于多种目的，例如创建公会或氏族系统、添加匹配、实施经济系统或拍卖行，或在多人游戏环境中返回 NPC 或物品数据。

创建索引

您需要先在 Cloud Save 中为数据编制索引，然后才能查询数据。您可以在 Unity Cloud 后台、Unity CLI 或 Admin REST API 中创建和管理索引。

您可以构建单个 Cloud Save 键的索引，或按特定顺序组合多个键以形成复合索引。Cloud Save 为每个键标记一个布尔值，以指定索引是按升序还是降序排序。使用索引无需支付额外费用。

Cloud Save 支持以下类型的查询：

Cloud Save 会将值与索引值进行比较，对于字符串数据，按词法进行比较，对于数字数据，按数值进行比较。

如果不希望返回可以分页的完整排序结果集（默认行为），您可以让 Cloud Save 返回查询的随机结果样本。

要使用此功能，请在执行查询时传递

sampleSize

选项并指定希望 Cloud Save 返回的最大结果数。

您可以将随机样本功能用于以下用例：显示玩家可以加入的一些公会，或随机匹配两个具有相似统计数据的玩家。

可从客户端或服务器查询的数据由索引键的访问类决定：

使用面向 Unity 的 Cloud Save SDK，游戏客户端可以查询公开访问类中的玩家数据，或者查询存储在默认访问类中的游戏数据。
使用面向 Cloud Code 的 Cloud Save SDK，或者使用 CLI 或 Admin REST API，可以查询任何访问类（例如默认、公开、私有或受保护）中的索引键。

可以编制索引的值的最大大小为 128 字节：

大于 128 字节的值不会被索引；如果您尝试将大于 128 字节的值写入到索引键，则索引会失败（数据仍会保存到 Cloud Save，但数据不会被索引）。
最多可以定义 20 个键，这些键可以在所有索引、所有访问类、玩家状态和游戏状态中编制索引。

这意味着，可以有多达 20 个索引，每个索引各包含一个索引键，或者一个索引包含 20 个索引键，或是这两者之间的任意组合。只要索引键的总数不超过限制即可。

重要

重要：您只能查询创建索引后保存的数据。查询响应中不包含您在创建索引之前保存的任何数据。