【废弃】“模块管理”与“数据中心”

喵喵哭唧唧 · 发表于 2023-3-2 17:14:38

本帖最后由哭唧唧的细狗于 2023-11-1 16:31 编辑

编辑器版本022

我时间很紧，给你60秒说清楚它有啥效果！

卑职这就去办：

开始没存档时，头顶名字是一个随机名字

当有存档后，再次进入游戏，头顶名字为上次保存的游戏名字

简单来说：
1.第一次进入游戏如果没有保存角色名字，我们就使用默认的随机名字

2.这时我设置了一个叫"testxxxx"的名字给角色，并在服务器存储了名字（视频里可以看到在本地DBCache\Test文件夹下有了名为“Test_1”的文件），一定时间后（每隔10秒存一次）瞧一瞧，当时生成的名字已经写入了文件里

3.确认数据被保存后，我们重新进入游戏，刚才保存的名字正确的设置到了玩家头顶~

ModuleDataCenter.rar (73.6 KB, 下载次数: 125)

2023-3-2 17:12 上传

点击文件名下载附件

牛啊，我马上写八个类似功能糊你脸上~

大佬你别急

我们现在就来说一说【模块管理】与【数据中心】帮我们做了些啥，减少了些什么负担

不使用模块管理，处理客户端与服务器的逻辑，我们需要这样

@Core.Class

export default class NewScript extends Core.Script {



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

    protected onStart(): void {

        //客户端部分

       if(Util.SystemUtil.isClient()){

            //注册服务器事件监听

            Events.addServerListener("serverEvent", this.ClientTest.bind(this))

            //发送消息

            Events.dispatchToServer("clientEvent")

       }

       //服务端部分

       if(Util.SystemUtil.isServer()){

            //注册客户端事件监听

            Events.addClientListener("clientEvent", this.ServerTest.bind(this))

            //发送消息

            Events.dispatchToClient(player, "serverEvent")

       }

    }



    ClientTest(){

        console.log("客户端被调用")

    }



    ServerTest(){

        console.log("服务端被调用")

    }

}

想必上边的用法大家都有所了解了，客户端与服务器需要相互注册监听一堆的消息事件

服务器上获取数据需要这样

// 没错，以前我们要先获得player

