RoboidControl.SiteServer Class Reference

Detailed Description

A site server is a participant which provides a shared simulated environment.

Inheritance diagram for RoboidControl.SiteServer:

Public Member Functions
	SiteServer (int port=7681)
	Create a new site server.
void	Close ()
	Close the site.
override void	Update (ulong currentTimeMS=0)
	Update all things for this participant.
void	SendThingInfo (Participant owner, Thing thing)
void	PublishThingInfo (Thing thing)
bool	Send (Participant owner, IMessage msg)
bool	Publish (IMessage msg)
void	ReceiveData (byte[] data, Participant sender)
Thing	Get (byte thingId)
	Get the thing with the given properties.
void	Add (Thing thing, bool checkId=true)
	Add a new thing for this participant.
void	Remove (Thing thing)
	Remove a thing for this participant.

Static Public Member Functions
static ParticipantUDP	Isolated ()
	Isolated participant is used when the application is run without networking.
static Participant	GetParticipant (string ipAddress, int port)
	Retrieve a participant using ip address and port number.
static Participant	GetParticipant (int networkId)
	Retrieve a participant using a network ID.
static Participant	AddParticipant (string ipAddress, int port)
	Add a new participant to the collection of participants.
static void	AddParticipant (Participant participant)
	Add a new participant to the collection of participants.

Public Attributes
string	name = "ParticipantUDP"
	The name of the participant.
bool	isIsolated = false
	True if the participant is running isolated.
Participant	remoteSite = null
	The remote site when this participant is connected to a site.
ulong	publishInterval = 3000
	The interval in milliseconds for publishing (broadcasting) data on the local network.
byte[]	buffer = new byte[1024]
IPEndPoint	endPoint = null
UdpClient	udpClient = null
string	broadcastIpAddress = "255.255.255.255"
readonly ConcurrentQueue< IMessage >	messageQueue = new ConcurrentQueue<IMessage>()
string	ipAddress = "0.0.0.0"
	The Ip Address of a participant. When the participant is local, this contains 0.0.0.0.
int	port = 0
	The port number for UDP communication with the participant. This is 0 for isolated participants.
byte	networkId = 0
	he network Id to identify the participant
readonly List< Thing >	things = new()
	The things managed by this participant.

Static Public Attributes
static readonly List< Participant >	participants = new()
	The collection of known participants.

Protected Member Functions
override void	UpdateMyThings (ulong currentTimeMS)
override void	Process (Participant sender, ParticipantMsg msg)
override void	Process (Participant sender, NetworkIdMsg msg)
override void	Process (Participant sender, ThingMsg msg)
void	GetBroadcastAddress (IPAddress ip, IPAddress subnetMask)
virtual void	UpdateOtherThings (ulong currentTimeMS)
void	ReceiveUDP (IAsyncResult result)
virtual void	Process (Participant sender, InvestigateMsg msg)
virtual void	Process (Participant sender, NameMsg msg)
virtual void	Process (Participant sender, ModelUrlMsg msg)
virtual void	Process (Participant sender, PoseMsg msg)
virtual void	Process (Participant sender, BinaryMsg msg)
virtual void	Process (Participant sender, TextMsg msg)
virtual void	Process (Participant sender, DestroyMsg msg)

Protected Attributes
ulong	nextPublishMe = 0

Constructor & Destructor Documentation

SiteServer()

RoboidControl.SiteServer.SiteServer

(

int

port = 7681

)

Create a new site server.

Parameters

port	The port of which to receive the messages

Member Function Documentation

UpdateMyThings()

override void RoboidControl.SiteServer.UpdateMyThings ( ulong  currentTimeMS )

protectedvirtual

Reimplemented from RoboidControl.ParticipantUDP.

Process() [1/3]

override void RoboidControl.SiteServer.Process ( Participant  sender, ParticipantMsg  msg  )

protectedvirtual

Reimplemented from RoboidControl.ParticipantUDP.

Process() [2/3]

override void RoboidControl.SiteServer.Process ( Participant  sender, NetworkIdMsg  msg  )

protectedvirtual

Reimplemented from RoboidControl.ParticipantUDP.

Process() [3/3]

override void RoboidControl.SiteServer.Process ( Participant  sender, ThingMsg  msg  )

protectedvirtual

Reimplemented from RoboidControl.ParticipantUDP.

Isolated()

static ParticipantUDP RoboidControl.ParticipantUDP.Isolated ( )

staticinherited

Isolated participant is used when the application is run without networking.

Returns

A participant without networking support

Update()

override void RoboidControl.ParticipantUDP.Update ( ulong  currentTimeMS = 0 )

virtualinherited

Update all things for this participant.

Parameters

currentTimeMS

The current time in milliseconds (optional)

Reimplemented from RoboidControl.Participant.

Get()

Thing RoboidControl.Participant.Get ( byte  thingId )

inherited

Get the thing with the given properties.

Parameters

thingId

The ID of the thing

Returns

The thing when it is found, null in other cases.

Add()

void RoboidControl.Participant.Add ( Thing  thing, bool  checkId = true  )

inherited

Add a new thing for this participant.

Parameters

thing	The thing to add
checkId	If true, the thing.id is regenerated if it is zero

Remove()

void RoboidControl.Participant.Remove ( Thing  thing )

inherited

Remove a thing for this participant.

Parameters

thing

The thing to remove

GetParticipant() [1/2]

static Participant RoboidControl.Participant.GetParticipant ( string  ipAddress, int  port  )

staticinherited

Retrieve a participant using ip address and port number.

Parameters

ipAddress	The ip address of the participant
port	The port number used to send messages to the participant

Returns

The participant or null if it is not found.

GetParticipant() [2/2]

static Participant RoboidControl.Participant.GetParticipant ( int  networkId )

staticinherited

Retrieve a participant using a network ID.

Parameters

networkId

The network ID of the participant

Returns

The participant or null if it is not found.

AddParticipant() [1/2]

static Participant RoboidControl.Participant.AddParticipant ( string  ipAddress, int  port  )

staticinherited

Add a new participant to the collection of participants.

Parameters

ipAddress	The IP address of the participant
port	The port used to send messages to this participant

Returns

The added participant

AddParticipant() [2/2]

static void RoboidControl.Participant.AddParticipant ( Participant  participant )

staticinherited

Add a new participant to the collection of participants.

Parameters

participant

The participant to add

<note>This function only adds the participant if it is not yet in the collection</note>

Member Data Documentation

isIsolated

bool RoboidControl.ParticipantUDP.isIsolated = false

inherited

True if the participant is running isolated.

Isolated participants do not communicate with other participants