Create professional demos and 3D mockups in seconds, directly in your browser
export type CameraShape = "squircle" | "circle" | "square";
export type CameraCorner =
| "top-left"
| "top-right"
| "bottom-left"
| "bottom-right"
| "custom";
export interface CameraPosition {
x: number;
y: number;
}
export interface Camera3DConfig {
enabled: boolean;
rotationX: number;
rotationY: number;
perspective: number;
}
export interface CameraConfig {
enabled: boolean;
deviceId: string | null;
shape: CameraShape;
size: number;
position: CameraPosition;
corner: CameraCorner;
mirror: boolean;
zoom?: number;
threeD?: Camera3DConfig;
}
export interface MicrophoneConfig {
enabled: boolean;
deviceId: string | null;
volume: number;
noiseSuppression: boolean;
echoCancellation: boolean;
}
export interface RecordingSetupConfig {
camera: CameraConfig;
microphone: MicrophoneConfig;
systemAudio: boolean;
}
export interface MediaDeviceOption {
deviceId: string;
label: string;
groupId: string;
}
export interface AvailableDevices {
cameras: MediaDeviceOption[];
microphones: MediaDeviceOption[];
}
export const DEFAULT_CAMERA_CONFIG: CameraConfig = {
enabled: false,
deviceId: null,
shape: "squircle",
size: 0.30,
position: { x: 0.88, y: 0.8 },
corner: "bottom-right",
mirror: true,
zoom: 1,
threeD: {
enabled: false,
rotationX: 0,
rotationY: 0,
perspective: 900,
},
};
export function normalizeCamera3DConfig(value?: Partial<Camera3DConfig> | null): Camera3DConfig {
const finite = (input: unknown, fallback: number) =>
typeof input === "number" && Number.isFinite(input) ? input : fallback;
return {
enabled: value?.enabled === true,
rotationX: Math.max(-45, Math.min(45, finite(value?.rotationX, 0))),
rotationY: Math.max(-45, Math.min(45, finite(value?.rotationY, 0))),
perspective: Math.max(300, Math.min(1600, finite(value?.perspective, 900))),
};
}
export function normalizeCameraZoom(value?: number | null): number {
return typeof value === "number" && Number.isFinite(value)
? Math.max(1, Math.min(3, value))
: 1;
}
export const DEFAULT_MICROPHONE_CONFIG: MicrophoneConfig = {
enabled: false,
deviceId: null,
volume: 1,
noiseSuppression: true,
echoCancellation: true,
};
export const DEFAULT_RECORDING_SETUP: RecordingSetupConfig = {
camera: DEFAULT_CAMERA_CONFIG,
microphone: DEFAULT_MICROPHONE_CONFIG,
systemAudio: true,
};
export const CORNER_POSITIONS: Record<
Exclude<CameraCorner, "custom">,
CameraPosition
> = {
"top-left": { x: 0.12, y: 0.12 },
"top-right": { x: 0.88, y: 0.12 },
"bottom-left": { x: 0.12, y: 0.88 },
"bottom-right": { x: 0.88, y: 0.88 },
};
export function getCameraLayout(
config: CameraConfig,
containerWidth: number,
containerHeight: number
): { size: number; left: number; top: number } {
const shortSide = Math.min(containerWidth, containerHeight);
const size = Math.min(
config.size * shortSide,
containerWidth,
containerHeight
);
const half = size / 2;
const centerX = config.position.x * containerWidth;
const centerY = config.position.y * containerHeight;
const left = Math.max(0, Math.min(containerWidth - size, centerX - half));
const top = Math.max(0, Math.min(containerHeight - size, centerY - half));
return { size, left, top };
}
export const CAMERA_SHAPES: Array<{ id: CameraShape; label: string; icon: string }> = [
{ id: "squircle", label: "Squircle", icon: "boxicons:squircle-filled" },
{ id: "circle", label: "Círculo", icon: "material-symbols:circle" },
{ id: "square", label: "Cuadrado", icon: "material-symbols:square-rounded" },
];
export const RECORDING_SETUP_STORAGE_KEY = "openvid:recordingSetup";
export const VALID_CAMERA_SHAPES: CameraShape[] = ["squircle", "circle", "square"];
export const VALID_CAMERA_CORNERS: CameraCorner[] = ["top-left", "top-right", "bottom-left", "bottom-right", "custom"];
export const CORNER_BUTTONS: Array<{ id: Exclude<CameraCorner, "custom">; label: string; icon: string }> = [
{ id: "top-left", label: "Arriba izq.", icon: "solar:arrow-up-bold" },
{ id: "top-right", label: "Arriba der.", icon: "solar:arrow-up-bold" },
{ id: "bottom-left", label: "Abajo izq.", icon: "solar:arrow-down-bold" },
{ id: "bottom-right", label: "Abajo der.", icon: "solar:arrow-down-bold" },
];
export async function enumerateMediaDevices(): Promise<AvailableDevices> {
if (typeof navigator === "undefined" || !navigator.mediaDevices?.enumerateDevices) {
return { cameras: [], microphones: [] };
}
try {
const devices = await navigator.mediaDevices.enumerateDevices();
return {
cameras: devices
.filter((d) => d.kind === "videoinput")
.map((d) => ({
deviceId: d.deviceId,
label: d.label || "Cámara sin nombre",
groupId: d.groupId,
})),
microphones: devices
.filter((d) => d.kind === "audioinput")
.map((d) => ({
deviceId: d.deviceId,
label: d.label || "Micrófono sin nombre",
groupId: d.groupId,
})),
};
} catch (err) {
console.warn("Error al enumerar dispositivos:", err);
return { cameras: [], microphones: [] };
}
}
export async function requestCameraStream(
deviceId: string | null
): Promise<MediaStream> {
return navigator.mediaDevices.getUserMedia({
video: {
deviceId: deviceId ? { exact: deviceId } : undefined,
width: { ideal: 1280 },
height: { ideal: 720 },
frameRate: { ideal: 30 },
},
audio: false,
});
}
export async function requestMicrophoneStream(
deviceId: string | null,
options: { noiseSuppression: boolean; echoCancellation: boolean }
): Promise<MediaStream> {
return navigator.mediaDevices.getUserMedia({
video: false,
audio: {
deviceId: deviceId ? { exact: deviceId } : undefined,
noiseSuppression: options.noiseSuppression,
echoCancellation: options.echoCancellation,
},
});
}