Skip to content

S-📈 游戏数据存储

GameDataStorage 是游戏中的数据存储系统,它提供了以下核心功能:

  • 数据管理:以键值对形式存储和管理游戏数据
  • 空间控制:支持单地图和组地图的数据存储空间管理
  • 原子操作:提供安全的数据读写和更新机制

你可以通过全局对象 storage 来使用这些功能。

类定义

typescript
declare const storage: GameStorage;
declare class GameStorage {
  //...
}

属性列表

基础信息

  • key : 获取数据存储空间名称

方法列表

空间管理

  • getDataStorage : 【单地图】连接指定数据存储空间,如果不存在则创建一个新的空间
  • getGroupStorage :【主副图】连接指定数据存储空间,如果不存在则创建一个新的空间
  • destroy : 删除该数据空间

数据操作

  • set : 传入指定键与值,无论该键是否存在,均将值设置到此键上
  • get : 获取指定键对应的值
  • update : 更新指定键对应的值
  • remove : 删除指定键值对
  • increment : 原子方式递增给定键的值,当对应键不存在时视作设置值,对应值不为数字时报错
  • list : 批量获取键值对

接口定义

数据类型

  • JSONValue : 允许存储的值类型
  • ReturnValue : 表示一个键值对的内容,可以是一个对象或者 undefined

查询配置

  • ListPageOptions : 批量获取键值对的配置项
  • QueryList : 键值对查询列表,用于批量获取键值对,通过 {GameDataStorage.list} 方法返回