getRecordings

View as Markdown

getRecordings

Obtains a list of recordings for the current room session. To download the actual mp4 file, please use the REST API.

Returns

Promise<{ recordings: RoomSessionRecording}> - See RoomSessionRecording documentation for more details.

Permissions

  • room.recording

You need to specify the permissions when creating the Video Room Token on the server side.

Example

1const recs = await roomSession.getRecordings();
2if (recs.recordings.length > 0) {
3 console.log(recs.recordings[0].id, recs.recordings[0].duration);
4}

From your server, you can obtain the mp4 file using the REST API:

$curl --request GET \
> --url https://<yourspace>.signalwire.com/api/video/room_recordings/<recording_id> \
> --header 'Accept: application/json' \
> --header 'Authorization: Basic <your API token>'