Saltar a contenido

Guía de Instalación y Despliegue de Windows para SDK Multiplataforma de VisioForge

Video Capture SDK .Net Video Edit SDK .Net Media Player SDK .Net Media Blocks SDK .Net

Introducción a la Instalación y Despliegue del SDK de VisioForge

La suite de SDKs de VisioForge proporciona potentes capacidades multimedia para tus aplicaciones .NET, soportando captura, edición, reproducción y procesamiento avanzado de medios en múltiples plataformas. Esta guía completa cubre tanto la instalación como el despliegue para aplicaciones Windows.

Instalación

Los SDKs están accesibles en dos formas: un archivo de instalación y paquetes NuGet. El archivo de instalación proporciona un proceso de instalación directo, asegurando que todos los componentes necesarios estén correctamente configurados. Por otro lado, los paquetes NuGet ofrecen un enfoque flexible y modular para incorporar SDKs en tus proyectos, permitiendo actualizaciones fáciles y gestión de dependencias. Recomendamos altamente utilizar paquetes NuGet debido a su conveniencia y eficiencia en la gestión de dependencias y actualizaciones de proyectos.

Al construir tu aplicación, tienes la opción de crear versiones tanto x86 como x64. Esto permite que tu aplicación se ejecute en una gama más amplia de sistemas, acomodando diferentes arquitecturas de hardware. Sin embargo, es importante notar que el archivo de instalación está disponible exclusivamente para la arquitectura x64. Esto significa que mientras puedes desarrollar y compilar builds x86, el proceso de instalación inicial requerirá un sistema x64.

IDEs

Para desarrollo, puedes usar potentes entornos de desarrollo integrado (IDEs) como JetBrains Rider o Visual Studio. Ambos IDEs ofrecen herramientas y características robustas para agilizar el proceso de desarrollo en Windows. Para asegurar una configuración fluida, por favor consulta las respectivas guías de instalación. La página de instalación de Rider proporciona instrucciones detalladas para configurar JetBrains Rider, mientras que la página de instalación de Visual Studio ofrece guía completa sobre instalación y configuración de Visual Studio. Estos recursos te ayudarán a comenzar rápida y efectivamente, aprovechando las capacidades completas de estos entornos de desarrollo.

Distribución y Gestión de Paquetes

Los componentes del SDK de VisioForge para Windows se distribuyen como paquetes NuGet, haciendo la integración directa con entornos de desarrollo .NET modernos. Puedes agregar estos paquetes a tu proyecto usando cualquiera de las siguientes herramientas:

  • Visual Studio Package Manager
  • JetBrains Rider NuGet Manager
  • Visual Studio Code con extensiones NuGet
  • Integración directa de línea de comandos usando .NET CLI

Paquetes Base Requeridos

Cada aplicación Windows construida con el SDK de VisioForge requiere el paquete base apropiado según la arquitectura objetivo de tu aplicación. Estos paquetes contienen los componentes esenciales para la funcionalidad del SDK.

Paquetes Principales de Plataforma

Nota: Para aplicaciones dirigidas a múltiples arquitecturas, debes incluir ambos paquetes e implementar lógica de selección de runtime apropiada.

Paquetes de Componentes Opcionales

Dependiendo de los requisitos de tu aplicación, puedes necesitar incluir paquetes adicionales para funcionalidad especializada. Estos componentes opcionales extienden las capacidades del SDK en varios dominios.

Procesamiento de Medios FFMPEG (Recomendado)

Estos paquetes proporcionan soporte completo de codecs para una amplia gama de formatos de medios a través de la integración de la biblioteca FFMPEG:

Para aplicaciones con restricciones de tamaño, versiones comprimidas de estos paquetes utilizando compresión UPX están disponibles:

Integración Cloud - Amazon Web Services

Para aplicaciones que requieren integración de almacenamiento cloud con AWS S3:

