Local Recording

Local Recording is handled completely locally in the host's browser and browser cache.
Our Local Recording feature has not been built specifically for Embedded solutions, and as such is limited in functionality. We recommend that this isn't used in a live production environment without significant internal testing. Recordings are only created and stored locally. Whereby cannot recover any lost or corrupted recordings.

Enabling Local Recording

With the Recording feature you'll need to ensure that several different conditions are met so your room hosts are able to see and use the feature.
  1. 1.
    You're generating and the host is using a hostUrl
    • Only a room host will be able to Record in the room so you need to provide this type of link to the host.
    • When generating this be sure to note that a hostUrl is only valid between the meeting creation and endDate that you set during your request. These times are in UTC and not your local time zone, unless a timezone was specified in the request.
  2. 2.
    You've enabled Local Recording from the “Configure” → “Recording” section of your dashboard and are using ?recording=on in your room URLs. Or, you've set the recording type to local during the meeting creation API request.
  3. 3.
    Your hosts are selecting only the tab your meeting is embedded on. If users select the entire screen or app window it can cause files to be corrupted and unable to be downloaded.

Information for hosts recording meetings

Best Practices
  • Local Recording is only available in Chrome or Chromium browsers on a desktop or laptop. It is not available on mobile devices.
  • In order for the recording to be successful, you must select a tab only. Selecting the entire screen or an app window can cause the recordings to be corrupted and unable to download.
  • When recording a meeting while using the YouTube integration, any audio from the YouTube video will not be captured in the recording. If you need to capture audio from the video you're viewing in the local recording, we recommend sharing your screen with audio.
  • Whereby recordings are stored locally in your browser until they are downloaded onto your device. We recommend clearing your browser's site data, cookies, and cache prior to making a recording, to help ensure that your browser does not run out of space.
  • Files are initially downloaded as .webm files, which can be used in many platforms like Slack, YouTube, Chrome, and more. However you can use free programs like VLC or Handbrake to convert them to a file format you prefer

Record button not appearing:

  1. 1.
    Verify you're accessing the meeting with a hostUrl
  2. 2.
    If you've generated the roomUrl via the dashboard, you must include the parameter of &recording=on

Unable to download recordings

  1. 1.
    Recordings are stored locally in your browser cache, so they will only be available on the device and browser that they were originally recorded on
  2. 2.
    If you selected a recording source other than a specific tab (app window or entire screen) it's possible the file is corrupt and unable to be downloaded
  3. 3.
    In rare cases Chrome extensions can interfere with the download process. Try temporarily disabling them and then attempt the download again
  4. 4.
    In some cases if your browser ran out of storage while creating the recording, the resulted file in unable to be completed and not able to be downloaded. Prior to your next recording, try clearing your cache, cookies, and site data
Last modified 24d ago