建立伺服器客戶端併傳送訊息
Unity 網路提供高階 API(HLA)
來處理從低階實現中抽象的網路通訊。
在此示例中,我們將瞭解如何建立可與一個或多個客戶端通訊的伺服器。
HLA 允許我們輕鬆地序列化類並通過網路傳送此類的物件。
我們用來序列化的類
這個類必須來自 MessageBase,在這個例子中我們只會在這個類中傳送一個字串。
using System;
using UnityEngine.Networking;
public class MyNetworkMessage : MessageBase
{
public string message;
}
建立伺服器
我們建立一個伺服器來監聽埠 9999,允許最多 10 個連線,並從我們的自定義類的網路中讀取物件。
HLA 將不同型別的訊息與 id 相關聯。Unity Networking 的 MsgType 類中定義了預設訊息型別。例如,連線型別具有 id 32,並且當客戶端連線到伺服器時在伺服器中呼叫它,或者當它連線到伺服器時在客戶端中呼叫。你可以註冊處理程式來管理不同型別的訊息。
當你傳送自定義類(如我們的情況)時,我們定義一個處理程式,其新 ID 與我們通過網路傳送的類相關聯。
using UnityEngine;
using System.Collections;
using UnityEngine.Networking;
public class Server : MonoBehaviour {
int port = 9999;
int maxConnections = 10;
// The id we use to identify our messages and register the handler
short messageID = 1000;
// Use this for initialization
void Start () {
// Usually the server doesn't need to draw anything on the screen
Application.runInBackground = true;
CreateServer();
}
void CreateServer() {
// Register handlers for the types of messages we can receive
RegisterHandlers ();
var config = new ConnectionConfig ();
// There are different types of channels you can use, check the official documentation
config.AddChannel (QosType.ReliableFragmented);
config.AddChannel (QosType.UnreliableFragmented);
var ht = new HostTopology (config, maxConnections);
if (!NetworkServer.Configure (ht)) {
Debug.Log ("No server created, error on the configuration definition");
return;
} else {
// Start listening on the defined port
if(NetworkServer.Listen (port))
Debug.Log ("Server created, listening on port: " + port);
else
Debug.Log ("No server created, could not listen to the port: " + port);
}
}
void OnApplicationQuit() {
NetworkServer.Shutdown ();
}
private void RegisterHandlers () {
// Unity have different Messages types defined in MsgType
NetworkServer.RegisterHandler (MsgType.Connect, OnClientConnected);
NetworkServer.RegisterHandler (MsgType.Disconnect, OnClientDisconnected);
// Our message use his own message type.
NetworkServer.RegisterHandler (messageID, OnMessageReceived);
}
private void RegisterHandler(short t, NetworkMessageDelegate handler) {
NetworkServer.RegisterHandler (t, handler);
}
void OnClientConnected(NetworkMessage netMessage)
{
// Do stuff when a client connects to this server
// Send a thank you message to the client that just connected
MyNetworkMessage messageContainer = new MyNetworkMessage();
messageContainer.message = "Thanks for joining!";
// This sends a message to a specific client, using the connectionId
NetworkServer.SendToClient(netMessage.conn.connectionId,messageID,messageContainer);
// Send a message to all the clients connected
messageContainer = new MyNetworkMessage();
messageContainer.message = "A new player has conencted to the server";
// Broadcast a message a to everyone connected
NetworkServer.SendToAll(messageID,messageContainer);
}
void OnClientDisconnected(NetworkMessage netMessage)
{
// Do stuff when a client dissconnects
}
void OnMessageReceived(NetworkMessage netMessage)
{
// You can send any object that inherence from MessageBase
// The client and server can be on different projects, as long as the MyNetworkMessage or the class you are using have the same implementation on both projects
// The first thing we do is deserialize the message to our custom type
var objectMessage = netMessage.ReadMessage<MyNetworkMessage>();
Debug.Log("Message received: " + objectMessage.message);
}
}
客戶端
現在我們建立一個客戶端
using System;
using UnityEngine;
using UnityEngine.Networking;
public class Client : MonoBehaviour
{
int port = 9999;
string ip = "localhost";
// The id we use to identify our messages and register the handler
short messageID = 1000;
// The network client
NetworkClient client;
public Client ()
{
CreateClient();
}
void CreateClient()
{
var config = new ConnectionConfig ();
// Config the Channels we will use
config.AddChannel (QosType.ReliableFragmented);
config.AddChannel (QosType.UnreliableFragmented);
// Create the client ant attach the configuration
client = new NetworkClient ();
client.Configure (config,1);
// Register the handlers for the different network messages
RegisterHandlers();
// Connect to the server
client.Connect (ip, port);
}
// Register the handlers for the different message types
void RegisterHandlers () {
// Unity have different Messages types defined in MsgType
client.RegisterHandler (messageID, OnMessageReceived);
client.RegisterHandler(MsgType.Connect, OnConnected);
client.RegisterHandler(MsgType.Disconnect, OnDisconnected);
}
void OnConnected(NetworkMessage message) {
// Do stuff when connected to the server
MyNetworkMessage messageContainer = new MyNetworkMessage();
messageContainer.message = "Hello server!";
// Say hi to the server when connected
client.Send(messageID,messageContainer);
}
void OnDisconnected(NetworkMessage message) {
// Do stuff when disconnected to the server
}
// Message received from the server
void OnMessageReceived(NetworkMessage netMessage)
{
// You can send any object that inherence from MessageBase
// The client and server can be on different projects, as long as the MyNetworkMessage or the class you are using have the same implementation on both projects
// The first thing we do is deserialize the message to our custom type
var objectMessage = netMessage.ReadMessage<MyNetworkMessage>();
Debug.Log("Message received: " + objectMessage.message);
}
}