Skip to main content

Interface: RecordVideoOptions

Properties

fileType

Optional fileType: "mov" | "mp4"

Specifies the output file type to record videos into.

Defined in

VideoFile.ts:12


flash

Optional flash: "off" | "on"

Set the video flash mode. Natively, this just enables the torch while recording.

Defined in

VideoFile.ts:8


onRecordingError

onRecordingError: (error: CameraCaptureError) => void

Type declaration

▸ (error): void

Called when there was an unexpected runtime error while recording the video.

Parameters
NameType
errorCameraCaptureError
Returns

void

Defined in

VideoFile.ts:16


onRecordingFinished

onRecordingFinished: (video: VideoFile) => void

Type declaration

▸ (video): void

Called when the recording has been successfully saved to file.

Parameters
NameType
videoVideoFile
Returns

void

Defined in

VideoFile.ts:20


videoBitRate

Optional videoBitRate: number | "extra-low" | "low" | "normal" | "high" | "extra-high"

The bit-rate for encoding the video into a file, in Mbps (Megabits per second).

Bit-rate is dependant on various factors such as resolution, FPS, pixel format (whether it's 10 bit HDR or not), and video codec.

By default, it will be calculated by the hardware encoder, which takes all those factors into account.

  • extra-low: 40% lower than whatever the hardware encoder recommends.
  • low: 20% lower than whatever the hardware encoder recommends.
  • normal: The recommended value by the hardware encoder.
  • high: 20% higher than whatever the hardware encoder recommends.
  • extra-high: 40% higher than whatever the hardware encoder recommends.
  • number: Any custom number for the bit-rate, in Mbps.

Default

'normal'

Defined in

VideoFile.ts:43


videoCodec

Optional videoCodec: "h264" | "h265"

The Video Codec to record in.

  • h264: Widely supported, but might be less efficient, especially with larger sizes or framerates.
  • h265: The HEVC (High-Efficient-Video-Codec) for higher efficient video recordings. Results in up to 50% smaller file-sizes.

Defined in

VideoFile.ts:26