文档

支持

Cloud Save

Unity SDK tutorial

Cloud Save for Cloud Code

Open Unity Dashboard

Cloud Save

Cloud Save 查询

Understand indexes and query types for both numerical and text data stored in player and game data.
阅读时间3 分钟最后更新于 12 天前
您可以使用 Cloud Save 来查询存储在玩家数据和游戏数据中的数字和文本数据。 查询功能可用于多种目的，例如创建公会或氏族系统、添加匹配、实施经济系统或拍卖行，或在多人游戏环境中返回 NPC 或物品数据。

创建索引

您需要先在 Cloud Save 中为数据编制索引，然后才能查询数据。您可以在 Unity Cloud 后台、Unity CLI 或 Admin REST API 中创建和管理索引。 您可以构建单个 Cloud Save 键的索引，或按特定顺序组合多个键以形成复合索引。Cloud Save 为每个键标记一个布尔值，以指定索引是按升序还是降序排序。使用索引无需支付额外费用。

查询类型

Cloud Save 支持以下类型的查询： 
  • EQ
    - 等于
  • NE
    - 不等于
  • LT
    - 小于
  • LE
    - 小于或等于
  • GT
    - 大于
  • GE
    - 大于或等于
Cloud Save 会将值与索引值进行比较，对于字符串数据，按词法进行比较，对于数字数据，按数值进行比较。

随机样本

如果不希望返回可以分页的完整排序结果集（默认行为），您可以让 Cloud Save 返回查询的随机结果样本。 要使用此功能，请在执行查询时传递 
sampleSize
选项并指定希望 Cloud Save 返回的最大结果数。 您可以将随机样本功能用于以下用例：显示玩家可以加入的一些公会，或随机匹配两个具有相似统计数据的玩家。

限制

查询限制

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

索引限制

  • 可以编制索引的值的最大大小为 128 字节： 大于 128 字节的值不会被索引；如果您尝试将大于 128 字节的值写入到索引键，则索引会失败（数据仍会保存到 Cloud Save，但数据不会被索引）。
  • 最多可以定义 20 个键，这些键可以在所有索引、所有访问类、玩家状态和游戏状态中编制索引。 这意味着，可以有多达 20 个索引，每个索引各包含一个索引键，或者一个索引包含 20 个索引键，或是这两者之间的任意组合。只要索引键的总数不超过限制即可。

其他资源