Unity3D客户端和Java服务端使用Protobuf

Posted 2022-07-30 kakashi8841

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Unity3D客户端和Java服务端使用Protobuf相关的知识，希望对你有一定的参考价值。

前几天有位网友问我关于Unity3D里面使用Protobuf的方法，一时有事拖到现在才写这篇文章，不好意思哈。

本文测试环境：

系统：WINDOWS 7（第3、6步）、OS X 10.9（第4步）

软件：VS 2012（第3、6步）、Eclipse（第5、6步）

硬件：iPad 2（第4步）、Macbook Pro Mid 2012（第4步）

文章目录：

1、关于Protobuf的C#实现

2、为什么有些Protobuf发布到ios就用不了，甚至有些在PC都用不了？

3、手动处理C#版本的Protobuf

3.1、创建一个C#工程，先手动创建每一个要通过Protobuf序列化或反序列化的数据模型类，然后导出dll

3.2、创建一个用于序列化的C#工程，然后运行生成dll

3.3、将上面两个工程生成的dll拖到unity中

4、在Unity中反序列化Protobuf

5、服务端Java也用Protobuf

6、太烦了？！客户端也要自动处理Protobuf

1、关于Protobuf的C#实现

首先，U3D里面Protobuf使用的是C#的实现，那么目前有几个可选的C#实现：

C#: http://code.google.com/p/protobuf-csharp-port
C#: http://code.google.com/p/protosharp/
C#: https://silentorbit.com/protobuf/
C#/.NET/WCF/VB: http://code.google.com/p/protobuf-net/

我这里选用的是http://code.google.com/p/protobuf-net/(你可以在https://code.google.com/p/protobuf-net/downloads/list 这里下载到他的代码和工具)，它比较好的一点是，提供了各种平台的支持，解压后在“Full”目录中可以看到各个平台的支持。（现在google被各种封杀，如果你打不开上面的地址，可以下载我上传到CSDN的，里面的csharp文件夹就是各个平台的protobuf需要的dll，点击下载protobuf-net）。

看到里面的unity了吗，它里面的protobuf-net.dll将是我们准备用到的。

2、为什么有些Protobuf发布到iOS就用不了，甚至有些在PC都用不了？

a、Protobuf使用了JIT，即在运行时动态编译，而这个特性在Unity发布到iOS时候是不支持的。因此，会导致你在PC上可以正常运行，发布到iOS就有问题。

b、Protobuf是基于.net 2.0以上框架写的，而Unity仅支持.net 2.0，或者有些使用2.0中比较多的特性，而你在Unity中发布设置了.net 2.0的子集。后者你只需要在Player setting中修改设置就可以了。

上面两项也可适用于其它第三方类库，如果你自己下载了一个在PC上或C#里面能正常使用的类库，在U3D里面就不能用了，那么请检查是否是上面两条原因导致的。

3、手动处理C#版本的Protobuf

知道了上面问题，我们只要选一个.net2.0的Protobuf，然后它又不是JIT，那就可以正常使用了。

这里用的思路是：

3.1、创建一个C#工程，先手动创建每一个要通过Protobuf序列化或反序列化的数据模型类，然后导出dll

以VS为例，首先，创建一个类库工程：“文件”>"新建">"项目">"类库"(记得选择 .net framework 2.0)

将unity的protobuf的dll添加到项目引用

然后假设你有一个类WorkerInfo是需要通过Protobuf进行序列化和反序列化的，那么创建一个WorkerInfo类，内容如下：

using System;
using System.Collections.Generic;
using System.Text;
using ProtoBuf;
namespace Com.YourCompany.Project.Proto.Module
    [ProtoContract]
    public class WorkerInfo  


        [ProtoMember(1)]
        public int workerId;


        [ProtoMember(2)]
        public int leftClosingTimeSec;


        [ProtoMember(3)]
        public int buildingId;

按下Shift+F6生成dll，在项目的bin\\Debug目录下就可以找到ProtoModelDLL.dll了

3.2、创建一个用于序列化的C#工程，然后运行生成dll
也是以VS为例，首先创建一个控制台应用程序：“文件”>"新建">"项目">"控制台应用程序"(记得选择 .net framework 2.0)

将Protobuf和3.1生成的dll添加到引用

在项目生成的Program.cs中写入：

using System;
using System.Collections.Generic;
using System.Text;
using ProtoBuf.Meta;
using ProtoBuf;
using ProtoBuf.Compiler;
using Com.YourCompany.Project.Proto.Module;


