Compatibilidad y formatos de datos

Este es el contrato de compatibilidad de MediaTether 1.0.0.

Entorno admitido

MediaTether admite Unreal Engine 5.8 Editor en Windows de 64 bits. El paquete exacto se compiló e instaló con UE 5.8.2 (CL 56702186). Es una herramienta exclusiva del Editor; no admite uso runtime ni en juegos empaquetados. Las secuencias de imágenes dependen del plugin integrado ImgMedia de Epic, que Epic marca beta en UE 5.8. Las herramientas de IA opcionales usan Toolset Registry/Python de Unreal solo si el usuario activa esos plugins del motor; no se incluyen ni son necesarios para el panel.

Integración pública

La clase Blueprint/C++ exportada UMediaTetherAIEditorLibrary ofrece StartInventory, GetStatus, CancelOperation, ExportManifest(bAllowPartial) y GetReportPage(Section, Offset, Limit). Sus resultados reflejados son FMediaTetherAIStatus, FMediaTetherAIReportPage y FMediaTetherAIReportItem. Las operaciones opcionales de Toolset Registry son start_inventory, get_status, get_report_page, cancel_operation y export_manifest.

En la línea 1.0.x se mantienen estables los nombres existentes, el significado de sus parámetros y las salvaguardas. Las versiones compatibles pueden añadir campos de resultado u operaciones, pero no cambiarán ni retirarán en silencio campos u operaciones existentes. Ignora los campos que no uses. No se promete compatibilidad binaria entre versiones o builds de Unreal: recompila para la instalación UE 5.8 Editor de destino.

Datos persistidos

• El JSON de informe exportado usa la versión de esquema 1 e identifica pluginName: "MediaTether". Contiene versiones del plugin/motor, estado del inventario y cobertura, raíz de entrega, filas de fuentes/archivos y hallazgos. Puede incluir rutas locales; revísalo antes de compartirlo.
• Los perfiles usan el esquema 1 con maxRecords, deliveryRoot, assets y sequences (cada regla de secuencia contiene assetPath, pattern, start y end).
• Saved/MediaTether/Preferences.json local usa el esquema 1 y guarda deliveryRoot; es una preferencia de la máquina, no un contrato portable del proyecto.

Los lectores aceptan el esquema 1 y rechazan versiones futuras desconocidas en vez de adivinarlas o reescribirlas en silencio. Los perfiles nuevos se guardan con un nombre nuevo; un guardado fallido conserva el archivo existente. No hay migración automática de esquemas. Cualquier formato incompatible futuro debe usar una nueva versión de esquema e incluir instrucciones explícitas de actualización. La línea 1.0.x mantiene la lectura de archivos de esquema 1.

Alcance de la garantía

La versión 1.0.0 es la base inicial de compatibilidad. Los cambios incompatibles de API o esquema requieren una nueva versión mayor y una ruta explícita de migración; los añadidos compatibles siguen siendo opcionales. Un inventario completado es una instantánea del sistema de archivos, no una garantía en vivo/atómica, una prueba de reproducción o códecs ni una certificación de la entrega.