远程操作

Important: UNet is a deprecated solution, and a new Multiplayer and Networking Solution (Netcode for GameObjects) is under development. For more information and next steps see the information on the Unity Netcode for GameObjects website.

网络系统具有在网络上执行操作的方法。这些类型的操作有时称为“远程过程调用”。在网络系统中有两种类型的 RPC：命令（从客户端调用并在服务器上运行）和 ClientRpc 调用（在服务器上调用并在客户端上运行）。

下图显示了执行远程操作的方向：

命令

命令从客户端上的玩家对象发送到服务器上的玩家对象。为了安全起见，命令只能从您自己的玩家对象发送，因此您无法控制其他玩家的对象。要将函数转换为命令，请为其添加 [Command] 自定义属性，并添加“Cmd”前缀。现在，在客户端上调用此函数时，将在服务器上运行此函数。所有参数都将通过该命令自动传递到服务器。

Command 函数必须具有前缀“Cmd”。这是读取调用命令的代码时的提示 - 此函数比较特殊，不像普通函数那样在本地调用。

class Player : NetworkBehaviour
{

    public GameObject bulletPrefab;

    [Command]
    void CmdDoFire(float lifeTime)
    {
        GameObject bullet = (GameObject)Instantiate(
            bulletPrefab, 
            transform.position + transform.right,
            Quaternion.identity);
            
        var bullet2D = bullet.GetComponent<Rigidbody2D>();
        bullet2D.velocity = transform.right * bulletSpeed;
        Destroy(bullet, lifeTime);

        NetworkServer.Spawn(bullet);
    }

    void Update()
    {
        if (!isLocalPlayer)
            return;

        if (Input.GetKeyDown(KeyCode.Space))
        {
            CmdDoFire(3.0f);
        }

    }
}

务必注意每帧都从客户端发送命令的情况！这种情况可能会导致大量网络流量。

默认情况下，命令在通道零上发送（此通道默认的可靠通道）。因此，默认情况下，所有命令都能可靠发送到服务器。可使用 [Command] 自定义属性的“Channel”参数对该通道进行自定义。此参数应为整数，表示通道编号。

默认情况下，通道 1 也设置为不可靠的通道，因此要使用该通道，请在 Command 属性中使用值 1 作为参数，如下所示：

    [Command(channel=1)]

从 Unity 版本 5.2 开始，可从具有客户端授权的非玩家对象发送命令。这些对象必须是使用 NetworkServer.SpawnWithClientAuthority 生成的对象，或者使用 NetworkIdentity.AssignClientAuthority 设置了授权。从这些对象发送的命令在服务器的对象实例上运行，而不是在客户端的关联玩家对象上运行。

ClientRpc 调用

ClientRpc 调用从服务器上的对象发送到客户端上的对象。可从任何具有已生成的 NetworkIdentity 的服务器对象发送这些调用。由于服务器具有授权，因此能够发送这些调用的服务器对象不会存在安全问题。要将函数转换为 ClientRpc 调用，请为其添加 [ClientRpc] 自定义属性，并添加“Rpc”前缀。现在，在服务器上调用此函数时，将在客户端上运行此函数。所有参数都将通过该 ClientRpc 调用自动传递到客户端。

ClientRpc 函数必须具有前缀“Rpc”。这是读取调用方法的代码时的提示 - 此函数比较特殊，不像普通函数那样在本地调用。

class Player : NetworkBehaviour
{

    [SyncVar]
    int health;

    [ClientRpc]
    void RpcDamage(int amount)
    {
        Debug.Log("Took damage:" + amount);
    }

    public void TakeDamage(int amount)
    {
        if (!isServer)
            return;

        health -= amount;
        RpcDamage(amount);
    }
}

当游戏作为具有 LocalClient 的主机运行时，将在 LocalClient 上调用 ClientRpc 调用，即使与服务器处于同一进程中也会执行此操作。因此，对于 ClientRpc 调用，LocalClient 和 RemoteClient 的行为是相同的。

远程操作的参数

传递给命令和 ClientRpc 调用的参数经过序列化并通过网络发送。参数可以是：

• 基本类型（byte、int、float、string、UInt64 等等）
• 基本类型的数组
• 包含允许类型的结构
• Unity 内置数学类型（Vector3、Quaternion 等等）
• NetworkIdentity
• NetworkInstanceId
• NetworkHash128
• 附加了 NetworkIdentity 组件的游戏对象

远程操作的参数不能是游戏对象的子组件，例如脚本实例或变换。这些参数不能是无法通过网络进行序列化的其他类型。