GameAnvil은 Google Protocol Buffers를 사용하여 프로토콜을 정의하고 빌드합니다. 아래의 예제는 이러한 프로토콜을 정의하는 법과 빌드하는 법을 설명합니다. 우선 SampleGame.proto 파일을 텍스트 에디터로 생성한 후 원하는 프로토콜을 정의합니다. 프로토콜 버퍼의 자세한 문법은 공식 Protocol Buffers 가이드를 참고할 수 있습니다.
package [패키지명];
// 참조해야할 다른 proto파일이 있다면 import
import [proto 파일 명]
enum SampleUserTypeEnum {
USER_TYPE_NONE = 0;
USER_TYPE_ONE = 1;
}
message SampleUserData {
int32 data = 1;
}
enum SampleRoomTypeEnum {
ROOM_TYPE_NONE = 0;
ROOM_TYPE_ONE = 1;
}
message SampleRoomData {
int32 data = 1;
}
message SampleUserMessage {
SampleUserTypeEnum sampleUserTypeEnum = 1;
int32 id = 2;
int64 money = 3;
string nickname = 4;
double score = 5;
repeated SampleUserData sampleUserData = 6; // list
}
message SampleRoomMessage {
SampleRoomTypeEnum sampleRoomTypeEnum = 1;
int32 id = 2;
int64 potMoney = 3;
string roomName = 4;
repeated SampleRoomData sampleRoomData = 5; // list
}
그리고 아래와 같은 명령줄로 프로토콜 스크립트를 컴파일할 수 있습니다. 이때, 쉘 스크립트나 배치 파일을 생성해두고 사용하면 편리합니다. 만일 GameAnvil 템플릿을 이용하여 프로젝트를 구성했다면 프로젝트 내의 proto 폴더에서 프로토콜 스크립트와 배치파일을 참고할 수 있습니다. 컴파일이 성공적으로 완료되면 프로토콜에 관련된 모든 Java 클래스가 자동으로 생성됩니다.
protoc ./MyGame.proto --java_out=../java
만일 유니티 클라이언트를 위한 C# 프로토콜도 필요하다면 아래와 같이 언어를 추가하여 생성할 수도 있습니다. 이 경우 C# 결과 파일은 그 생성 경로에 따라 수동으로 유니티 프로젝트에 복사해주어야 할 수도 있습니다.
protoc ./MyGame.proto --java_out=../java --csharp_out=./