오퍼레이션 추가하기
많은 경우에 있어서 이벤트를 전송하는 것만으로는 게임에 충분하지 않습니다. 인증, 저장 또는 게임의 특정한 오퍼레이션등을 제공하려면 이제 Lite(또는 LiteLobby)를 확장할 시간 입니다.
이 페이지에서는 새로운 오퍼레이션을 구현하고 어떻게 사용하는지에 대한 두가지 방식을 보여 줍니다. 샘플 오퍼레이션에서는 클라이언트로 부터 메시지가 오면 메시지를 체크하여 값을 리턴 합니다.
서버측, Server-Side, 간단한 변형
우선 Lite 어플리케이션의 서버측 부터 시작해 봅니다. 변경은 어렵지 않고 간단 합니다.
C#
//Server SDK, LitePeer.cs
public void OnOperationRequest(OperationRequest request, SendParameters sendParameters)
{
// handle operation here (check request.OperationCode)
switch (request.OperationCode)
{
case 1:
{
var message = (string)request.Parameters[100];
if (message == "Hello World")
{
// received hello world, send an answer!
var response = new OperationResponse
{
OperationCode = request.OperationCode,
ReturnCode = 0,
DebugMessage = "OK",
Parameters = new Dictionary<byte, object> { { 100, "Hello yourself!" } }
};
this.SendOperationResponse(response, sendParameters);
}
else
{
// received something else, send an error
var response = new OperationResponse
{
OperationCode = request.OperationCode,
ReturnCode = 1,
DebugMessage = "Don't understand, what are you saying?"
};
this.SendOperationResponse(response, sendParameters);
}
return;
}
}
}
위의 코드는 처음에 호출된 OperationCode 를 검사 합니다. 이 경우의 OperationCode 는 1입니다. Photon에서 OperationCode는 오퍼레이션의 이름/타입을 짧게 줄인 것 입니다. 아래에서 클라이언트가 어떻게 이것을 호출하는지 살펴 볼 것 입니다.
만약 Operation 1이 호출 되면 요청 파라미터를 체크 합니다. 여기에서 파라미터 100 은 문자열로 예측하고 있습니다. 다시한번 말씀드리지만 Photon 은 바이트 형태의 파라미터만 사용하므로 전송시에 깔끔하게 유지하도록 하세요.
그리고 메시지 내용을 체크하고 응답을 준비합니다. 두 개 응답 모두 returnCode 와 디버그 메시지가 있습니다. returnCode 가 0 이면 에러가 없는 리턴이며 이외의 다른 숫자(여기에서는 1)는 오류 또는 클라이언트에 의해서 처리될 필요가 있다는 것을 의미 합니다.
긍정적인 응답은 또한 리턴값을 포함합니다. key-value 쌍을 더 추가할 수 있으나 여기에서는 문자열인 100을 고수 하고 있습니다.
이미 이것은 오퍼레이션을 완전하게 구현 했습니다. 새로운 오퍼레이션을 위한 우리의 규약이며 클라이언트가 사용할 수 있도록 전송 되어야만 합니다.
클라이언트 측
위 오퍼레이션에 대한 정의를 알았으니 클라이언트 측에서 호출 할 수 있습니다. 이 클라이언트 코드는 connect 시에 호출 합니다.
C#
public void OnStatusChanged(StatusCode status)
{
// handle peer status callback
switch (status)
{
case StatusCode.Connect:
// send hello world when connected
var parameter = new Dictionary<byte, object>();
parameter.Add((byte)100, "Hello World");
peer.OpCustom(1, parameter, true);
break;
//[...]
위에서 정의 한대로 메시지는 파라미터 100 에 있을 것이라고 예측 합니다. 이것은 파라미터 딕셔너리로써 제공 됩니다. 파라미터 키는 바이트 이외의 것이 되어서는 안되며 바이트 이외이면 전송 되지 않을 것 입니다. 그리고 거기에 "Hello World" 로 넣었습니다.
PhotonPeer(그리고 LitePeer) 메소드 OpCustom 은 OperationCode가 첫 번째 파라미터일 것이라고 예상하고 있습니다. OperationCode 가 1 입니다. 파라미터들이 따라오고 오퍼레이션이 도착 했는지 확신하고 싶습니다(이것이 필 수 입니다).
이것과는 별도로 클라이언트는 일반적인 작업을 해야 합니다. 이 의미는 주기별로 PhotonPeer.Service 를 호출 해야 한다는 것 입니다.
결과를 사용할 수 있으면 다음과 같이 처리 할 수 있습니다:
C#
public void OperationResponse(OperationResponse operationResponse)
{
// handle response by code (action we called)
switch (operationResponse.OperationCode)
{
// out custom "hello world" operation's code is 1
case 1:
// OK
if (operationResponse.ReturnCode == 0)
{
// show the complete content of the response
Console.WriteLine(operationResponse.ToStringFull());
}
else
{
// show the error message
Console.WriteLine(operationResponse.DebugMessage);
}
break;
}
}
서버측, 고급 버전
오퍼레이션을 처리 할 때 선호하는 방식은 이것을 위해 클래스를 생성하는 것 입니다. 이 방식은 강한 타입형이고 파라미터가 누락되면 이슈가 되며 프레임워크에 의해서 처리가 됩니다.
이것이 오퍼레이션, 파라미터들, 파라미터의 타입과 리턴 값의 정의입니다:
C#
//new Operation Class
namespace MyPhotonServer
{
using Photon.SocketServer;
using Photon.SocketServer.Rpc;
public class MyCustomOperation : Operation
{
public MyCustomOperation(IRpcProtocol protocol, OperationRequest request)
: base(protocol, request)
{
}
[DataMember(Code = 100, IsOptional = false)]
public string Message { get; set; }
// GetOperationResponse could be implemented by this class, too
}
}
위에서 정의된 오퍼레이션 클래스에서 요청에 대하여 강하게 타입된 방식으로 응답을 매핑 할 수 있습니다.
C#
public void OnOperationRequest(OperationRequest request, SendParameters sendParameters)
{
switch (request.OperationCode)
{
case 1:
{
var operation = new MyCustomOperation(this.Protocol, request);
if (operation.IsValid == false)
{
// received garbage, send an error
var response = new OperationResponse
{
OperationCode = request.OperationCode,
ReturnCode = 1,
DebugMessage = "That's garbage!"
};
this.SendOperationResponse(response, sendParameters);
return;
}
if (operation.Message == "Hello World")
{
// received hello world, send an answer!
operation.Message = "Hello yourself!";
OperationResponse response = new OperationResponse(request.OperationCode, operation);
this.SendOperationResponse(response, sendParameters);
}
else
{
// received something else, send an error
var response = new OperationResponse
{
OperationCode = request.OperationCode,
ReturnCode = 1,
DebugMessage = "Don't understand, what are you saying?"
};
this.SendOperationResponse(response, sendParameters);
}
break;
}
}
}