빠르게 시작해보기

이 포스트에서 Photon Cloud의 "Particle Demo"를 학습 하실 것 입니다. 이 데모는 SDK 에 포함되어 있으며 멀티플레이어 기능을 추가할 때 나오는 전형적인 유즈 케이스를 어떻게 구현 하는지 보여 줍니다. 우리는 기본적인 Photon 의 기능을 살펴보고 이 기능을 통해 어떤 것을 할 수 있는지 학습 하게 될 것입니다.

아래의 C# 코드 샘플은 Photon Unity3D SDK(다운로드)에 대한 것이지만 (1) 연결 (2) 룸 생성 (3) 이벤트 전송 순의 기본 작업흐름은 모든 플랫폼에서 동일 합니다.

목차

마스터 서버 접속

처음에 해야 할 일은 클라이언트가 클라우드에 접속 하는 것 입니다. 이 프로세스를 마스터 서버 접속 이라고 합니다. 여기서부터 마스터 서버가 모든 클라이언트에서 게임 서버로 보내는 전송내용, 클라우드내 로드 밸런싱과 사용 가능한 룸을 관리하게 됩니다.

데모에 있는 코드를 자세히 살펴 보겠습니다.

// From GameLogic.cs                        
public GameLogic(string masterAddress, string appId, string gameVersion) : base(masterAddress, appId, gameVersion)
{
    this.LocalPlayer.Name = "usr" + SupportClass.ThreadSafeRandom.Next() % 99;

    this.AutoJoinLobby = false;
    this.UseInterestGroups = true;
    this.JoinRandomGame = true;

    this.DispatchInterval = new TimeKeeper(10);
    this.SendInterval = new TimeKeeper(100);
    this.MoveInterval = new TimeKeeper(500);
    this.UpdateOthersInterval = new TimeKeeper(this.MoveInterval.Interval);
}

GameLogic클래스는 LoadBalancingClient 클래스에서 상속되었으므로 마스터와 게임 서버간의 상태를 보관하고 자동으로 전이(transitions)를 실행 합니다. GameLogic 생성자에서 사용 된 아규먼트들에 대해서 좀 더 자세히 살펴 보겠습니다.

  1. string masterAddress: 연결한 (마스터)서버의 URL. Photon 지역 목록을 살펴 보세요.
  2. string appId: 당사의 클라우드 시스템에서 어플리케이션 식별에 사용 됩니다. AppId 가 없다면 Photon Cloud 관리화면에서 AppId를 찾을 수 있습니다. 데모 프로그램이 동작하게 하기 위해서는 유효한 AppId 를 입력 해야 합니다.
  3. strin gameVersion: 게임 빌드를 구분하기 위해 선택된 스트링입니다. 동일한 버전 번호을 가진 클라이언트 간에만 매치되고 서로 통신 할 수 있습니다. 이 특성 때문에 이전 클라이언트 접속을 끊지 않고 기능 추가를 쉽게 할 수 있습니다.

Particle Demo Screenshot (Unity3D SDK)
Particle Demo 스크린샷 (Unity3D SDK)

연결 이후 Photon Cloud는 명령 처리 준비를 합니다. 이제부터는 모든 것이 관리 되므로 세심하게 관리 할 필요가 전혀 없습니다! 아래의 다이어그램에서 회색으로 표시된 사각형은 Photon Cloud 가 관리한다는 것을 볼 수 있습니다. 클라이언트는 화살표 옆에 있는 간단한 명령들만 전송하면 됩니다.

Photon Cloud Simple Workflow
Photon Cloud 의 간단한 작업 흐름

이제 마스터 서버에 접속 했으므로 룸의 목록을 보고 생성하고 참가 할 수 있습니다. 이 시점에서 플레이어들은 서로 통신하거나 소통할 수 없습니다. 여기서부터 룸 개념이 작동하게 됩니다. 다음은 플레이어간 연결하는 방법에 대하여 설명해드리고자 합니다.

목차로 돌아 가기

로비, 룸 생성과 룸 참여

기본적으로 LoadBalancing API는 클라이언트가 연결 되었을 때 게임의 "로비"로 이동 시켜 줍니다. 로비에 있는 동안 Master 서버는 클라이언트에게 룸의 목록을 제공해 줍니다. 트래픽을 낮게 유지 하기 위해서 로비에서는 클라이언트간에 통신을 할 수 없습니다.

룸은 플레이어간 통신하는 곳(게임 플레이 장소)과 분리된 지역으로 간주 될 수 있습니다. 플레이어들이 동일한 룸에 있으면 서로 이벤트를 송수신 할 수 있고, 룸 속성을 변경/갱신 등을 할 수 있습니다.

