Skip to main content

Interface: RecordVideoOptions

Properties​

fileType​

• Optional fileType: "mov" | "mp4"

Specifies the output file type to record videos into.

Defined in​

types/VideoFile.ts:12


flash​

• Optional flash: "off" | "on"

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

Defined in​

types/VideoFile.ts:8


onRecordingError​

• onRecordingError: (error: CameraCaptureError) => void

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

Type declaration​

â–¸ (error): void

Parameters​
NameType
errorCameraCaptureError
Returns​

void

Defined in​

types/VideoFile.ts:16


onRecordingFinished​

• onRecordingFinished: (video: VideoFile) => void

Called when the recording has been successfully saved to file.

Type declaration​

â–¸ (video): void

Parameters​
NameType
videoVideoFile
Returns​

void

Defined in​

types/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​

types/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​

types/VideoFile.ts:26