Unity5.1 新的网络引擎UNET（十五） Networking 引用--上

孙广东  2015.7.21

本节提供了与网络系统一起使用的组件的具体信息。

1、Network Animator

NetworkAnimator 用于跨网络同步动画。

Properties

Property:	Function:
animator	要同步的对象上的Animator 组件。

Details  暂无

2、NetworkBehaviour

NetworkBehaviours 是特别脚本。用于处理对象上的 NetworkIdentity 组件。这些脚本都能够执行 HLAPI 。像Commands、 ClientRPCs、 SyncEvents 和 SyncVars 等功能。

与Unity Network Systemserverauthoritative 权威系统。网络对象的 NetworkIdentities 必须是“spawned”，由server使用 NetworkServer.Spawn()。这会导致他们被分配一个NetworkInstanceId，在连接到server的client上创建。

Properties

Property:		Function:
isLocalPlayer		True if this object is the player object for the local client.
isServer		True if this object is running on the server, and has been spawned.
isClient		True if this object is running on a client.
hasAuthority		True if this object is the authoritative version of the object. So either on the server, or on the client with localPlayerAuthority.
assetId		This is the assetId of the object’s NetworkIdentity.
netId		This is the netId of the object’s NetworkIdentity.
playerControllerId		This is the playerControllerId of the object’s NetworkIdentity.
connectionToServer		NetworkConnection object to use to send to the server.
connectionToClient		NetworkConnection object to use to send to the client.

NetworkBehaviours 具有下面的特点，介绍例如以下。

• Synchronized Variables 同步变量
• Network callbacks 网络回调
• Server and Client functionsserver和client功能
• Sending Commands发送命令
• Client RPC Calls client RPC 调用
• Networked Events 网络事件

Synchronized Variables
同步的变量
NetworkBehaviours 成员变量能够从server同步到client。由于该server是有权威在此系统中。同步是仅在  server到client  的方向。

客户请求做的事情是通过命令Commands处理，不是从client同步的变量。

SyncVar 属性用于 标记 成员变量，如  正在同步。

SyncVars 能够是不论什么 基本类型、 不是类、 列表或其它集合。

public class SpaceShip : NetworkBehaviour
{
    [SyncVar]
    public int health;

    [SyncVar]
    public string playerName;
}

SyncVar 的值在server上更改。它将发送到全部的游戏中准备好的clients 。当 生成对象 时。client上创建他们从server的全部 SyncVars 的最新状态。

Network callbacks
网络回调

有各种 网络事件的 NetworkBehaviour 脚本调用的回调函数。

这些是对基类 虚函数，所以它们能够被重写在使用这种代码:

public class SpaceShip : NetworkBehaviour
{
    public override void OnStartServer()
    {
        // disable client stuff
    }

    public override void OnStartClient()
    {
        // register client events, enable effects
    }
}

当对象在server上被生成或当server启动时 对场景中的对象   调用 OnStartServer 函数。  当对象在client被生成 。或者当client连接到server以进行场景中的物体，将调用 OnStartClient 函数。

这些函数是实用的， 去做那些特定于client或server的事，  比如suppressing effects 抑制效应在server上，或设置client事件。

      请注意，当使用的是local client 本地client，这两个函数将被同一个对象调用。

其它回调包含:
• OnSerialize - called to gather state to send from the server to clients 调用以收集状态将从server发送到client
• OnDeSerialize - called to apply state to objects on clients 调用以将状态应用于client上的对象
• OnNetworkDestroy - called on clients when server told the object to be destroyed 当server告诉要被销毁的对象在client上调用
• OnStartLocalPlayer - called on clients for player objects for the local client (only)
• OnRebuildObservers - called on the server when the set of observers for an object is rebuild
• OnSetLocalVisibility - called on a host when the visibility of an object changes for the local client
• OnCheckObserver - called on the server to check visibility state for a new client

Server and Client functions
server和client功能

NetworkBehaviours 中的成员函数能够用来   自己定义属性  来指定它们 作为 仅server或仅client的功能标记。

比如:

using UnityEngine;
using UnityEngine.Networking;

public class SimpleSpaceShip : NetworkBehaviour
{
    int health;

    [Server]
    public void TakeDamage( int amount)
    {
        // will only work on server
        health -= amount;
    }

    [Client]
    void ShowExplosion()
    {
        // will only run on client
    }

    [ClientCallback]
    void Update()
    {
        // engine invoked callback - will only run on client
    }
}

