Unity中使用Protobuf

1.dll

将需要版本的Google.Protobuf.dll 放入插件文件夹即可

工具及dll都可在官方发布中心下载:Download Protocol Buffers  |  Google Developers

方便起见这里放一份镜像

Protobuf 3 | C# | 附加生成bat


2.编译cs

将写好的文件放入 "ProtoFiles" 文件夹后,双击 ”gen.bat“ ,若无语法错误即可在CSFile中生成专属的.cs文件。这份文件无需改动,放入Unity工程Asset目录下代码文件夹即可。

Unity中使用Protobuf_第1张图片成功示意图

3.使用

使用也很方便,首先加入对proto的引用:

using Proto;

3.1反序列化

这里需要一点前置的Proto知识,不过资料很多就不赘述了。在处理完分包拆后之后(如果不了解如何实现可以参考这篇 6、用户自定义适配器 · 语雀 (yuque.com))

//首先将接收到的byte[]数组转化成整形,注意是否需要大小端序转换
int t = BitConverter.ToInt32(data, 0);

//解析指令类型
MessageType type = (MessageType)t;

//根据定义的MessageType分别处理
//...省略switch开头,举一个例子:

//MessageZero无需处理
case MessageType.Messagezero:
     break;
case MessageType.SystemSetUp://此处SystemSetup是proto文件中定义的MessageType
     responseSystemSetUp systemSetUp = responseSystemSetUp.Parser.ParseFrom(data, 4, data.Length - 4); 
     //调用生成的proto解析,responseSystemSetup是Proto中定义的Message,ParseFrom根据自定义的数        
     //据结构而修改。笔者此处的数据格式是 4字节(int32)长度 + 4字节(int32)MessageType + proto报文
     //反序列化systemSetup之后即可直接 . 出在Proto文件对应的Message中的字段了 
     break;

3.2序列化

这部分与寻常json序列化相似

//首先实例化需要序列化的类型,再给它一一赋值
requestCreateTask message = new requestCreateTask();
    message.LengthH = double.Parse(Input_LengthH.text);
    message.LengthV = double.Parse(Input_LengthV.text);
//之后通过数组Copy等操作,按照需要的格式组装成byte[],再交给socket发送即可

3.3官方类型声明

Protocol Buffer Basics: C#  |  Protocol Buffers  |  Google Developers

4.debug

需要注意的是用于protobuf会压缩无用的空间,所以使用网络调试助手看起来没那么直观,但也有方法,就是在生成的.cs文件中找到对应的类型是如何赋值解析的就会有头绪。

//下面是网络助手收到的16进制比特流
//00 00 00 0D 这4位是长度
//00 00 00 01 这4位是定义的MessageType
//08 01 10 14 19 33 33 33 33 33 33 C3 3F //这些是proto内容

//这里截取了一段生成的.cs文件可以看到对requestSystemSetUp这个Proto中定义的类型

[global::System.Diagnostics.DebuggerNonUserCodeAttribute]
    public void WriteTo(pb::CodedOutputStream output) {
      if (LashType != 0) {
        output.WriteRawTag(8);
        output.WriteInt32(LashType);
      }
      if (RobotSpeed != 0) {
        output.WriteRawTag(16);
        output.WriteInt32(RobotSpeed);
      }
      if (CarSpeed != 0D) {
        output.WriteRawTag(25);
        output.WriteDouble(CarSpeed);
      }
      if (_unknownFields != null) {
        _unknownFields.WriteTo(output);
      }
    }  
//可以看出LashType对应的Tag是9, RobotSpeed对应的Tag是16, CarSpeed对应的Tag是25
//08 01 中01即是LashType的值
//10 14 中14即是RobotSpeed的值,以此类推

你可能感兴趣的:(unity,c#)