feat:上传mcguide-开发指南部份

mcguide/20-玩法开发/14-预设玩法编程/11-深入理解预设/3-生命周期.md

@@ -0,0 +1,99 @@
+# 预设生命周期
+
+前面我们已经学习了如何使用预设的常加载与预加载等属性，但我们还不知道预设是怎么加载卸载的。
+
+这一小节我们将介绍预设和零件的生命周期，我们应该如何管理MOD里的各种预设和零件，这有助于指导我们进行后续的零件开发。
+
+
+
+## **服务端**与客户端实例
+
+在前面学习MOD开发过程中，我们已经了解到服务端和客户端属于两个不同的容器，同样预设和零件的实例也分为服务端实例与客户端实例。
+
+我们希望零件是一个轻量级的功能单位，如果每个零件都需要像system那样分别编写客户端系统类和服务端系统类，那样会显得非常臃肿。
+
+因此我们支持在一个零件类里编写双端代码，当使用零件提供的双端API时，它会自动根据当前是客户端还是服务端返回相应的内容，如GetLevelId()。
+
+如果需要import SDK中的服务端/客户端部分，需要将import代码放到函数内部，且函数命名需要带有Server/Client以进行区分。
+
+下面以玩家基础属性零件为例：
+
+```python
+def InitClient(self):
+    logger.info("%s InitClient %s %s", self.classType, self.GetParent().GetPlayerId(), self.showName)
+    import mod.client.extraClientApi as api
+    nameComp = self.CreateComponent(str(self.GetParent().GetPlayerId()), 'Minecraft', 'name')
+    nameComp.SetShowName(self.showName)
+
+    if self.GetParent().GetPlayerId() == api.GetLocalPlayerId():
+        gameComp = self.CreateComponent(api.GetLevelId(), 'Minecraft', 'game')
+        gameComp.SetNameDeeptest(not self.nameDeeptest)
+        self.NotifyToServer("OnLoadSuccess", {'id': self.GetParent().GetPlayerId()})
+```
+
+```python
+def InitServer(self):
+    logger.info("%s InitServer %s", self.classType, self.GetParent().GetPlayerId())
+    self.ListenSelfEvent('OnLoadSuccess', self, self.OnLoadSuccess)
+```
+
+```python
+def OnLoadSuccess(self, data):
+    logger.info("%s OnLoadSuccess %s", self.classType, self.GetParent().GetPlayerId())
+    import mod.server.extraServerApi as api
+    pComp = self.CreateComponent(data['id'], "Minecraft", "player")
+    pComp.SetPlayerRespawnPos(tuple(self.spawnPos))
+    ...
+```
+
+- 零件的客户端部分负责在初始化时，将父预设（即玩家）的ID通知服务端
+- 零件的服务端部分在初始化时，监听客户端事件，接收到登录玩家的ID时，设置该玩家的相关属性
+
+关于零件的开发规范，详情可以查阅[零件开发规范](../12-深入理解零件/6-零件开发规范.md)。
+
+关于双端实例的通讯与网络同步，我们提供了一些内置API，比如上面这个零件使用到的**NotifyToServer**与**ListenSelfEvent**，详情可以查阅[通讯与网络同步](../12-深入理解零件/3-通讯与网络同步.md)。
+
+
+
+## 生命周期
+
+预设系统的完整生命周期如下：
+
+![image-20210712200101137](./images/image-20210712200101137.png)
+
+- 总是先加载服务端实例，再加载客户端实例
+- 服务端预设实例的坐标变换变更，添加删除素材、零件或子预设，卸载或销毁，都会广播通知所有客户端预设实例进行数据同步，而客户端的任何变更，都不会主动向服务器同步，需要显示调用请求服务端的相关API
+- 零件的InitServer/InitClient在预设初始化时调用一次
+- 零件的TickServer/TickClient在预设加载后每个逻辑帧调用一次
+- 零件的UnloadServer/UnloadClient在预设卸载时调用一次
+- 零件的DestroyServer/DestroyClient在预设销毁时调用一次
+
+### 加载依赖
+
+预设加载的前置条件是它的所有变换对象（TransformObject）依赖的区块全部加载完毕。
+
+**特别注意**：
+
+- 不建议构建需要依赖大量区块的大型预设，预设并不是适用来保存地形，城堡类的大型素材
+- 不建议设置预设的多个子节点到相距很远的位置，这也会导致预设依赖它们中间跨越的所有区块
+
+实体预设在加载时，会与对应的实体进行绑定，因此它除了依赖区块加载，还依赖于实体的加载。
+
+同理，玩家预设的加载依赖对应的玩家登陆。
+
+客户端预设的加载还依赖于对应的服务端预设加载。
+
+### 加载过程
+
+预设加载过程分为四步：
+
+- 根据预设文件ID获取预设文件，解析预设层次结构本体
+- 递归分析预设所依赖的素材，零件，子预设，实例化展开所有游戏对象，并构建游戏对象的父子关系
+- 应用预设/零件存档里的实例修改部分
+- 应用预设/零件层次结构的坐标变换
+
+### 卸载与销毁
+
+- 当预设的加载依赖不满足，且预设不具有常加载属性时，预设将被卸载。
+
+- 在零件内主动对父预设进行销毁，不会立刻停止零件代码，父预设会继续完成当前帧所有子节点的逻辑，在当前帧的末尾完成销毁