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。
注意:

  1. 列表的引用不能修改,可以调用Add,Remove改变列表内容。
  2. 由于 SyncList 的初始数据同步发生在 OnStartClient 之前,而事件是在同步之后才订阅的,所以已有的元素不会自动触发回调。
  3. 列表元素如果是引用类型,修改元素内容不会触发回调,将修改后的对象重新赋值会触发OnSet。
csharp 复制代码
Item temp = inventory[0];
temp.amount = 5;
inventory[0] = temp;

SyncDictionary

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

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

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

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

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

  1. 字典的引用不能修改,可以使用字典添加和移除元素;
  2. 由于字典的初始数据同步发生在 OnStartClient 之前,而事件是在同步之后才订阅的,所以已有的元素不会自动触发回调。
  3. 直接修改已存在值对象的内部字段不会被视为字典的变化。必须将修改后的对象重新赋值给同一个键。
csharp 复制代码
EquipmentItem item = equipment["head"];
item.durability -= 10;
equipment["head"] = item;

SyncHashSet

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

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

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

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

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

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

SyncSortedSet

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

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

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

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

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

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

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

  1. srotedset的引用不能修改,可以使用sortedset添加和移除元素
  2. 由于sorted的初始数据同步发生在 OnStartClient 之前,而事件是在同步之后才订阅的,所以已有的元素不会自动触发回调。
相关推荐
Resean02238 小时前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
小毛球.8 小时前
第 3 篇:IDEA 最新版下载与完整安装教程(Mac)
java·macos·intellij-idea·idea
kyle~9 小时前
嵌入式 SoC 系统
linux·c++·嵌入式·计算系统
Misnearch9 小时前
ScheduledExecutorService
java·线程池
ashiho10 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
其实防守也摸鱼11 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
T_Wizard11 小时前
AI 回复为什么要转圈 3 秒才「啪」一下全出来?把流式输出拆开看,顺便踩了 6 个坑
java·ai编程
人生!?11 小时前
Linux 从入门到进阶 | 基础语法
linux·笔记·教程
CoderYanger11 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第二弹)
java·数据库·面试·职场和发展·java-ee·tomcat·mybatis
优化Henry12 小时前
LTE 站点 S1 链路反复闪断导致小区频闪退服故障排查
运维·网络·学习·信息与通信·tdd