How To Send TCP Custom Messages

If you implement custom commands on Diarkis server, you may invoke those commands by sending custom commands.

// ver = command version
// cmd = command ID
// payload = message
tcp.Send(ver, cmd, payload);

TCP Client Event - OnConnect

The event is raised when a connection is successfully established.

OnException is raised if the connection establishment fails.

tcp.OnCreate += OnTcpCreate;

private void OnTcpCreate(bool reconnected)
{
// A connection is successfully established. Now you may interactive wit the server cluster
}

TCP Client Event - OnException

The event is raised when an exception is caught internally or the Connect method fails.

tcp.OnException += OnTcpException;

private void OnTcpException(int errorCode, string errorMessage)
{
// Handle the exception here
}

TCP Client Event - OnHeartbeat

TCP client sends and receives a heartbeat packet at a certain interval (Default every 5 seconds) to keep the connection “alive”. The event is raised when the client receives a response back from the server cluster.

tcp.OnHeartbeat += OnTcpHeartbeat;

private void OnTcpHeartbeat()
{
// Do something if you would like to
}

TCP Client Event - OnOffline

The event is raised when the connected server is preparing to go offline. The client is recommended to terminate the current connection and re-establish a new connection when this event is raised.

tcp.OnOffline += OnTcpOffline;
tcp.OnDisconnect += OnTcpDisconnect;

private void OnTcpOffline()
{
// We set a flag, so we can perform re-connection in OnDisconnect event listener
reconnectFlag = true;
// This is raise OnDisconnect event
tcp.Disconnect();
}
// bool reconnecting is set to true when you use tcp.Reconnect()
private void OnTcpDisconnect(bool reconnecting)
{
if (reconnectFlag)
{
// Call the application server to indirectly obtain a new endpoint here
// Assuming we have the new endpoint, we proceed with reconnect
tcp.SetEncryptionKeys(newSid, newKey, newIv, newMacKey);
tcp.Connect(newAddr, newPort);
}
}

TCP Event - OnDisconnect

The event is raised when the client successfully disconnects from Diarkis server cluster.

tcp.OnDisconnect += OnTcpDisconnect;

private void OnTcpDisconnect(bool reconnecting)
{
// bool reconnecting is set to true only when tcp.Reconnect() is used.
}

TCP Event - OnPush

The event is raised when the client receives a packet as a push (packets that are not requested by the client) from Diarkis server cluster.

tcp.OnPush += OnTcpPush;

private void OnTcpPush(uint ver, uint cmd, byte[] payload)
{
// Consume payload accordingly using uint ver and cmd
switch(ver)
{
case MY_CUSTOM_CMD_VER1:
HandleCustomCmdVer1(cmd, payload);
default:
// Unknown command version... :(

break;
}
}

private void HandleCustomCmdVer1(uint cmd, byte[] payload)
{
switch(cmd)
{
case CMD1:
HandleCmd1(payload);
break;
}
}