namespace ProtoModelSerializerCreator

    class Program
    
        static void Main(string[] args)
        
            var model = TypeModel.Create();

            model.Add(typeof(object), true);
            model.Add(typeof(WorkerInfo), true);

            model.AllowParseableTypes = true;
            model.AutoAddMissingTypes = true;
            model.Compile("ProtoModelSerializer", "ProtoModelSerializer.dll");

然后ctrl+F5运行，这时候你就可以在bin\\Debug中看到ProtoModelSerializer.dll。

3.3、将上面两个工程生成的dll（ProtoModelDLL.dll和ProtoModelSerializer.dll）以及protobuf-net.dll拖到unity中

怎么用？看第4步

4、在Unity中反序列化Protobuf

由于一般游戏客户端请求的数据量比较简单，也比较少，因此我们前端请求是不直接二进制请求。而前端收到后端返回才采用了Protobuf，因此。这里只讨论Protobuf的反序列化。

代码很简单，下面写个测试代码：

using UnityEngine;
using System.Collections;
using ProtoBuf.Meta;
using Com.YourCompany.Project.Proto.Module;
using System.IO;
using Com.Duoyu001.Proto.Building;
using Com.Duoyu001.Proto.Worker;

public class TestProto : MonoBehaviour


	// init
	void Start ()
	
		byte[] dataFromServ = new byte[]8, 233, 7, 16, 100, 24, 1;	//these bytes are generated by server
		
		RuntimeTypeModel serializer = ProtoModelSerializer.Create ();
		System.IO.MemoryStream memStream = new System.IO.MemoryStream ();
		WorkerInfo w = new WorkerInfo ();
		serializer.Deserialize (memStream, w, w.GetType ());	//asign value to proto model
		
		Debug.Log (w.workerId + ", " + w.buildingId + ", " + w.leftClosingTimeSec);

运行后Unity控制台输出了worker的信息。代码中的dataFromServ字节数组的内容实际应该是通信时候后端返回的。这里测试就不涉及Socket通信的知识了。

5、服务端Java也用Protobuf

看到一个客户端用Protobuf这么麻烦，那后端会怎样呢？其实后端是比较简单的，有Google官方的支持。

下载：https://code.google.com/p/protobuf/downloads/list

下完解压是这样的（2.5.0）：

进入“protobuf-2.5.0\\java”文件夹，里面是一个maven项目，你直接用maven clean install在target目录就会生成一个protobuf-java-2.5.0.jar的jar包了，没maven的在这里下载吧，我用maven生成的http://download.csdn.net/detail/kakashi8841/6723689。这个要时候导入你的Java项目。就可以了。

然后你写一个proto文件，调用“protobuf-2.5.0\\src”里面的protoc.exe进行生成，它会帮你生成一个java文件。(详细看https://developers.google.com/protocol-buffers/docs/javatutorial)，我这里有提供一个bat，用于调用protoc来生成java文件的，手动输入的话太麻烦了。在windows下把它保存到.bat然后双击运行就可以了。

@echo off
echo ** setting runtime variable

REM _protoSrc 是你的proto文件目录的位置
set _protoSrc=F:\\project_proto_src\\trunk\\xgame-controllers\\protos

REM protoExe 是用于从proto生成java的protoc.exe程序的位置
set protoExe=C:\\Users\\john\\Desktop\\protobuf-2.5.0\\src\\protoc.exe

REM java_out_file 存放生成的Java文件目录的位置
set java_out_file=F:\\project_proto_src\\trunk\\xgame-controllers\\src\\main\\java\\

for /R "%_protoSrc%" %%i in (*) do ( 
	set filename=%%~nxi 
	if "%%~xi"  == ".proto" (
		%protoExe% --proto_path=%_protoSrc% --java_out=%java_out_file% %%i
	)
)

OK啦，这样你只要把生成的Java复制到或直接生成到你的Java项目源码目录中，然后就可以使用了。比如：
以前面说的WorkerInfo为例

package com.duoyu001.xgame;

import java.util.Arrays;

import com.duoyu001.xgame.worker.proto.WorkerInfoBuilder.WorkerInfo;

public class TestProto 

	public static void main(String[] args) 
		WorkerInfo w = WorkerInfo.newBuilder().setBuildingId(1)
				.setLeftClosingTimeSec(100).setWorkerId(1001).build();
		byte[] byteArray = w.toByteArray();
		System.out.println(Arrays.toString(byteArray));

控制台就会输出：