Mirror 常用组件

Mirror 是 Unity 的一个高性能、轻量级的网络库，它能够帮助开发者快速搭建网络游戏和应用程序。Mirror 提供了多个网络组件，以下是其中五个常用组件的详细介绍。

NetworkManager

介绍

NetworkManager 组件负责管理网络连接，它可以启动服务器和客户端，并处理网络连接、断开、重连等操作。同时，NetworkManager 还提供了一些事件回调函数，例如 OnServerConnect、OnClientDisconnect 等，可以方便地处理网络事件。

方法

StartServer()：启动服务器。
StartClient()：启动客户端。
StopServer()：停止服务器。
StopClient()：停止客户端。

举例子

以下是几个常见的代码例子，演示了如何使用 NetworkManager 组件：

例子 1：启动服务器和客户端

using UnityEngine;
using Mirror;public class MyNetworkManager : NetworkManager
{public void StartServer(){base.StartServer();}public void StartClient(){base.StartClient();}public void StopServer(){base.StopServer();}public void StopClient(){base.StopClient();}
}

在这个例子中，我们创建了一个名为 MyNetworkManager 的类，并继承了 NetworkManager 组件。我们通过调用基类的 StartServer 和 StartClient 函数来启动服务器和客户端，通过调用基类的 StopServer 和 StopClient 函数来停止服务器和客户端。

NetworkIdentity

介绍

NetworkIdentity 组件用于标识网络游戏对象，它可以在网络中同步游戏对象的状态和属性。当一个游戏对象被标识为 NetworkIdentity 时，它会自动在服务器和客户端之间同步其位置、旋转、缩放、变量等属性。

方法

AssignClientAuthority(NetworkConnection conn)：将网络对象的所有权分配给指定的客户端连接。
RemoveClientAuthority(NetworkConnection conn)：从指定的客户端连接中移除网络对象的所有权。

举例子

以下是一个常见的例子，演示了如何使用 NetworkIdentity 组件：

例子：标识网络对象

using UnityEngine;
using Mirror;public class MyNetworkObject : NetworkBehaviour
{// 在网络中同步的变量[SyncVar]public int score;void Start(){// 检查是否是本地客户端if (isLocalPlayer){// 分配客户端所有权CmdAssignClientAuthority();}}[Command]void CmdAssignClientAuthority(){// 将网络对象的所有权分配给本地客户端if (connectionToClient != null){AssignClientAuthority(connectionToClient);}}
}

在这个例子中，我们创建了一个名为 MyNetworkObject 的类，并继承了 NetworkBehaviour 组件。我们使用 [SyncVar] 属性将 score 变量在网络中同步，并在 Start 函数中检查是否是本地客户端。如果是本地客户端，我们使用 CmdAssignClientAuthority 函数将网络对象的所有权分配给客户端。

NetworkBehaviour

介绍

NetworkBehaviour 组件用于处理网络消息，它可以在服务器和客户端之间同步游戏对象的状态和属性。当一个游戏对象被标识为 NetworkIdentity 时，它会自动在服务器和客户端之间同步其位置、旋转、缩放、变量等属性。

方法

Send<T>(T message, int channelId = Channels.DefaultReliable)：向服务器或客户端发送网络消息。
[Command]：用于标记一个客户端调用的远程过程调用（RPC）函数。
[ClientRpc]：用于标记一个服务器调用的远程过程调用（RPC）函数。

举例子

以下是一个常见的例子，演示了如何使用 NetworkBehaviour 组件：

例子：同步游戏对象的位置和旋转

using UnityEngine;
using Mirror;public class MyNetworkObject : NetworkBehaviour
{// 在网络中同步的变量[SyncVar]public Vector3 position;[SyncVar]public Quaternion rotation;void Update(){if (isLocalPlayer){// 更新本地游戏对象的位置和旋转position = transform.position;rotation = transform.rotation;}else{// 同步远程游戏对象的位置和旋转transform.position = position;transform.rotation = rotation;}}
}

在这个例子中，我们创建了一个名为 MyNetworkObject 的类，并继承了 NetworkBehaviour 组件。我们使用 [SyncVar] 属性将 position 和 rotation 变量在网络中同步，并在 Update 函数中更新本地游戏对象的位置和旋转，以及同步远程游戏对象的位置和旋转。

NetworkTransform

介绍

NetworkTransform 组件用于同步游戏对象的位置、旋转和缩放等属性，它可以在服务器和客户端之间同步游戏对象的状态。当一个游戏对象被标识为 NetworkIdentity，并添加了 NetworkTransform 组件时，它会自动在服务器和客户端之间同步其位置、旋转、缩放等属性。

方法

SetDirtyBit(int dirtyBit)：将指定的 dirty bit 设置为脏标志，以便在网络中同步。

举例子

以下是一个常见的例子，演示了如何使用 NetworkTransform 组件：

例子：同步游戏对象的位置和旋转

using UnityEngine;
using Mirror;public class MyNetworkObject : NetworkBehaviour
{// 在网络中同步的变量[SyncVar]public Vector3 position;[SyncVar]public Quaternion rotation;// 添加 NetworkTransform 组件[SerializeField]NetworkTransform networkTransform;void Update(){if (isLocalPlayer){// 更新本地游戏对象的位置和旋转position = transform.position;rotation = transform.rotation;// 设置 NetworkTransform 组件的脏标志networkTransform.SetDirtyBit(1 << 0);}}
}

在这个例子中，我们创建了一个名为 MyNetworkObject 的类，并继承了 NetworkBehaviour 组件。我们使用 [SyncVar] 属性将 position 和 rotation 变量在网络中同步，并添加了 NetworkTransform 组件来同步游戏对象的位置、旋转和缩放等属性。在 Update 函数中，我们更新本地游戏对象的位置和旋转，并使用 SetDirtyBit 函数将 NetworkTransform 组件的脏标志设置为 1。