import WebsocketClientPlugin from 'osc-js/src/plugin/wsclient.js'

public class | source

WebsocketClientPlugin

Extends:

Plugin → WebsocketClientPlugin

Test:

Constructor Summary

Public Constructor
public	constructor(options: object) Create an OSC WebsocketClientPlugin instance with given options.

Member Summary

Private Members
private	notify: function
private	options: object
private	socket: object
private	socketStatus: number

Method Summary

Public Methods
public	close() Close Websocket
public	open(customOptions: object) Connect to a Websocket server.
public	send(binary: Uint8Array) Send an OSC Packet, Bundle or Message to Websocket server
public	status(): number Returns the current status of the connection

Private Methods
private	registerNotify(fn: function) Internal method to hook into osc library's EventHandler notify method

Inherited Summary

From class Plugin
public	close() Close socket connection and anything else used in the implementation.
public	open(customOptions: object) Open socket connection.
public	send(binary: Uint8Array, customOptions: object) Send an OSC Packet, Bundle or Message.
public	status(): number Returns the current status of the connection

Public Constructors

public constructor(options: object) source

Create an OSC WebsocketClientPlugin instance with given options. Defaults to localhost:8080 for connecting to a Websocket server

Override:

Plugin#constructor

Params:

Name	Type	Attribute	Description
options	object	optional	Custom options
options.host	string	optional default: 'localhost'	Hostname of Websocket server
options.port	number	optional default: 8080	Port of Websocket server
options.secure	boolean	optional default: false	Use wss:// for secure connections
options.protocol	string \| string[]	optional default: ''	Subprotocol of Websocket server

Example:

const plugin = new OSC.WebsocketClientPlugin({ port: 9912 })
const osc = new OSC({ plugin: plugin })

Private Members

private notify: function source

private options: object source

private socket: object source

private socketStatus: number source

Public Methods

public close() source

Close Websocket

Override:

Plugin#close

public open(customOptions: object) source

Connect to a Websocket server. Defaults to global options

Override:

Plugin#open

Params:

Name	Type	Attribute	Description
customOptions	object	optional	Custom options
customOptions.host	string	optional	Hostname of Websocket server
customOptions.port	number	optional	Port of Websocket server
customOptions.secure	boolean	optional	Use wss:// for secure connections
options.protocol	string \| string[]	optional	Subprotocol of Websocket server

public send(binary: Uint8Array) source

Send an OSC Packet, Bundle or Message to Websocket server

Override:

Plugin#send

Params:

Name	Type	Attribute	Description
binary	Uint8Array		Binary representation of OSC Packet

public status(): number source

Returns the current status of the connection

Override:

Plugin#status

Return:

number

Status identifier

Private Methods

private registerNotify(fn: function) source

Internal method to hook into osc library's EventHandler notify method

Params:

Name	Type	Attribute	Description
fn	function		Notify callback