Click or drag to resize
Client Class

Represents a client application instance using RemoteViz.

Inheritance Hierarchy
SystemObject
  OIV.InventorSoNetBase
    OIV.RemoteViz.RenderingClient

Namespace: OIV.RemoteViz.Rendering
Assembly: OIV.RemoteViz (in OIV.RemoteViz.dll) Version: 10.12.3.0 (10.12.3.0)
Syntax
public sealed class Client : SoNetBase

The Client type exposes the following members.

Methods
  NameDescription
Public methodDisconnect

Disconnects the client.

Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodGetConnection(String)

Gets a OIV.RemoteViz.Rendering.Connection of the client.

Public methodGetConnection(UInt32)

Gets a OIV.RemoteViz.Rendering.Connection of the client.

Public methodGetHashCode
Overrides GetHashCode().
(Inherited from SoNetBase.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodIsImageStreamingSupported

Returns if the client supports image streaming.

Public methodIsVideoStreamingSupported

Returns if the client supports video streaming.

Public methodSendMessage(IListByte)
Calls SendMessage(buffer, {}).
Public methodSendMessage(String)
Calls SendMessage(message, {}).
Public methodSendMessage(IListByte, IListConnection)

Sends a binary message to all the connections of the client.

Public methodSendMessage(String, IListConnection)

Sends a text message to all the connections of the client.

Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Properties
  NameDescription
Public propertyApplicationName

HTML5 client: Returns the domain name of the web host to which the client is connected.

Public propertyEnvironment

HTML5 client: Returns the value of the user-agent header sent by the client web browser.

Public propertyId

Gets the id of the client.

Public propertyIsConnected

Gets the state of the OIV.RemoteViz.Rendering.Client: connected or disconnected.

Public propertyNumConnections

Gets the number of client connections.

Public propertySettings

Gets the client settings.

Top
Remarks

In the case of HTML5 applications, a client represents a web page. See RemoteVizRenderArea.

In the case of the OIV.RemoteViz.Clients.Nodes.SoRemoteVizClient node, a client represents a single instance of the application using the node.

When a client first connects to the RemoteViz service (e.g by calling the RemoteVizRenderArea method connectTo()), a OIV.RemoteViz.Rendering.Client object is automatically created and the OIV.RemoteViz.Rendering.ServiceListener method onConnectedClient() is called with the client id. The client object can be queried using OIV.RemoteViz.Rendering.Service.GetClient(System.String). A OIV.RemoteViz.Rendering.Connection object is also created. A OIV.RemoteViz.Rendering.RenderArea object is created if the requested render area does not already exist. In any case the OIV.RemoteViz.Rendering.Connection can be queried using the OIV.RemoteViz.Rendering.Client.GetConnection(System.String) method and the associated OIV.RemoteViz.Rendering.RenderArea can be queried using the () method.

A service has zero clients initially and may allow one client or multiple clients (see OIV.RemoteViz.Rendering.ServiceListener methods onPendingCreateRenderArea and onPendingShareRenderArea). While the service is running, you can get the current client(s) using the OIV.RemoteViz.Rendering.Service methods getNumClients() and getClient().

A client has at least one connection but may have multiple connections if the service allows that. See the methods () and OIV.RemoteViz.Rendering.Client.GetConnection(System.String).

When a client is disconnected, the OIV.RemoteViz.Rendering.ServiceListener method onDisconnectedClient() is called. Following this call, the client object will no longer be referenced by RemoteViz and will be disposed unless the application holds a reference.

See Also