Photon——An App From Scratch 一个应用程序从头开始

 

An App From Scratch 一个应用程序从头开始

     This tutorial will try to help you understand how to build an application from scratch.(aka “Blank Server Tutorial”)

     本教程将试图帮助您理解如何从头构建应用程序（又名空白服务器教程）

 

     Build a Simple Chat Server From the Scratch In 10 Minutes 

     10分钟从头开始构建一个简单的聊天服务器

     Hint: This tutorial is thought as a first step in understanding the basics of the main concepts in Photon Application and Peer. For most developers that at some point will use rooms we recommend to start with with an application that inherits from Lite.Application.

     提示:本教程是作为理解Photon应用和Peer中的主要概念的第一步。对于大多数开发人员来说，当使用房间时，我们建议应用程序继承自Lite应用程序。

• Download and unzip the SDK
• Create a new class library project ‘ChatServer’
• Add references to ExitGamesLibs.dll, Photon.SocketServer.dll and PhotonHostRuntimeInterfaces.dll
• Create a new class ‘ChatServer’ and inherit from ‘Photon.SocketServer.ApplicationBase’:

• 下载并解压缩SDK
• 创建一个新的类库项目”ChatServer”
• 添加引用ExitGamesLibs.dll, Photon.SocketServer.dll and PhotonHostRuntimeInterfaces.dll
• 创建一个新类的ChatServer和继承 Photon.SocketServer.ApplicationBase

using Photon.SocketServer;

 

public class ChatServer : ApplicationBase

{

     protected override PeerBase CreatePeer(InitRequest initRequest)

     {

     }

 

     protected override void Setup()

     {

     }

 

     protected override void TearDown()

     {

     }

}

• Create a new class ‘ChatPeer’ and inherit from ‘Photon.SocketServer.PeerBase’:
• 创建一个新的类ChatPeer并继承自Photon.SocketServer.PeerBase

using Photon.SocketServer;

using PhotonHostRuntimeInterfaces;

 

public class ChatPeer : PeerBase

{

     public ChatPeer(IRpcProtocol protocol, IPhotonPeer unmanagedPeer)

         : base (protocol, unmanagedPeer)

     {

     }

 

     protected override void OnDisconnect()

     {

     }

 

     protected override void OnOperationRequest(OperationRequest operationRequest, SendParameters sendParameters)

     {

     }

}

• Return a new instance of ChatPeer at ChatServer.CreatePeer:
• 在ChatServer.CreatePeer返回一个新的ChatPeer实例

protected override PeerBase CreatePeer(InitRequest initRequest)

{

     return new ChatPeer(initRequest.Protocol, initRequest.PhotonPeer);

}

• The server configuration looks like this:
• 服务器配置文件如下：

< Applications Default = "ChatServer" >

     < Application

         Name = "ChatServer"

         BaseDirectory = "ChatServer"

         Assembly = "ChatServer"

         Type = "ChatServer" />

</ Applications >

 

     This config requires that the server binaries are located under ‘deploy/ChatServer/bin’ and that class ChatServer does not belong to a namespace.

     这种配置要求服务器二进制文件位于下 deploy/ChatServer/bin，这类ChatServer不属于一个名称空间。

• Create a new console project for a chat client
• Add reference to PhotoDotNet.dll to the new project
• Client code:

• 创建一个新的控制台项目作为聊天客户端
• 添加引用PhotoDotNet.dll
• 客户端代码：     

 

using System;

using System.Collections.Generic;

using System.Text;

 

using ExitGames.Client.Photon;

 

public class ChatClient : IPhotonPeerListener

{

     private bool connected;

 

     public static void Main()

     {

         var client = new ChatClient();

         var peer = new PhotonPeer(client, true );

             

         // connect

         client.connected = false ;

         peer.Connect( "127.0.0.1:4530" , "ChatServer" );

         while (!client.connected)

         {

             peer.Service();

         }

 

         var buffer = new StringBuilder();

         while ( true )

         {

             peer.Service();

 

             // read input

             if (Console.KeyAvailable)

             {

                 ConsoleKeyInfo key = Console.ReadKey();

                 if (key.Key != ConsoleKey.Enter)

                 {

                     // store input

                     buffer.Append(key.KeyChar);

                 }

                 else

                 {

                     // send to server

                     var parameters = new Dictionary< byte , object > { { 1, buffer.ToString() } };

                     peer.OpCustom(1, parameters, true );

                     buffer.Length = 0;

                 }

             }

         }

     }

 

     public void DebugReturn(DebugLevel level, string message)

     {

         Console.WriteLine(level + ": " + message);

     }

 

     public void OnEvent(EventData eventData)

     {

         Console.WriteLine( "Event: " + eventData.Code);

         if (eventData.Code == 1)

         {  

             Console.WriteLine( "Chat: " + eventData.Parameters[1]);

         }

     }

 

     public void OnOperationResponse(OperationResponse operationResponse)

     {

         Console.WriteLine( "Response: " + operationResponse.OperationCode);

     }

 

     public void OnStatusChanged(StatusCode statusCode)

     {

         if (statusCode == StatusCode.Connect)

         {

             this .connected = true ;

         }

         else

         {

             Console.WriteLine( "Status: " + statusCode);

         }

     }

}

• If we now start the server the client will be able to connect and to send text messages, but the server logic to process these text messages is still missing. To verify that the message was received we answer with an OperationResponse at ChatPeer.OnOperationRequest:
• 如果我们开始这服务器，客户端将可能去连接并发送文本信息，但是服务器处理这些消息仍然会有丢失。为了验证这些信息是被接收到了，我们会在ChatPeer.OnOperationRequest响应一个OperationResponse：

protected override void OnOperationRequest(OperationRequest operationRequest, SendParameters sendParameters)

{

     var response = new OperationResponse(operationRequest.OperationCode);

     this .SendOperationResponse(response, sendParameters);

}

 

     The chat client should now print the event code and the chat message.

     这聊天客户端会打印事件代码和聊天信息

• Next thing we want to do is to receive the chat messages on other clients. We implement a publish/subscribe pattern:
• 接下来我们要做的就是在其他客户端接收聊天信息。我们实现了一个发布/订阅模式:

using System;

using Photon.SocketServer;

using PhotonHostRuntimeInterfaces;

 

public class ChatPeer : PeerBase

{

     private static readonly object syncRoot = new object ();

 

     public ChatPeer(IRpcProtocol protocol, IPhotonPeer unmanagedPeer)

         : base (protocol, unmanagedPeer)

     {

         lock (syncRoot)

         {

             BroadcastMessage += this .OnBroadcastMessage;

         }

     }

 

     private static event Action<ChatPeer, EventData, SendParameters> BroadcastMessage;

 

     protected override void OnDisconnect()

     {

         lock (syncRoot)

         {

             BroadcastMessage -= this .OnBroadcastMessage;

         }

     }

 

     protected override void OnOperationRequest(OperationRequest operationRequest, SendParameters sendParameters)

     {

         var @ event = new EventData(1) { Parameters = operationRequest.Parameters };

         lock (syncRoot)

         {

             BroadcastMessage( this , @ event , sendParameters);

         }

 

         var response = new OperationResponse(operationRequest.OperationCode);

         this .SendOperationResponse(response, sendParameters);

     }

 

     private void OnBroadcastMessage(ChatPeer peer, EventData @ event , SendParameters sendParameters)

     {

         if (peer != this )

         {

             this .SendEvent(@ event , sendParameters);

         }

     }

}

 

     If you now start two clients they should be able to exchange messages.

     如果你现在开始运行2个客户端，他们可以交换信息。