다음에 나오는 예제에서는 "OpCreateRoom" 을 사용하여 룸을 생성하고 오픈합니다. 룸 하나를 생성하고 생성된 룸에 들어 갑니다.

    RoomOptions options = new RoomOptions();
    options.options.maxPlayers = 4;
    peer.OpCreateRoom("Room 42", options, TypedLobby.Default);

가장 주목해야 할 파라미터와 RoomOptions 들은 다음과 같습니다.

  • string roomName 룸의 이름으로 룸을 식별하고 들어 가는데 사용됩니다.
  • bool .RoomOptionsisVisible 이 변수는 로비 (Master 서버에 연결되었으나 아직 룸에 들어가지 않은 플레이어들이 있는 곳)에서 룸을 보이게 할 지에 대한 여부를 결정합니다. 이러한 룸들은 클라이언트가 정확한 룸의 명칭을 알 수 있다면 룸에 참여 할 수 있습니다.
  • bool RoomOptions.isOpen 클라이언트가 참가할 수 있는지의 여부를 결정합니다. 룸 안에 있는 클라이언트들은 이 값이 변경되어도 영향을 받지 않습니다. 하지만 룸을 떠난 이후 isOpen 값이 false 이면 다시 참여할 수 없습니다.
  • byte RoomOptions.maxPlayers 룸에 들어갈 수 있는 최대 플레이어수를 지정합니다. 0으로 설정을 하게 되면 무제한으로 들어갈 수 있습니다. 하나의 룸에 많은 수의 플레이어를 참여하게 하고 싶다면 당사의 Photon Server MMO Application 을 보셔야 할 것입니다!
  • Hashtable RoomOptions.customRoomProperties 은 선택적 키/값의 집합으로 룸에 대한 설명을 정의 할 수 있습니다. 예: key = "level" , value = "de_dust" 등. 속성은 동일 룸에 있는 모든 클라이언트들에게 동기화 되며 매치메이킹의 역할을 합니다. 아래에서 속성에 대해 자세히 살펴보세요.
  • string[] RoomOptions.customRoomPropertiesForLobby 는 로비에서 볼 수 있는 속성들입니다..

Photon 에서는 실행시에 룸과 플레이어의 프로퍼티들을 변경할 수 있으므로 customGameProperties 를 사용하여 설정하는 것에 제약이 없습니다. 룸안에서는 room.SetCustomProperties(props) 를 사용하여 새로운 값을 설정하거나 기존의 값을 덮어 쓰게 됩니다. 변경사항은 머지될 것이므로 변경하고 싶은 키를 전달만 해주면 됩니다.

룸은 여러개의 프로퍼티들을 가질 수 있으나 매치메이킹에서는 일반적으로 몇 개만 사용하기 때문에 Photon은 로비에서 사용할 수 있는 룸 프로퍼티 키 목록을 정의하는 것을 예측 합니다. 심지어 RoomOptions.customRoomProperties 에 아직 정의 되어 있지 않은 키들도 나중에 string[] customRoomPropertiesForLobby 와 값을 채워 사용할 수 도 있습니다.

LoadBalancing Room Properties Example
LoadBalancing 룸 프로퍼티 예제

룸 프로퍼티와 마찬가지로 플레이어별로 커스텀 프로퍼티들을 설정 할 수 있습니다. 각 클라이언트는 룸에 참여 하기 전에도 LoadBalancingClient.localPlayer.SetCustomProperties() 를 이용하여 플레이어 프로퍼티들을 설정 할 수 있습니다. 프로퍼티들은 해당 클라이언트로 값이 유지되며 클라이언트가 참여 또는 생성한 모든 룸과 동기화 되어 집니다.

LoadBalancing Player Properties Example
LoadBalancing 플레이어 프로퍼티 예제

이제 룸을 성공적으로 생성했으므로 다른 플레이어들이 룸에 참여할 시간입니다! 룸에 참여하는 것으 빠르고 쉬워서 특별히 이 오퍼레이션에 대해서 설명할 부분이 없습니다.


// From LoadBalancingClient.cs                        
public void OnOperationResponse(OperationResponse operationResponse)
{
    ...
    this.OpJoinRoom(name);
}

이제 플레이어들이 서로 어떻게 소통하는지 살펴 보도록 하겠습니다.

목차로 되돌아 가기

이벤트 전송

우리는 상호 소통을 하려는 클라이언트들에 대해서 단순한 이벤트 시스템을 사용 합니다. 이벤트는 주어진 룸 안에 있는 플레이어 사이에서 정보를 빠르고 신뢰성 있게 송수신 할 수 있는 주요 방법 입니다. 게임 로직에 필요한 모든 데이터는 이 방식으로 클라이언트 간에 전송 될 수 있습니다. 필요에 따라 프로토콜을 파라미터로 명시(UDP vs.. TCP 또는 신뢰 UDP vs. 비신뢰 UDP)하여 정보 교환 방식을 커스터마이징 할 수 있습니다.

