Recording video

The CameraController provides full functionality for recording videos, saving them to a specified file path (String).

File Path

To record a video, you must provide a destination file path as a String:

val path = "/path/to/save/video.mp4"

Start recording

Start video recording with startRecording. The callback provides the recording result:

cameraController.startRecording(path) { result ->
    when(result) {
        is CaptureResult.Success -> {
            uiState.update { it.copy(filePath = result.data) }
        }
        is CaptureResult.Error -> // ...
    }
}

• result.data contains the saved video file path on success.
• CaptureResult.Error indicates a failure during recording.

Stop Recording

Stop recording using:

cameraController.stopRecording()

• Calling stopRecording finalizes the video and triggers the startRecording callback.
• To temporarily halt recording without finalizing the file, use cameraController.pauseRecording.

Pause Recording

Pause an ongoing recording:

cameraController.pauseRecording()

Resume Recording

Resume a paused recording:

cameraController.resumeRecording()

• resumeRecording continues the same recording session without creating a new file.

Mute Recording

Mute or unmute the audio during recording:

cameraController.muteRecording(isMuted = true)

• isMuted state is available via cameraController.isMuted.

iOS limitation

Mute recording is not supported on iOS. Calling muteRecording on iOS always returns Result.failure. Audio input is enabled automatically when switching to CaptureMode.Video and cannot be toggled during recording.

Android-Specific API

On Android, CameraController.startRecording supports additional options to provide more control over file handling:

• ContentValues - for saving to MediaStore.
• File - for saving to a specific location.
• OutputFileOptions - for advanced camera APIs.

These options allow you to implement custom expect/actual methods for platform-specific handling, ensuring flexibility across different use cases.