Esquema de metadatos OVM

Referencia para la estructura de metadatos validada con Zod en los archivos de video interactivo .ovm.

Visión general del esquema

Los metadatos OVM extienden las definiciones básicas de slots para admitir seguimiento temporal de movimiento (keyframes) y metadatos específicos de video.

Campos de nivel superior

Campo	Tipo	Requerido	Descripción
ovm_version	string		Identificador de formato (p. ej. "3.0")
version	string		Versión del esquema
ovm_id	string		ID único para el seguimiento del documento
creator_user_id	string		Identificador del creador
metadata	object		Propiedades del video: { fps: number, resolution: [w, h] }
slots	Slot[]		Definiciones de superposición interactiva
zones	Zone[]		Zonas contenedoras

Datos de seguimiento temporal (tracking_data)

Para superposiciones de video, cada slot contiene un array de keyframes que rastrean el movimiento físico: [time, x1, y1, x2, y2, x3, y3, x4, y4, cx, cy]

• time: Desplazamiento de tiempo en segundos.
• x1, y1 ... x4, y4: Esquinas del cuadro delimitador cuadrilátero (normalizadas 0-100).
• cx, cy: Coordenada del centro.

Ejemplo JSON

{
  "ovm_version": "3.0",
  "version": "3.0",
  "ovm_id": "vid_lmn456tuv",
  "metadata": {
    "fps": 30,
    "resolution": [1920, 1080]
  },
  "slots": [
    {
      "id": "interactive_overlay_1",
      "content": {
        "en": "View Details",
        "es": "Ver Detalles"
      },
      "style": {
        "color": "#ffffff",
        "fontSize": "1.2rem"
      },
      "tracking_data": [
        [0.0, 10.0, 20.0, 15.0, 20.0, 15.0, 25.0, 10.0, 25.0, 12.5, 22.5],
        [5.0, 12.0, 22.0, 17.0, 22.0, 17.0, 27.0, 12.0, 27.0, 14.5, 24.5]
      ]
    }
  ]
}