LoadBalancing RaiseEvent Operation Diagram
LoadBalancing RaiseEvent 작동 다이어그램

이벤트는 룸에 있는 참가자들에게 분배 됩니다. 특정 플레이어 , 그룹 또는 모든 사람들에게 이벤트를 전달할 지 결정 할 수 있습니다.

Particle 데모에서 사용한 색상 변경에 대한 이벤트를 예제로 살펴 보겠습니다.

                        
public void ChangeLocalPlayercolor()
{
    if (this.LocalPlayer != null)
    {
        this.LocalPlayer.RandomizeColor();
        this.loadBalancingPeer.OpRaiseEvent(DemoConstants.EvColor, this.LocalPlayer.WriteEvColor(), this.SendReliable, new RaiseEventOptions() { CachingOption = EventCaching.AddToRoomCache });
    }
}

OpRaiseEvent 의 아규먼트는 다음과 같습니다.

  • byte eventCode 이벤트 코드로 발생시킬 실제 이벤트를 지정합니다. Photon 에서는 255로 시작하여 아래로 감소하는 미리 정의된 이벤트들이 있습니다. 1부터 199 까지 게임로직에서 사용할 자신만의 이벤트를 정의 하여 사용할 수 있습니다.
  • Hashtable evData 이 해시테이블에 전송할 데이터를 채울 수 있습니다. 이는 중앙 데이터 구조로서 클라이언트 사이에서 정보 교환에 사용 될 것입니다. 게임 로직의 반복되고 표준화된 단계(예, 턴의 종료)는 이벤트로 전달하는 것이 좋습니다.
  • bool sendReliable 이 플래그를 "true"로 설정 하면 UDP가 신뢰 UDP로 전환됩니다. 이 의미는 전송시에 손실된 패킷들이 있으면 재전송 되고 클라이언트들이 보낸 순서대로 패킷을 해석 한다는 것을 보장한다는 것입니다. 이렇게 하면 추가적인 메시지 데이터가 전체 통신에 추가 되는것은 물론 단계가 추가 되므로 성능이 나빠지게 됩니다.
  • byte RaiseEventOptions.channelId 그룹에 다른 채널을 사용 할 수 있고 전송하고 있는 이벤트의 우선 순위를 정할 수 있습니다. 이 기능은 간단한 예제를 통하여 설명 하겠습니다: 플레이어들의 위치에 대한 정보를 전송하기 위하여 채널1을 사용하고 있습니다. 이런 유형의 게임에는서 매우 높은 신뢰가 필요하기 때문에 신뢰UDP로 설정 해 놓았습니다. 특정 시점에서 채널1에 있는 플레이어 한명의 연결 상태가 좋지 않아 수많은 양의 패킷이 손실되어 엄청난 양의 메시지로 넘쳐나고 있으면 이 메시지는 재전송 되어야 합니다. 만약 새로운 중요한 이벤트( 라운드 종료와 같은)가 들어 왔을 때 현재 클라이언트들이 채널1으로부터 수신된 모든 위치에 대한 정보를 갱신하려고 여전히 바쁘게 움직이고 있으면 라운드 종료 정보를 알리는데 시간이 걸릴 것입니다. 따라서 이 이벤트를 channelId 0 으로 처리하여 모든 큐의 메시지중에서 가장 먼저 처리하는 것입니다. 이 기능을 잘 사용하면 긴급한 것에 반응하여 게임 로직의 흐름이 올바르게 진행되는 것을 보장할 수 있을 뿐만 아니라 연결 상태가 좋지 않은 환경에서도 처리 할 수 있습니다.
  • int[] RaiseEventOptions.targetActors 룸에서 이벤트를 보내기 위한 ActorNumbers 의 리스트.
  • EventCaching RaiseEventOptions.CachingOption 서버가 어떻게 이벤트 캐싱-wise 를 다룰 것인지에 대해 영향을 미칩니다. 나중에 참가한 플레이어에 대한 이벤트 캐시 여부 또는 이전 캐시된 이벤트의 삭제.

Particle Demo (Unity3d SDK): Room View Screenshot
Particle Demo (Unity3d SDK): Room View Screenshot

마지막으로 수신자 그룹에 지정해서 사용할 수 있는 추가적인 오버로드가 있습니다.

이 포스트를 시간내어 읽어 주셔서 감사합니다! 이 아티클에 대하여 질문 또는 코멘트가 있으면 포럼을 통하여 저희에게 알려주세요. 저희는 귀하의 피드백을 매우 소중하게 여깁니다.

 기술문서 TOP으로 돌아가기