Al usar estos paquetes, el siguiente Media Block está disponible:

  • AWSS3SinkBlock - Para almacenar medios en buckets S3

Computer Vision con OpenCV

Para aplicaciones que requieren capacidades avanzadas de procesamiento de imagen y visión por computadora:

La integración con OpenCV proporciona acceso a Media Blocks en el namespace VisioForge.Core.MediaBlocks.OpenCV, incluyendo:

  • Transformación de imagen: CVDewarpBlock, CVDilateBlock, CVErodeBlock
  • Detección de bordes y características: CVEdgeDetectBlock, CVLaplaceBlock, CVSobelBlock
  • Procesamiento facial: CVFaceBlurBlock, CVFaceDetectBlock
  • Detección de movimiento: CVMotionCellsBlock
  • Reconocimiento de objetos: CVTemplateMatchBlock, CVHandDetectBlock
  • Mejora de imagen: CVEqualizeHistogramBlock, CVSmoothBlock
  • Seguimiento y superposición: CVTrackerBlock, CVTextOverlayBlock

Paquetes de Soporte de Hardware Especializado

El SDK de VisioForge proporciona integración con sistemas de cámaras profesionales y hardware especializado. Incluye el paquete apropiado cuando trabajes con tipos de dispositivos específicos.

Cámaras Allied Vision

Para integración con hardware de cámaras profesionales Allied Vision:

Cámaras Basler

Para aplicaciones que trabajan con cámaras industriales Basler:

Cámaras Teledyne/FLIR (SDK Spinnaker)

Para imagen térmica y cámaras FLIR especializadas:

Soporte de Protocolo GenICam (GigE/USB3 Vision)

Para cámaras que utilizan el protocolo estandarizado GenICam:

Mejores Prácticas de Despliegue

Al desplegar aplicaciones basadas en VisioForge para Windows, considera estas recomendaciones:

  1. Elige los paquetes de arquitectura apropiados (x86 o x64) basándote en tu plataforma objetivo
  2. Incluye los paquetes FFMPEG para soporte completo de formatos de medios
  3. Solo incluye paquetes de hardware especializado cuando sea necesario para minimizar el tamaño de despliegue
  4. Para aplicaciones sensibles a la seguridad, considera usar las versiones comprimidas UPX para ofuscar bibliotecas nativas
  5. Siempre prueba tu despliegue en un sistema limpio para asegurar que todas las dependencias se resuelvan correctamente

La caché compartida de plugins nativos

Al iniciarse, el SDK no carga sus bibliotecas de GStreamer directamente desde la carpeta de salida de su aplicación. Copia la subcarpeta x64, x86 o arm64 de esa carpeta a una ubicación compartida y carga desde allí:

%PUBLIC%\.gstreamer\<version-del-sdk>-<conjunto-nativo>\<arquitectura>

GStreamer mantiene un registro de plugins que anota cada plugin por su ruta absoluta. Por eso una única carpeta canónica permite que todas las aplicaciones de VisioForge de la máquina compartan un mismo registro ya calentado: solo el primer inicio tras actualizar el SDK paga el coste de escanear el conjunto de plugins, y cualquier inicio posterior de cualquier aplicación lo reutiliza. Además, esa carpeta siempre tiene permiso de escritura, cosa que el directorio de una aplicación instalada bajo Program Files no tiene.

La carpeta está delimitada por la versión del SDK y por una huella de los redistribuibles core y Libav que la aplicación realmente distribuye - los paquetes VisioForge.CrossPlatform.* se versionan de forma independiente del SDK gestionado - de modo que las aplicaciones con redistribuibles distintos ya no se sobrescriben las bibliotecas en cada arranque. Dos despliegues que solo difieran en un paquete que ninguna de las dos huellas cubre (OpenCV, AWS, el de un fabricante de cámaras) sí comparten carpeta; los nombres de archivo de esos paquetes son disjuntos del resto, así que el efecto es que unos pocos archivos se vuelven a copiar, no que se cargue una biblioteca equivocada. Una caché creada por el SDK que no se ha iniciado durante 30 días se elimina; una carpeta dejada por un SDK anterior con el diseño compartido previo se deja intacta, porque las aplicaciones construidas con esa versión siguen cargando de ella.

