Remote Event

Create Remote Event
Remote Events are created in the Unity Editor Inspector by selecting the Add Remote Event button.
You can have up to 250 remote events in one Remote Event Agent.
Maximum message size of a remote event is 4KB.
Name
Function
Event Name
Unique name of the Event. The Event name is used to find and trigger event across different network. Event name must be unique in the same Remote Event Agent Component.
Target
Controls the recipients of the remote event.
All: All the players in the room.
Exclude self: All the players in the room except the sender.
Host only: Room host only.
Invoke Remote Event
Remote Events are invoked by calling SWNetwork API in C# scripts.
Invoke a Remote event
1
public void Invoke(string eventName)
Copied!
Invoke a Remote event with the specified message
1
public void Invoke(string eventName, SWNetworkMessage msg)
Copied!
Examples
The eventName string parameter pass to the Invoke method has to match with Event Name value in the Remote Event Agent Inspector.
This example uses SWNetworkMessage to send the bullet launch position(vector3) and aim direction (vector3) along with the remote event.
1
using SWNetwork;
2
using SWNetwork.RPC;
3
​
4
public class PlayerSkill : MonoBehaviour {
5
​
6
    public Gun gun;
7
    public Transform launchPosition;
8
    
9
    RemoteEventAgent remoteEventAgent;
10
​
11
    void Start () {
12
        remoteEventAgent = gameObject.GetComponent<RemoteEventAgent>();
13
    }
14
​
15
    void Update () {
16
​
17
        if (Input.GetMouseButtonDown(0))
18
        {
19
            fireBullet();
20
        }
21
    }
22
​
23
    void fireBullet()
24
    {
25
        SWNetworkMessage msg = new SWNetworkMessage();
26
        msg.Push(launchPosition.position);
27
        msg.Push(transform.forward);
28
        remoteEventAgent.Invoke("fire", msg);
29
    }
30
}
31
​
Copied!
Handle Remote Event
Handling remote event is done by adding listener to the remote event.
Adding Listener using the Inspector
Adding Listener using C# code
1
void Start () {
2
    remoteEventAgent = gameObject.GetComponent<RemoteEventAgent>();
3
    remoteEventAgent.AddListener("fire", RemoteFire);
4
}
5
​
6
void OnDestroy()
7
{
8
    remoteEventAgent.RemoveListener("fire", RemoteFire);
9
}
Copied!
Implement the handler function
In this example, we used the PopVector3() method on the SWNetworkMessage objet to obtain the launch position and the aim direction of the fire remote event.
1
public void RemoteFire(SWNetworkMessage msg)
2
{
3
    Vector3 position = msg.PopVector3();
4
    Vector3 direction = msg.PopVector3();
5
    gun.fireBullet(position, direction);
6
}
Copied!

Realtime Agent

Sync Property

Last modified 2yr ago

Copy link

Contents