51 lines
1.7 KiB
TypeScript
51 lines
1.7 KiB
TypeScript
import type { CameraCaptureError } from './CameraError'
|
|
import type { TemporaryFile } from './TemporaryFile'
|
|
|
|
export interface RecordVideoOptions {
|
|
/**
|
|
* Set the video flash mode. Natively, this just enables the torch while recording.
|
|
*/
|
|
flash?: 'on' | 'off'
|
|
/**
|
|
* Specifies the output file type to record videos into.
|
|
*/
|
|
fileType?: 'mov' | 'mp4'
|
|
/**
|
|
* Called when there was an unexpected runtime error while recording the video.
|
|
*/
|
|
onRecordingError: (error: CameraCaptureError) => void
|
|
/**
|
|
* Called when the recording has been successfully saved to file.
|
|
*/
|
|
onRecordingFinished: (video: VideoFile) => void
|
|
/**
|
|
* 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.
|
|
*/
|
|
videoCodec?: 'h264' | 'h265'
|
|
/**
|
|
* 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 codec.
|
|
*
|
|
* By default, it will be calculated using those factors.
|
|
* For example, at 1080p, 30 FPS, H.264 codec, without HDR it will result to 10 Mbps.
|
|
*
|
|
* @default 'normal'
|
|
*/
|
|
videoBitRate?: 'low' | 'normal' | 'high' | number
|
|
}
|
|
|
|
/**
|
|
* Represents a Video taken by the Camera written to the local filesystem.
|
|
*
|
|
* Related: {@linkcode Camera.startRecording | Camera.startRecording()}, {@linkcode Camera.stopRecording | Camera.stopRecording()}
|
|
*/
|
|
export interface VideoFile extends TemporaryFile {
|
|
/**
|
|
* Represents the duration of the video, in seconds.
|
|
*/
|
|
duration: number
|
|
}
|