DataStorage.asyncGetPlayerData(player).then(value=>{

    console.log("读取数据成功 "， value

})

1.而模块管理只需要像下边这样（最小示例）

客户端和服务器的代码天然分开，并且客户端直接调用服务器的方法，注册监听？那是啥玩意儿？

export class ModulePlayerC extends ModuleC<ModulePlayerS, PlayerData>{

    character: Gameplay.Character



    /**增加名字数据 */

    public async setName(name: string): Promise<void> {

        await this.server.net_setName(name);

        console.error("client ------------>修改名字数据成功");

    }

}



export class ModulePlayerS extends ModuleS<ModulePlayerC, PlayerData>{

    /**修改玩家名字数据 */

    net_setName(name: string): void {

        this.currentData.setName(name);//服务端直接操作数据模块

    }

}

好哥哥，你就说是不是很优雅，这不得把优雅打在回复里

2.数据处理只需这样

export class PlayerData extends Subdata {

    // 玩家的名字

    @Decorator.saveProperty

    private name: string = ""



    getName(): string {

        return this.name

    }



    setName(name: string) {

        this.name = name

        this.save(true)//保存数据 保存数据时会自动同步到客户端

    }

}

saveProperty装饰器的作用：
1.标记了数据将被持久化存储
2.标记了数据能够被同步给客户端（当服务器存储时参数为true则会自动同步eg. this.save(true)）

好了好了！上边还是那么大一堆，限你三句话给我说清楚使用的好处！

收到~：

1.客户端与服务器都拥有了统一的生命周期管理，玩家进入游戏的事件我们也无需再专门去注册处理玩家进入，并且保证玩家完全进入等等的一系列逻辑都已经处理完毕

2.客户端请求服务器做事情只需要简单的this.server.net_xxx就能处理了，无需互相注册各种事件；

服务器在net_xxx相关方法下能直接通过this.currentData.xxx直接获取对应玩家数据，很方便
非net_xxx的方法，我们可以通过this.getPlayerData(player).xxx去处理

服务器上的数据还可以选择是否自动同步客户端

3.各个模块的逻辑与数据相互独立，调理清晰

好了，这里我需要详细介绍一下，有兴趣的朋友可以接着往下看

我们简单定义一个玩家信息的数据中心，它继承自Subdata，之后我们要使用这些数据时，就可以通过this.data.getName()去访问了

export class PlayerData extends Subdata {

    // 玩家的名字

    @Decorator.saveProperty

    private name: string = ""



    getName(): string {

        return this.name

    }



    setName(name: string) {

        this.name = name

        this.save(true)//保存数据 保存数据时会自动同步到客户端

    }

}

瞧一瞧服务器的代码，我们继承自ModuleS，并需要在泛型尖括号里：

第一个参数填入对应的客户端类名（这里即是ModulePlayerC，我们会在下边一点讲到）

第二个参数填入我们设定的数据类名（这里即是上边的PlayerData），它被约束为Subdata

export class ModulePlayerS extends ModuleS<ModulePlayerC, PlayerData>{

    protected onStart(): void {



    }



    net_getName() {

        // 在服务端模块中调用this.currentData 获取到的是该服务端玩家对应的数据模块 这里获取的是PlayerData</span>

        // 需要注意this.currentData 或者 this.currentPlayer等只能在服务端的rpc方法(net_开头的方法)里使用，方法执行完以后会被清除</span>

        // 不要在其他地方用，不要异步使用，避免在清楚后使用导致的错误</span>

        return this.currentData.getName()

    }



    /**修改玩家名字数据 */

    net_setName(name: string): void {

        this.currentData.setName(name);//服务端直接操作数据模块

    }



    protected onUpdate(dt: number): void {



    }

}

客户端代码，与服务器类似的继承规则

export class ModulePlayerC extends ModuleC<ModulePlayerS, PlayerData>{

    character: Gameplay.Character



    protected onStart(): void {

        

    }



    /**进入场景回调 是指玩家彻底进入到游戏时的客户端回调 一般需要做保证玩家已进入成功的操作可在这个函数里写 */

    protected onEnterScene(sceneType: number): void {

        //在客户端模块中调用this.data 获取到的是该客户端玩家对应的数据模块 这里获取的是PlayerData

        this.data.onDataChange.add(this.onPlayerDataChange, this);//监听玩家数据变化

        this.onKeyTest();//按键测试



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

           this.character = p.character



           let name = this.data.getName()

           if(name && name != ""){

                this.character.characterName = name

           }

        })

    }



    /**按键测试 */

    protected onKeyTest(): void {

        InputUtil.onKeyDown(Keys.F, () => {

            // 按F后随机为角色头顶换一个新名字

            this.setName("test" + Math.random());

        })

    }



    protected onUpdate(dt: number): void {



    }



    /**角色数据发生变化回调 */

    public onPlayerDataChange(): void {

        //在这里可以做角色数据变化后的处理

        console.error("client ------------>角色数据发生变化");

        this.character.characterName = this.data.getName()

    }



    public async getName(): Promise<string> {

        let dataName = await this.server.net_getName()

        return dataName

    }



    /**增加名字数据 */

    public async setName(name: string): Promise<void> {

        await this.server.net_setName(name);

        console.error("client ------------>修改名字数据成功");

    }

}

生命周期里还有些什么重要细节么？

onStart，onPlayerJoined，onPlayerEnterGame它们的区别是啥？

慧眼如炬！

onStart是我们模块启动时调用，这里可以用来初始化一些参数或逻辑

onPlayerJoined是玩家刚连进服务器，而数据和前后端通信都还没有就绪（模块和数据准备好了，RPC发不出去）

onPlayerEnterGame是什么都准备好了，可以开干！

模块和数据的对应关系是怎么样的呢？

ModuleC和Subdata会在每个用户客户端有一份

ModuleS会在服务器有一份

下线玩家的数据会在持久化那里保存，登录的玩家会有一份Subdata在服务器上随时调用

嘿，多个模块之间协作咋搞丫？
方法1：getModule，调用其它模块的方法

// getModule来获取相关的模块，并调用对应模块的方法来达成既定的目的

ModuleManager.getInstance().getModule(ModuleBagS).net_addBagData(key, count)

方法2：getData，操作其它模块的数据

// 客户端调用，跨模块操作其他模块的数据

DataCenterC.getInstance().getData(BagData).addBagData(key, count)



// 服务器调用，跨模块操作其他模块的数据

DataCenterS.getInstance().getData(player, BagData).addBagData(key, count)

如果看了这篇还是有些许疑惑，没有捋清楚模块之间的关系，不要怕，请看这里

【模块管理和数据中心】——为什么需要模块管理？① - 资源/心得分享创作者论坛 (ark.online)

叽里咕噜小胡桃 · 发表于 2023-3-2 17:16:23

牛的牛的 666哇

星光 · 发表于 2023-3-2 18:31:47

我觉得有必要把模块的存在方式介绍一下。
到底ModuleS和ModuleC是什么样的对应关系。
例：现有一个背包模块。
是每个玩家都有<ModuleS,ModuleC,Subdata>三个模块，他们一一对应，即 (玩家数) * 3 * (模块数) 个脚本。
如果是一一对应，注册时不需求Player作参数，我可以理解为默认所有玩家都创建。但是在ModuleManager里的getModule方法也不需要Player做参数我就不理解了。

还是其他的对应关系。