Unity multiplayer online framework mirror learning record (I)

NetworkServer Registered events in RegisterHandler

It is mainly the event used by the registration server

   // message handlers 
        /// <summary>Register a handler for message type T. Most should require authentication.</summary>
        // TODO obsolete this some day to always use the channelId version.
        // all handlers in this version are wrapped with 1 extra action.
        public static void RegisterHandler<T>(Action<NetworkConnectionToClient, T> handler, bool requireAuthentication = true)
            where T : struct, NetworkMessage
        {
    
            ushort msgType = MessagePacking.GetId<T>();
            if (handlers.ContainsKey(msgType))
            {
    
                Debug.LogWarning($"NetworkServer.RegisterHandler replacing handler for {
      typeof(T).FullName}, id={
      msgType}. If replacement is intentional, use ReplaceHandler instead to avoid this warning.");
            }
            handlers[msgType] = MessagePacking.WrapHandler(handler, requireAuthentication);
        }

How to use it is as follows ：
First design the transmitted data

  public struct TestServerMessage: NetworkMessage
    {
    
        public string message;
    }

stay Server side Registration events , Pay attention to the server , The event format is as follows

NetworkServer.RegisterHandler<TestServerMessage>(OnTestServerMessage);

public void OnTestServerMessage(NetworkConnectionToClient conn, TestServerMessage msg)
{
    
 Debug.Log(msg.message);
}

Then send the event , Client side usage Send Send events , Send it to the server for execution , Instead of sending it to other clients

 NetworkClient.Send(new TestServerMessage {
     message=" I'm coming "});

NetworkClient.Send() function

It mainly sends data to the server , Call the registered server function

    // send 
        /// <summary>Send a NetworkMessage to the server over the given channel.</summary>
        public static void Send<T>(T message, int channelId = Channels.Reliable)
            where T : struct, NetworkMessage
        {
    
            if (connection != null)
            {
    
                if (connectState == ConnectState.Connected)
                {
    
                    connection.Send(message, channelId);
                }
                else Debug.LogError("NetworkClient Send when not connected to a server");
            }
            else Debug.LogError("NetworkClient Send with no connection");
        }

NetworkConnectionToClient Medium Send function

It mainly sends messages to the client of the connection , For example, I saved all clients on the server NetworkConnectionToClient, You can use the Send Function executes the corresponding event

 // Send stage one: NetworkMessage<T>
        /// <summary>Send a NetworkMessage to this connection over the given channel.</summary>
        [MethodImpl(MethodImplOptions.AggressiveInlining)]
        public void Send<T>(T message, int channelId = Channels.Reliable)
            where T : struct, NetworkMessage
        {
    
            using (NetworkWriterPooled writer = NetworkWriterPool.Get())
            {
    
                // pack message and send allocation free
                MessagePacking.Pack(message, writer);
                NetworkDiagnostics.OnSend(message, channelId, writer.Position, 1);
                Send(writer.ToArraySegment(), channelId);
            }
        }

For example, running on the server OnServerConnect Function , It is detected that once a client joins , Will execute the function ,conn For clients that add functions NetworkConnectionToClient .

public override void OnServerConnect(NetworkConnectionToClient conn){
    }

Create a transmission data used by the client

    public struct TestClientMessage : NetworkMessage
    {
    
        public string message;
    }

Register this event , Every client should register , If the client does not register this event , But still send data in the past , The following error will appear , because NetworkClient This event is not registered , So there will be this problem

Generally registered in OnStartClient Function

public override void OnStartClient(){
    
	NetworkClient.RegisterHandler<TestClientMessage>(OnTestClientMessage);
}
public void OnTestClientMessage(TestClientMessage msg)
{
    
	Debug.Log(msg.message);
}

After registration , Make a send call

public override void OnServerConnect(NetworkConnectionToClient conn){
    
 conn.Send(new TestClientMessage {
     message=conn.connectionId+" Send a message "});
}