RoomSessionRecording

Represents a specific recording of a room session.

Properties

id

stringrequired

The unique ID of this recording.

roomId

stringrequired

The ID of the room associated to this recording.

roomSessionId

stringrequired

The ID of the room session associated to this recording.

state

"recording" | "paused" | "completed"required

Current state.

duration

number

Duration, if available.

startedAt

Date

Start time, if available.

endedAt

Date

End time, if available.

hasEnded

booleanrequired

Whether the recording has ended. Returns true if the state is "completed".

Methods

pause

▸ pause(): Promise<void>

Pauses the recording.

Returns

Promise<void>

Example

In this example, we start a recording and pause it after 5 seconds. This example assumes you have already created a RoomSession and members are joining.

import { SignalWire } from "@signalwire/realtime-api";

// Initialize the SignalWire client
const client = await SignalWire({ project: "ProjectID Here", token: "Token Here" });

// Access video client from the main client
const videoClient = client.video;

// Setup listener for when a room starts
await videoClient.listen({
  onRoomStarted: async (roomSession) => {
    console.log("Room started", roomSession.displayName);

    let roomRecording =  roomSession.startRecording({
      listen: {
        onStarted: () => {
          console.log("Recording started");
        },
        onEnded: (recording) => {
          console.log(`Recording ended.
          Recording State: ${recording.state}.
          Recording Id: ${recording.id}`);
        },
      }
    })
    await roomSession.listen({
      onRecordingUpdated: (recording) => {
        console.log(`Recording State: ${recording.state}. Recording Id: ${recording.id}`);
      },
      onMemberJoined: async (member) => {
        console.log("Member joined", member.name);
    },
      onMemberLeft: (member) => {
        console.log("Member left", member.name);
      },
    })

    // Pausing the recording after 5 seconds
    setTimeout(async () => {
      console.log("Stopping recording");
      await roomRecording.pause();
    }, 5000);
  },
  onRoomEnded: async (roomSession) => {
    console.log("Room ended", roomSession.displayName);
  }
});

---

resume

▸ resume(): Promise<void>

Resumes the recording.

Returns

Promise<void>

Example

In this example, we start a recording and pause it after 5 seconds. Then we resume the recording after another 5 seconds of being paused. This example assumes you have already created a RoomSession and members are joining.

import { SignalWire } from "@signalwire/realtime-api";

// Initialize the SignalWire client
const client = await SignalWire({ project: "ProjectID Here", token: "Token Here" });

// Access video client from the main client
const videoClient = client.video;

// Setup listener for when a room starts
await videoClient.listen({
  onRoomStarted: async (roomSession) => {
    console.log("Room started", roomSession.displayName);

    let roomRecording =  roomSession.startRecording({
      listen: {
        onStarted: () => {
          console.log("Recording started");
        },
        onEnded: (recording) => {
          console.log(`Recording ended.
          Recording State: ${recording.state}.
          Recording Id: ${recording.id}`);
        },
      }
    })

    await roomSession.listen({
      onRecordingUpdated: (recording) => {
        console.log(`Recording State: ${recording.state}. Recording Id: ${recording.id}`);
      },
      onMemberJoined: async (member) => {
        console.log("Member joined", member.name);

    },
      onMemberLeft: (member) => {
        console.log("Member left", member.name);
      },
    })

    // Pause the recording after 5 seconds
    setTimeout(async () => {
      console.log("Pausing recording");
      await roomRecording.pause();

      // Resume the recording after 5 seconds
      setTimeout(() => {
        console.log("Resuming recording");
        roomRecording.resume();
      }, 5000);
    }, 5000);
  },
  onRoomEnded: async (roomSession) => {
    console.log("Room ended", roomSession.displayName);
  }
});

---

stop

▸ stop(): Promise<void>

Stops the recording.

Returns

Promise<void>

Example

In this example, we start a recording and stop it after 5 seconds. This example assumes you have already created a RoomSession and members are joining.

import { SignalWire } from "@signalwire/realtime-api";

// Initialize the SignalWire client
const client = await SignalWire({ project: "ProjectID Here", token: "Token Here" });

// Access video client from the main client
const videoClient = client.video;

// Setup listener for when a room starts
await videoClient.listen({
  onRoomStarted: async (roomSession) => {
    console.log("Room started", roomSession.displayName);

    let roomRecording =  roomSession.startRecording({
      listen: {
        onStarted: () => {
          console.log("Recording started");
        },
        onEnded: (recording) => {
          console.log(`Recording ended.
          Recording State: ${recording.state}.
          Recording Id: ${recording.id}`);
        },
      }
    })

    await roomSession.listen({
      onRecordingUpdated: (recording) => {
        console.log(`Recording State: ${recording.state}. Recording Id: ${recording.id}`);
      },
      onMemberJoined: async (member) => {
        console.log("Member joined", member.name);

    },
      onMemberLeft: (member) => {
        console.log("Member left", member.name);
      },
    })

    // Stopping the recording after 5 seconds
    setTimeout(async () => {
      console.log("Stopping recording");
      await roomRecording.stop();
    }, 5000);
  },
  onRoomEnded: async (roomSession) => {
    console.log("Room ended", roomSession.displayName);
  }
});

---

Events

onStarted

▸ RoomSessionRecording({ listen: {onStarted: Callback }})

Emitted when the recording starts.

Parameters

recording

RoomSessionRecordingrequired

The recording that started. See RoomSessionRecording.

onUpdated

▸ RoomSessionRecording({ listen: {onUpdated: Callback }})

Emitted when the recording is updated.

Parameters

recording

RoomSessionRecordingrequired

The recording that updated. See RoomSessionRecording.

onEnded

▸ RoomSessionRecording({ listen: {onEnded: Callback }})

Emitted when the recording ends.

Parameters

recording

RoomSessionRecordingrequired

The recording that ended. See RoomSessionRecording.