1.dll
将需要版本的Google.Protobuf.dll 放入插件文件夹即可
工具及dll都可在官方发布中心下载:Download Protocol Buffers | Google Developers
方便起见这里放一份镜像
2.编译cs
将写好的文件放入 "ProtoFiles" 文件夹后,双击 ”gen.bat“ ,若无语法错误即可在CSFile中生成专属的.cs文件。这份文件无需改动,放入Unity工程Asset目录下代码文件夹即可。
成功示意图
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的值,以此类推