存储系统

新样板新增了一种新的存储系统，它允许你在不同的塔之间共用存储，常用于设置系统。但是你依然可以使用旧样板的存储方式，使用 setLocalStorage 等函数，这些函数目前还不会被弃用。

GameStorage 类

新的存储系统依赖于 GameStorage，它通过一些简单的 api 来进行存储。在存储之前，我们需要创建一个存储实例：

interface GameStorage {
    new(key: string): GameStorage
}

其中的 key 参数表示的是这个存储的名称，我们建议使用 GameStorage.fromGame 或 GameStorage.fromAuthor 函数生成：

const { GameStorage } = Mota.requireAll('class');

// fromAuthor 函数指明了同一个作者，只要是同一个作者，而且存储名称相同，那么就会在不同塔之间共通
// fromAuthor 第一个参数无用，随便填就行，第二个参数是存储名称
// 作者名称需要在全塔属性中填写
const myStorage1 = new GameStorage(GameStorage.fromAuthor('', 'myStorage'));
// fromGame 函数指明了一个游戏，表明该存储只在当前塔有效，对于其他塔是无效的，参数表示存储名称
// 游戏名称指的是全塔属性中的游戏英文名
const myStorage2 = new GameStorage(GamrStorage.fromGame('myStorage'));

存入与读取

可以使用 setValue 和 getValue 存入和读取一个存储：

function setValue(key: string, value: any): void
function getValue(key: string, defaultValue?: any): any

其中 key 参数表明的是要设置的存储的名称（注意与 GameStorage 的存储名称区分）

myStorage1.setValue('myStore', 1); // 在 myStorage1 这个存储中，将 myStore 存储设置为1
myStorage1.setValue('myStore2', [1, 2, 3]); // 也可以设置为一个数组
const value = myStorage1.getValue('myStore2', []); // 获取存储，第二个参数表示默认值

对于每个存储值，必须是可序列化对象

实际写入与读取

实际上，在执行完 setValue 和 getValue 时，存入的值并不会立刻存入本地存储，它会在内存中暂时存储。你可以调用 write 和 read 来写入本地存储或者从本地存储读取

myStorage1.write(); // 实际写入本地存储
myStorage1.read(); // 从本地存储读取，会完全覆盖之前的信息

当然，大部分情况下你是不需要执行这些的，样板会在一些时刻自动写入所有本地存储，例如当页面被关闭或者失焦时，会立刻写入本地存储，所以一般情况下是不需要你手动写入的。当一个存储实例被创建后，它会立刻从本地存储中读取信息，因此大部分情况你也不需要手动读取本地存储。

遍历存储

可以通过 keys values entries 三个函数遍历这个存储实例的键、值、键和值：

for (const key of myStorage1.keys()) {
    console.log(key); // 输出每一个存储键
}
for (const value of myStorage1.values()) {
    console.log(value); // 输出每一个值
}
for (const [key, value] of myStorage.entries()) {
    console.log(key, value); // 输出每一个键和值
}

与设置系统共用

对于直接注册到 mainSetting 上的设置，会自动写入本地存储。如果由于一些原因，你不想让它写入本地存储，比如通过 flags 存储的设置，或者是全屏这种不能在打开页面时直接呈现的设置，可以通过给 MotaSetting 类上的静态变量 noStorage 数组添加设置名称即可：

const { MotaSetting } = Mota.requireAll('class');

// 这样这两个设置就不会自动写入本地存储了
MotaSetting.noStorage.push('mySetting1', 'mySetting2.mySetting3');

在初始化时，我们可以直接调用存储进行初始化。样板系统设置使用 settingStorage 变量进行存储。

const { settingStorage: storage, mainSetting } = Mota.requireAll('var');

mainSetting.reset({
    'mySetting1': !!storage.getValue('mySetting1', false), // 使用 !! 确保值是布尔值
    'mySetting2': storage.getValue('mySetting2', 100), // 存储名称与设置名称一致
    'mySetting3.mySetting4': storage.getValue('mySetting3.mySetting4') // 级联设置中也是如此
})

4.3 KiB Raw Blame History