Skip to main content

Recording Composed Meeting

Recording the Composed Meeting​

In this article we will learn about recording the composed meeting

Key Concepts​

Key Concepts

Room: Represents a place where an audio/video meeting takes place. Each room has a unique URL and can have different settings like public or private etc.

Session: A meeting that happened in the room is the session. The session would contain the duration, the number of participants, etc. Each Room would have multiple sessions. and there would be only one session active at a time for each room.

Participant Session: When the user joins a meeting, a participant session is created for the user. The participant session would contain the participant's joinTime, leftTime, browser, os etc.

Composition Composition is using multiple video / audio streams to create a single video / audio stream. click here

Composed Recordings have to enabled in a meeting room. You can enable recording by

  1. going to room settings from Dashboard.
  2. programatically through API

We will look into both the methods below:

1. Enable Composed Recordings through Dashboard.​

Two dashboards

Screenshots below show the new dashboard. If you use the classic dashboard, pick the Classic dashboard tab — your choice is remembered on every page. You can switch at any time: Old dashboard in the header takes you back to the classic dashboard, and dashboard.metered.ca/v2 opens the new one. What changed in the new dashboard →

  1. Go to Video API & SDK → Rooms and click Create room, or

  2. To change a room you already have, open its ⋮ menu in the Rooms list and click Edit (or open the room and click Edit). Changes apply from the room's next meeting session.

In the Recording & composition section, switch on Record composition. Then click Create room (or Update room if you are editing). The meeting sessions happening in this room will automatically be recorded as a single composed video.

Composition is switched on automatically when this option is selected, and stays on while Record composition is on.

Record composition on the room form Enable composite recording in a room

Managing Recordings through the Dashboard.​

You can view, download and delete the recordings from the Metered Dashboard.

Go to Video API & SDK → Cloud Recordings to see a list of your recordings in the table.

Cloud Recordings table Recordings Table

To see a recording, click Preview. A panel opens with a preview player, the recording's details (room, meeting session, participant, start and end time), a Download button, a Delete button, and the other recordings from the same meeting.

Recording preview panel Recording preview panel

2. Enabling Recording through Rest API.​

You can enable recording through rest api by setting the record_composition:true flag when creating a room.

You can also set recording in an existing room by sending a PUT request through the api and setting the record_composition flag true / false

To learn more about APIs, visit the API documentation here.

Managing Composed Streams through Methods​

1. join(options)​

Join Method accepts options receiveVideoStreamType and receiveAudioStreamType the default is only_individual . The available options are

default: only_individual Available options:

  • none no video stream will be sent to the user.
  • only_individual: individual video stream of each participant will be sent to the user
  • only_composed: this option only works when composition is turned on in the meeting room, if only_composed is selected then only the composed video stream is sent to the user.
  • all: both individual and composed stream is sent to the user.

You need to set it to either only_composed or all to be able to record composed streams.

You can learn more about the Method here