Audio-Only Recording

The Desktop SDK's audio-only recording mode is useful if you want to record and diarize a meeting, but do not want or need to capture the video stream.

It also has the added benefit of:

  1. creating smaller artifacts: a smaller MP3 will be processed and produced, instead of a larger MP4
  2. using fewer of your customer's physical resources on their machine.
🚧

The audio-only recording mode requires MacOS 14.2+ when using the DSDK on Apple Silicon

Enabling audio-only recording using the DSDK

  1. Set audio_mixed_mp3: {} and video_mixed_mp4: null via the recording config.

    1. Example Recording Config
    recording_config: {
      	video_mixed_mp4: null,
        audio_mixed_mp3: {},
        // ...remaining config
    }
  2. Request additional permissions (on macOS only):

    1. Request the system-audio permisison through the DSDK. Additionally, keep the accessibility and microphone permissions, which are always required.
      1. You no longer need screen-capture if requesting audio-only recording
    2. Windows machines do not require permissions, so this is not necessary for Windows users.

    ❗️

    All production apps that want to request the system-audio permission from the DSDK will need to have the NSAudioCaptureUsageDescription key and associated description in their packaged app's Info.plist.

    Not including it in your packaged app prevents the audio-only-permission-request system dialog from showing in production.