这些属性  使函数马上返回， 假设他们在client或server未处于活动状态时调用。

他们不会生成编译时错误，但假设调用错误的范围内，他们将发出警告日志消息。ServerCallback 和 ClientCallback 的属性能够用于用户代码不能控制的调用的引擎回调函数。

这些属性不会导致生成的警告。

Sending Commands
发送命令

     命令是为client请求做某事  在server上的方式。

由于 HLAPI 是一个server的权威系统，客户能够仅仅通过命令做事情。

发送该命令的client上的player 对象相应的server上执行命令。这种路由会自己主动发生，client一个不同的player发送命令它是不可能的。

命令必须以  前缀"Cmd" 开头和有  [Command] 自己定义属性，例如以下面:

using UnityEngine;
using UnityEngine.Networking;

public class SpaceShip : NetworkBehaviour
{
    bool alive;
    float thrusting;
    int spin;

    [Command]
    public void CmdThrust(float thrusting, int spin)
    {   
        if (!alive)
        {
            this.thrusting = 0;
            this.spin = 0;
            return;
        }
            
        this.thrusting = thrusting;
        this.spin = spin;
    }

    [ClientCallback]
    void Update()
    {
        int spin = 0;
        if (Input.GetKey(KeyCode.LeftArrow))
        {
            spin += 1;
        }
        if (Input.GetKey(KeyCode.RightArrow))
        {
            spin -= 1;
        }
        // this will be called on the server
        CmdThrust(Input.GetAxis("Vertical"), spin);
    }
}

        命令被调用。通常在client上  。可是，而不是命令函数在client上执行的 ，它将在该server上的clientPlayer对象调用。因此，命令是类型安全，有内置的安全机制和路由到player，以及使用參数有效的序列化机制，使高速调用它们。

Client RPC Calls
client RPC 调用

      client RPC 调用是   一个server对象 让  client对象 做一些事情的方式。

这是和怎样用命令发送消息 方向相反。但概念是同样的。client RPC 调用然而不仅仅调用player对象，他们能够在不论什么 NetworkIdentity 对象上调用。必须曾经缀 "Rpc" 开头，而且必须 [ClientRPC] 的自己定义属性，像下面:

using UnityEngine;
using UnityEngine.Networking;

public class SpaceShipRpc : NetworkBehaviour
{
    [ClientRpc]
    public void RpcDoOnClient(int foo)
    {
        Debug.Log("OnClient " + foo);
    }

    [ServerCallback]
    void Update()
    {
        int value = UnityEngine.Random.Range(0,100);
        if (value < 10)
        {
            // this will be invoked on all clients
            RpcDoOnClient(value);
        }
    }
}

Networked Events
网络的事件

      网络的事件就像   client RPC 调用，但不是仅仅在client对象上调用一个函数，client对象上的事件将被触发。为事件 注冊的其它脚本 然后调用 -  參数在server上，所以这使得网络的client上脚本间交互。

事件必须曾经缀 “Event” 开头而且有 SyncEvent 的自己定义属性。

事件能够用于生成功能强大的网络游戏系统。能够通过其它脚本扩展。此演示样例演示怎样影响脚本在client上的能够响应由server上的战斗脚本生成的事件。

using UnityEngine;
using UnityEngine.Networking;

// Server script
public class MyCombat : NetworkBehaviour
{
    public delegate void TakeDamageDelegate(int side, int damage);
    public delegate void DieDelegate();
    public delegate void RespawnDelegate();
    
    float deathTimer;
    bool alive;
    int health;

    [SyncEvent(channel=1)]
    public event TakeDamageDelegate EventTakeDamage;
    
    [SyncEvent]
    public event DieDelegate EventDie;
    
    [SyncEvent]
    public event RespawnDelegate EventRespawn;

    [Server]
    void TakeDamage(int amount)
    {
        if (!alive)
            return;
            
        if (health > amount) {
            health -= amount;
        }
        else
        {
            health = 0;
            alive = false;
            // send die event to all clients
            EventDie();
            deathTimer = Time.time + 5.0f;
        }
    }

    [ServerCallback]
    void Update()
    {
        if (!alive)
        {
            if (Time.time > deathTimer)
            {
                Respawn();
            }
            return;
        }
    }

    [Server]
    void Respawn()
    {
        alive = true;
        // send respawn event to all clients
        EventRespawn();
    }
}

Hints

• This is a base class that provides Commands and ClientRpc calls.