Unity Script Reference – NetworkView.RPC

NetworkView.RPC

function RPC (name : string, mode : RPCMode, params args : object[]) : void

Description

Call a RPC function on all connected peers.

The called function must have the @RPC tag set ([RPC] for C Sharp code). A NetworkView must be attached to the GameObject where the RPC function is being called. It doesn't matter if the NetworkView is being used for something else or just for the RPC function. If it is just for the RPC function, state synchronization should be turned off and the observed property can be set to none. RPC function names should be unique accross the scene, if two RPC functions in different scripts have the same name only one of them is called when RPC is invoked. RPC calls are always guaranteed to be executed in the same order as they are sent. The communication group set for the network view, with NetworkView.group, is used for the RPC call. To get information on the RPC itelf, you can add a NetworkMessageInfo parameter to the function declaration which will automatically contain the information. You don't need to change the way you call the RPC function when you do this. For more information see the RPC section of the manual. Valid RPC parameters are int, float, string, NetworkPlayer, NetworkViewID, Vector3 and Quaternion.

JavaScripts

var cubePrefab : Transform;
function OnGUI () {
if (GUILayout.Button("SpawnBox")) {
var viewID : NetworkViewID= Network.AllocateViewID();
networkView.RPC("SpawnBox",
RPCMode.AllBuffered,
viewID,
transform.position);
}
}

@RPC
function SpawnBox (viewID : NetworkViewID, location : Vector3) {
// Instantate the prefab locally
var clone : Transform;
clone = Instantiate(cubePrefab, location, Quaternion.identity) as Transform;
var nView : NetworkView;
nView = clone.GetComponent(NetworkView);
nView.viewID = viewID;
}

using UnityEngine;
using System.Collections;

public class example : MonoBehaviour {
public Transform cubePrefab;
void OnGUI() {
if (GUILayout.Button("SpawnBox")) {
NetworkViewID viewID = Network.AllocateViewID();
networkView.RPC("SpawnBox", RPCMode.AllBuffered, viewID, transform.position);
}
}
[RPC]
void SpawnBox(NetworkViewID viewID, Vector3 location) {
Transform clone;
clone = Instantiate(cubePrefab, location, Quaternion.identity) as Transform;
NetworkView nView;
nView = clone.GetComponent<NetworkView>();
nView.viewID = viewID;
}
}

import UnityEngine
import System.Collections

class example(MonoBehaviour):

public cubePrefab as Transform

def OnGUI():
if GUILayout.Button('SpawnBox'):
viewID as NetworkViewID = Network.AllocateViewID()
networkView.RPC('SpawnBox', RPCMode.AllBuffered, viewID, transform.position)

[RPC]
def SpawnBox(viewID as NetworkViewID, location as Vector3):
clone as Transform
clone = (Instantiate(cubePrefab, location, Quaternion.identity) as Transform)
nView as NetworkView
nView = clone.GetComponent[of NetworkView]()
nView.viewID = viewID

function RPC (name : string, target : NetworkPlayer, params args : object[]) : void

Description

Call a RPC function on a specific player