Dos consecuencias que conviene conocer al probar un despliegue:

  • La caché acumula las bibliotecas de todas las aplicaciones de esa versión del SDK en la máquina. Un equipo de desarrollo que haya ejecutado un conjunto de paquetes más completo puede por tanto satisfacer una dependencia que su aplicación en realidad no distribuye, y esa misma aplicación falla luego en una máquina limpia.
  • Borrar %PUBLIC%\.gstreamer es seguro en cualquier momento; el siguiente inicio la reconstruye.

Para dejar la caché compartida fuera de juego y cargar exactamente lo que su aplicación distribuye, apunte VisioForgeX.CacheFolder a su propia carpeta nativa antes de llamar a InitSDK:

VisioForgeX.CacheFolder = Path.Combine(AppContext.BaseDirectory, "x64");
VisioForgeX.InitSDK();

Esta es la configuración adecuada para verificar que un redistribuible está completo, y para una aplicación que no debe escribir fuera de su propio directorio. El coste es que la aplicación ya no comparte el registro de toda la máquina y escanea el conjunto de plugins por su cuenta en cada primer inicio.

Las aplicaciones MAUI, WinUI 3 y Unity siempre cargan en su sitio y nunca usan la caché compartida.

Solución de Problemas Comunes

Problemas de Despliegue

Si encuentras problemas después del despliegue:

  1. Verifica que todos los paquetes NuGet requeridos estén correctamente incluidos
  2. Verifica que la arquitectura (x86/x64) coincida con tu objetivo de aplicación
  3. Asegura que las bibliotecas nativas se extraigan a las ubicaciones correctas
  4. Revisa las configuraciones de seguridad y permisos de Windows que podrían restringir la funcionalidad de medios

Problema de Compilación con Archivos RESX de WinForms

A veces puedes obtener el siguiente error:

Error MSB3821: Couldn't process file Form1.resx due to its being in the Internet or Restricted zone or having the mark of the web on the file. Remove the mark of the web if you want to process these files.

El Error MSB3821 ocurre cuando Visual Studio o MSBuild no puede procesar un archivo de recurso .resx porque está marcado como no confiable. Esto sucede cuando el archivo tiene la "Marca de la Web" (MOTW), una característica de seguridad que marca archivos descargados de internet o recibidos de fuentes no confiables. La MOTW coloca el archivo en la zona de seguridad de Internet o Restringida, impidiendo que sea procesado durante una compilación.

Cómo Solucionarlo

Para resolver este error, necesitas eliminar la MOTW del archivo afectado:

Desbloquear el Archivo Manualmente
  • Haz clic derecho en Form1.resx en el Explorador de Archivos.
  • Selecciona Propiedades.
  • En la pestaña General, busca un botón o casilla de verificación Desbloquear en la parte inferior.
  • Haz clic en Desbloquear, luego haz clic en Aceptar.
Desbloquear vía PowerShell (para múltiples archivos)
  • Abre PowerShell.
  • Navega al directorio de tu proyecto.
  • Ejecuta el comando: Get-ChildItem -Path . -Recurse | Unblock-File
Desbloquear el ZIP Antes de Extraer
  • Si descargaste el proyecto como archivo ZIP, haz clic derecho en el archivo ZIP.
  • Selecciona Propiedades.
  • Haz clic en Desbloquear, luego extrae los archivos.

Al desbloquear el archivo, eliminas la MOTW, permitiendo que Visual Studio lo procese normalmente durante la compilación.

Para asistencia adicional, visita el sitio de soporte de VisioForge o consulta la documentación de API.

Visita nuestra página de GitHub para obtener más ejemplos de código.