[单脚本][MyClearDB] 一个开箱即用的数据管理、存档方法

叽里咕噜小胡桃 · 发表于 2023-2-16 15:03:41

还在看着数据管理的代码发愁嘛？

还在因玩家存档丢失而掉头发嘛？

还在忍受asyncSetPlayerData奇怪的限制吗？

试试MyClearDB吧！

一个脚本，快捷设置、拿取所有string\number\boolean，甚至是map\class！

MyClearDB.ts (12.13 KB, 下载次数: 109)

2023-4-12 21:40 上传

点击文件名下载附件
2023.4.12更新添加获取playerid方法
1. 脚本下载后解压，导入到工程内容/脚本里，并拖入场景中

2. 方法讲解
注意：以下方法的playerid?是可选参数，如果你存的数是系统量(即与具体的玩家无关)，如对局状态，则不用填，反之需带上具体玩家的playerid
************************************
由于PlayerID在线上时没法做到和玩家一一对应等一系列毛病，所以在传入playerid之前，建议用这种方式获取

// 智能获取playerid方法，由于pie环境特殊，用这个方法可以无脑获取最正确唯一的playerid

MyClearDB.instance.getPlayerID(player)

************************************

2.1 设置一个值，需要存档asyncSetValue(key, val, playerid?)仅服务端

存入一个值，这个val可以是任意类型、结构，脚本内自带字符串化JSON.stringify()，仅服务端可用
这个操作会往远端数据服务器存档，以便下次登陆时获取
同时往DS服务器数据缓存里存一份，后续获取时，DS服务器数据缓存有就优先获取缓存的
后续set时，先比对DS服务器数据缓存里的数据，如有差异再进入存档序列
带上playerid表示这个是和具体玩家有关的玩家属性，不带则意为和玩家无太大关系

2.2 设置一个值，不用存档asyncSetTempValue(key, val, playerid?)仅服务端

存入一个值，这个val可以是任意类型、结构，脚本内自带字符串化JSON.stringify()，仅服务端可用
这个操作不会往远端数据服务器存档，所有数据都在DS服务器数据缓存里维护，存取
建议玩家进入时可以进行一定的初始化
后续set时，先比对DS服务器数据缓存里的数据，如有差异再进入存档序列
带上playerid表示这个是和具体玩家有关的玩家属性，不带则意为和玩家无太大关系

2.3 获取一个值，不论是否存档asyncGetValue(key, playerid?)双端可用

获取一个值，通过key和可能的playerid，返回一串string，你可以通过JSON.parse(返回值) as 你先前设置好的结构，来进行转义，双端可用
这个操作会优先尝试从DS服务器数据缓存里取数，如果没有则会向远端服务器取数，取回的数存一份DS服务器数据缓存，不论是否temp，所以用前请自行甄别
带上playerid表示这个是和具体玩家有关的玩家属性，不带则意为和玩家无太大关系

3. 使用方法
在需要进行数据链接的脚本顶端导入

import MyClearDB from "./MyClearDB";

具体案例：
玩家进游戏的时候会存一个键 = "Name"，值 = characterName，playerid = 玩家id，到服务器"Custom_Player_19863_Name"，
玩家离开游戏的时候获取Name，并log出来
这是存和取都是在S端的

import MyClearDB from "./MyClearDB"

@Core.Class

export default class NewScript extends Core.Script {

    /** 当脚本被实例后，会在第一帧更新前调用此函数 */

    protected onStart(): void {

        if (SystemUtil.isServer()) {

            Events.addPlayerJoinedListener((player: Gameplay.Player) => {

                setTimeout(() => {

                    console.log("after 1s");

                    MyClearDB.asyncSetValue("Name",player.character.characterName, MyClearDB.instance.getPlayerID(player));

                }, 1000);

            })



            Events.addPlayerLeftListener(async (player: Gameplay.Player) => {

                let data = await MyClearDB.asyncGetValue("Name",  MyClearDB.instance.getPlayerID(player));

                console.log(JSON.parse(data) + " left the game");

            })

        }

    }

}

依然是我们熟悉的UIDefault.ts，把这些粘贴进去
当玩家按下跳跃，从服务端获取Name，并log出来

import MyClearDB from "./MyClearDB";

@UI.UICallOnly('')



export default class UIDefault extends UI.UIBehavior {

    Character: Gameplay.Character;



    /** 仅在游戏时间对非模板实例调用一次 */

    protected onStart() { 

        //设置能否每帧触发onUpdate

        this.canUpdate = false;

        //找到对应的跳跃按钮

        const JumpBtn = this.uiWidgetBase.findChildByPath('MWCanvas/MWButton_Jump') as UI.StaleButton

        //点击跳跃按钮,异步获取人物后执行跳跃

        JumpBtn.onPressed.add(async ()=>{

            let name = await MyClearDB.asyncGetValue("Name", Gameplay.getCurrentPlayer().getPlayerID());

            console.log("Name: " + name);

            

            if (this.Character) {

                this.Character.jump();

            } else {

                Gameplay.asyncGetCurrentPlayer().then((player) => {

                    this.Character = player.character;

                    //角色执行跳跃功能

                    this.Character.jump();

                });

            }

        })  

    }