Mirror网络库插件使用4

Synchronization

一个NetworkBehaviour脚本，最多存在64个同步变量，

SyncVar，SyncVar Hooks，SyncList，SyncDictionary,SyncHashSet,SyncSortedSet的数量数量之和不能超过64个。

示例，如果存在61个SyncList变量,SyncVar的数量最多有3个。

SyncVar

同步方向：服务器到客户端

同步时机：数据改变时；生成游戏对象时，新用户加入时；

使用要求：继承NetworkBehaviour的脚本中可以使用该特性，最多可以使用64个。

SyncVar Hooks

在SyncVar的基础上添加了回调函数。

hook指定的是字符串，建议使用nameof包裹方法名，后续方便查找。

csharp 复制代码

   [SyncVar(hook = nameof(OnColorChanged))]
   Color playerColor = Color.black;
   void OnColorChanged(Color oldColor, Color newColor){}

hook是按照Syncvar变量在文件中定义的顺序调用的。

csharp 复制代码

public class MyBehaviour : NetworkBehaviour 
{
    [SyncVar] 
    int X;
    [SyncVar(hook = nameof(Hook1))] 
    int Y;
    [SyncVar(hook = nameof(Hook2))]
    int Z;
}

调用顺序为设置x数值；设置y数值，调用Hook1方法；设置z数值；调用Hook2方法。

SyncList

类似C#的List，用于将内容从服务器同步到客户端。
要求：必须声明为readonly,并在定义时实例化。

服务器上可以使用SyncList进行增删改查。

客户端上监听变化：

OnStartClient中注册监听，OnStopClient中取消监听。

监听方法有OnAdd,OnInsert,OnRemove,OnSet,OnClear。

OnChange会在上述操作之后调用，建议不使用OnChange。
注意：

列表的引用不能修改，可以调用Add,Remove改变列表内容。
由于 SyncList 的初始数据同步发生在 OnStartClient 之前，而事件是在同步之后才订阅的，所以已有的元素不会自动触发回调。
列表元素如果是引用类型，修改元素内容不会触发回调，将修改后的对象重新赋值会触发OnSet。

csharp 复制代码

Item temp = inventory[0];
temp.amount = 5;
inventory[0] = temp;

SyncDictionary

类似C#的Dictionary，用于将内容从服务器同步到客户端。
要求：必须声明为readonly,并在定义时实例化。

服务器上进行增删改查；客户端上监听变化。

OnStartClient注册监听，OnStopClient中取消监听。

监听方法有：OnAdd,OnSet,OnRemove,OnClear。

OnChange会在上述操作之后调用，建议不使用OnChange。
注意:

字典的引用不能修改，可以使用字典添加和移除元素；
由于字典的初始数据同步发生在 OnStartClient 之前，而事件是在同步之后才订阅的，所以已有的元素不会自动触发回调。
直接修改已存在值对象的内部字段不会被视为字典的变化。必须将修改后的对象重新赋值给同一个键。

csharp 复制代码

EquipmentItem item = equipment["head"];
item.durability -= 10;
equipment["head"] = item;

SyncHashSet

类似C#的hashset，用于将内容从服务器同步到客户端。
要求：必须声明为readonly,并在定义时实例化。

服务器上进行增删改查；客户端上监听变化。

OnStartClient注册监听，OnStopClient中取消监听。

监听方法有：OnAdd,OnRemove,OnClear。

OnChange会在上述操作之后调用，建议不使用OnChange。
注意：

hashset的引用不能修改，可以使用hashset添加和移除元素
由于hashset的初始数据同步发生在 OnStartClient 之前，而事件是在同步之后才订阅的，所以已有的元素不会自动触发回调。

SyncSortedSet

类似C#的SortedSet，用于将内容从服务器同步到客户端。

既有SyncHashSet的功能，又有自动排序 功能。可自定义排序规则。
要求：必须声明为readonly,并在定义时实例化。

服务器上进行增删改查；客户端上监听变化。

OnStartClient注册监听，OnStopClient中取消监听。

监听方法有：OnAdd,OnRemove,OnClear。

OnChange会在上述操作之后调用，建议不使用OnChange。
注意：

OnChange会在上述操作之后调用，建议不使用OnChange。

srotedset的引用不能修改，可以使用sortedset添加和移除元素
由于sorted的初始数据同步发生在 OnStartClient 之前，而事件是在同步之后才订阅的，所以已有的元素不会自动触发回调。