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:
- creating smaller artifacts: a smaller MP3 will be processed and produced, instead of a larger MP4
- 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
-
Set
audio_mixed_mp3: {}andvideo_mixed_mp4: nullvia the recording config.- Example Recording Config
recording_config: { video_mixed_mp4: null, audio_mixed_mp3: {}, // ...remaining config } -
Request additional permissions (on macOS only):
- Request the
system-audiopermisison through the DSDK. Additionally, keep theaccessibilityandmicrophonepermissions, which are always required.- You no longer need
screen-captureif requesting audio-only recording
- You no longer need
- Windows machines do not require permissions, so this is not necessary for Windows users.
All production apps that want to request the
system-audiopermission from the DSDK will need to have theNSAudioCaptureUsageDescriptionkey and associated description in their packaged app'sInfo.plist.Not including it in your packaged app prevents the
audio-only-permission-requestsystem dialog from showing in production. - Request the
Updated 4 days ago