RealtimeClient
It's no longer needed to create the client manually. You can use the product constructors, like Video.Client, to access the same functionality.
A real-time Client. To construct an instance of this class, please use createClient.
Example usage:
import { createClient } from "@signalwire/realtime-api";
// Obtain a client:
const client = await createClient({ project, token });
// Listen on events:
client.video.on("room.started", async (room) => {});
// Connect:
await client.connect();
Properties
Methods
connect
▸ connect(): Promise<RealtimeClient>
Connects this client to the SignalWire network.
As a general best practice, it is suggested to connect the event listeners before connecting the client, so that no events are lost.
Returns
Promise<RealtimeClient>
Upon connection, asynchronously returns an instance of this same object.
Example
const client = await createClient({ project, token });
client.video.on("room.started", async (roomSession) => {}); // connect events
await client.connect();
disconnect
▸ disconnect(): void
Disconnects this client from the SignalWire network.
Returns
void
off
▸ off(event
, fn?
)
Remove an event handler.
Parameters
Name | Type | Description |
---|---|---|
event | string | Name of the event. See Events for the list of available events. |
fn? | Function | An event handler which had been previously attached. |
on
▸ on(event
, fn
)
Attaches an event handler to the specified event.
Parameters
Name | Type | Description |
---|---|---|
event | string | Name of the event. See Events for the list of available events. |
fn | Function | An event handler. |
once
▸ once(event
, fn
)
Attaches an event handler to the specified event. The handler will fire only once.
Parameters
Name | Type | Description |
---|---|---|
event | string | Name of the event. See Events for the list of available events. |
fn | Function | An event handler. |
removeAllListeners
▸ removeAllListeners(event?
)
Detaches all event listeners for the specified event.
Parameters
Name | Type | Description |
---|---|---|
event? | string | Name of the event (leave this undefined to detach listeners for all events). See Events for the list of available events. |