Version: 2019.1
网络授权
高级状态同步

状态同步

注意:已弃用 UNet,未来会将其从 Unity 中删除。一个新系统正在开发中。如需了解更多信息和后续步骤,请参阅此博客文章以及常见问题解答 (FAQ)

状态同步是指对值(例如联网游戏对象上的脚本包含的整数、浮点数、字符串和布尔值)进行同步。

状态同步的方向是从服务器到远程客户端。本地客户端没有序列化的数据。本地客户端与服务器共享场景,因此不需要此数据。但是,在本地客户端上会调用 SyncVar 挂钩。

数据不会以相反方向(远程客户端到服务器)同步。若要进行此方向的同步,需要使用命令

SyncVar

SyncVar 是从 NetworkBehaviour 继承的脚本变量,这些变量从服务器同步到客户端。生成游戏对象时,或者新玩家加入正在进行的游戏时,会向其发送其可见的联网对象上所有 SyncVar 的最新状态。使用 [SyncVar] 自定义属性可指定脚本中要同步的变量,如下所示:

class Player : NetworkBehaviour {

[SyncVar]
int health;

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

    health -= amount;
}

}

在调用 OnStartClient() 之前,SyncVar 的状态将应用于客户端上的游戏对象,因此 OnStartClient() 内的对象状态始终是最新的。

SyncVar 可以是基本类型,例如整数、字符串和浮点数。它们也可以是 Unity 类型,例如 Vector3 和用户定义的结构,但 SyncVar 结构的更新将作为整体更新进行发送,而不是在结构中的字段发生更改的情况下发送增量更改。一个 NetworkBehaviour 脚本最多可包含 32 个 SyncVar,包括 SyncList(请参阅下一部分)。

当 SyncVar 的值更改时,服务器会自动发送 SyncVar 更新,因此您无需跟踪它们何时更改或自己发送有关更改的信息。

SyncList

SyncVar 包含值,而 SyncList 包含值列表。SyncList 内容与 SyncVar 状态一起包含在初始状态更新中。由于 SyncList 是一个同步其自身内容的类,因此 SyncList 不需要 SyncVar 属性。以下类型的 SyncList 可用于基本类型:

  • SyncListString

  • SyncListFloat

  • SyncListInt

  • SyncListUInt

  • SyncListBool

此外还有 SyncListStruct 可用于同步您自己的结构类型的列表。使用 SyncListStruct 时,选择使用的结构类型可以包含基本类型、数组和常见 Unity 类型的成员。这些结构不能包含复杂类或通用容器,并且只序列化其中的公共变量。

SyncList 有一个名为“回调”(Callback) 的 SyncListChanged 委托,可在列表内容发生变化时通知客户端。应使用所发生的操作类型以及该操作的目标项的索引来调用此委托。


public class MyScript : NetworkBehaviour
{
    public struct Buf
    {
        public int id;
        public string name;
        public float timer;
    };
            
    public class TestBufs : SyncListStruct<Buf> {}
    TestBufs m_bufs = new TestBufs();
    
    void BufChanged(Operation op, int itemIndex)
    {
        Debug.Log("buf changed:" + op);
    }
    
    void Start()
    {
        m_bufs.Callback = BufChanged;
    }
}
网络授权
高级状态同步