da08f15ac2
Clarified the principle of separating ServerSystem and ClientSystem for better compatibility in multiplayer environments. Updated example code to highlight incorrect client-side imports.
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
---
|
||
front: https://nie.res.netease.com/r/pic/20220408/fd58eff7-ab4c-4f98-94b5-87912c6e8e4d.png
|
||
hard: 入门
|
||
time: 15分钟
|
||
selection: true
|
||
---
|
||
|
||
# 多人联机适配规范
|
||
|
||
## 前言
|
||
|
||
最近，在山头测试中，我们发现很多开发者的模组明明在单人游戏运行是非常正常的，但在山头、多人联机环境下就会出现功能无效或者异常的情况
|
||
|
||
只要遵循 ServerSystem 与 ClientSystem 严格分离 的原则，大部分兼容性问题都能自然消失。
|
||
|
||
## 开发范例
|
||
|
||
> 下方代码为错误示范。仅供参考和通俗化解释，并不能实际运行！
|
||
|
||
**modClient.py**
|
||
```python
|
||
import mod.client.extraClientApi as clientApi
|
||
|
||
class ModClient(clientApi.GetClientSystemCls()):
|
||
|
||
def Register(self):
|
||
|
||
self.NotifyToServer("test", {})
|
||
print("register successfully")
|
||
# TODO
|
||
|
||
def NoClientApiRegister(self):
|
||
print("register successfully")
|
||
# TODO
|
||
```
|
||
**modServer.py**
|
||
```python
|
||
import mod.client.extraClientApi as serverApi
|
||
from xxx.xxx.xxx import ModClient #错误引用客户端侧
|
||
|
||
class ModServer(serverApi.GetServerSystemCls()):
|
||
|
||
def ServerRegister(self):
|
||
ModClient.NoClientApiRegister() #在多人游戏出现功能无效或者异常
|
||
print("register successfully")
|
||
# TODO
|
||
```
|
||
可以看到 上面的 `modClient.py` 引入了 `clientApi`
|
||
而 ModServer 这边希望能够调用到 `ModClient` 类里的 `NoClientApiRegister` 方法
|
||
虽然这个方法仅仅只是简单的 print，并不涉及 `clientApi` 里的任何方法
|
||
但由于 `ModClient` import了 `clientApi`，此时 `ModServer` 在初始化的时候就会报错，类里的方法都不会被正常执行
|
||
|
||
由上述例子可以得出
|
||
在开发模组时，应该避免在 ServerSystem 下的子类引用客户端的接口和方法
|
||
如果无法满足要求，可以前往**开发者平台-反馈与建议** 或者 **[Github接口建议](https://github.com/MCNeteaseDevs/SDK-Campaign/issues) 提出接口建议
|
||
|
||
当你遵循上述开发原则，即客户端和服务端分离，您开发的模组基本天然兼容多人联机和我的山头的环境
|
||
|
||
|