mirror of
https://github.com/unanmed/HumanBreak.git
synced 2025-04-30 19:33:24 +08:00
97 lines
4.3 KiB
Markdown
97 lines
4.3 KiB
Markdown
# 存储系统
|
|
|
|
新样板新增了一种新的存储系统，它允许你在不同的塔之间共用存储，常用于设置系统。但是你依然可以使用旧样板的存储方式，使用 `setLocalStorage` 等函数，这些函数目前还不会被弃用。
|
|
|
|
## GameStorage 类
|
|
|
|
新的存储系统依赖于 `GameStorage`，它通过一些简单的 api 来进行存储。在存储之前，我们需要创建一个存储实例：
|
|
|
|
```ts
|
|
interface GameStorage {
|
|
new(key: string): GameStorage
|
|
}
|
|
```
|
|
|
|
其中的 `key` 参数表示的是这个存储的名称，我们建议使用 `GameStorage.fromGame` 或 `GameStorage.fromAuthor` 函数生成：
|
|
|
|
```js
|
|
const { GameStorage } = Mota.requireAll('class');
|
|
|
|
// fromAuthor 函数指明了同一个作者，只要是同一个作者，而且存储名称相同，那么就会在不同塔之间共通
|
|
// fromAuthor 第一个参数无用，随便填就行，第二个参数是存储名称
|
|
// 作者名称需要在全塔属性中填写
|
|
const myStorage1 = new GameStorage(GameStorage.fromAuthor('', 'myStorage'));
|
|
// fromGame 函数指明了一个游戏，表明该存储只在当前塔有效，对于其他塔是无效的，参数表示存储名称
|
|
// 游戏名称指的是全塔属性中的游戏英文名
|
|
const myStorage2 = new GameStorage(GamrStorage.fromGame('myStorage'));
|
|
```
|
|
|
|
## 存入与读取
|
|
|
|
可以使用 `setValue` 和 `getValue` 存入和读取一个存储：
|
|
|
|
```ts
|
|
function setValue(key: string, value: any): void
|
|
function getValue(key: string, defaultValue?: any): any
|
|
```
|
|
|
|
其中 `key` 参数表明的是要设置的存储的名称（注意与 `GameStorage` 的存储名称区分）
|
|
|
|
```js
|
|
myStorage1.setValue('myStore', 1); // 在 myStorage1 这个存储中，将 myStore 存储设置为1
|
|
myStorage1.setValue('myStore2', [1, 2, 3]); // 也可以设置为一个数组
|
|
const value = myStorage1.getValue('myStore2', []); // 获取存储，第二个参数表示默认值
|
|
```
|
|
|
|
对于每个存储值，必须是[可序列化对象](https://developer.mozilla.org/zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm#%E6%94%AF%E6%8C%81%E7%9A%84%E7%B1%BB%E5%9E%8B)
|
|
|
|
## 实际写入与读取
|
|
|
|
实际上，在执行完 `setValue` 和 `getValue` 时，存入的值并不会立刻存入本地存储，它会在内存中暂时存储。你可以调用 `write` 和 `read` 来写入本地存储或者从本地存储读取
|
|
|
|
```js
|
|
myStorage1.write(); // 实际写入本地存储
|
|
myStorage1.read(); // 从本地存储读取，会完全覆盖之前的信息
|
|
```
|
|
|
|
当然，大部分情况下你是不需要执行这些的，样板会在一些时刻自动写入所有本地存储，例如当页面被关闭或者失焦时，会立刻写入本地存储，所以一般情况下是不需要你手动写入的。当一个存储实例被创建后，它会立刻从本地存储中读取信息，因此大部分情况你也不需要手动读取本地存储。
|
|
|
|
## 遍历存储
|
|
|
|
可以通过 `keys` `values` `entries` 三个函数遍历这个存储实例的 键、值、键和值：
|
|
|
|
```js
|
|
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` 数组添加设置名称即可：
|
|
|
|
```js
|
|
const { MotaSetting } = Mota.requireAll('class');
|
|
|
|
// 这样这两个设置就不会自动写入本地存储了
|
|
MotaSetting.noStorage.push('mySetting1', 'mySetting2.mySetting3');
|
|
```
|
|
|
|
在初始化时，我们可以直接调用存储进行初始化。样板系统设置使用 `settingStorage` 变量进行存储。
|
|
|
|
```js
|
|
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') // 级联设置中也是如此
|
|
})
|
|
```
|